Skip to content

Commit

Permalink
Add french translation [#1532] (#1559)
Browse files Browse the repository at this point in the history
* fix ponctuation in book/moving_around.md

* Add french translation to project

* Update i18n meta data after french translation
  • Loading branch information
LoicRiegel authored Oct 12, 2024
1 parent 8c9aaaa commit 251f13e
Show file tree
Hide file tree
Showing 18 changed files with 1,208 additions and 5 deletions.
14 changes: 14 additions & 0 deletions .vuepress/config.js
Original file line number Diff line number Diff line change
Expand Up @@ -15,12 +15,14 @@ import {
navbarDe,
navbarEn,
navbarEs,
navbarFr,
navbarJa,
navbarPtBR,
navbarRU,
navbarZhCN,
sidebarDe,
sidebarEn,
sidebarFr,
sidebarEs,
sidebarJa,
sidebarPtBR,
Expand Down Expand Up @@ -61,6 +63,11 @@ export default defineUserConfig({
title: 'Nushell',
description: 'Eine neue Art von Shell.',
},
'/fr/': {
lang: 'fr-FR',
title: 'Nushell',
description: 'Un nouveau type de shell.',
},
'/es/': {
lang: 'es-ES',
title: 'Nushell',
Expand Down Expand Up @@ -129,6 +136,13 @@ export default defineUserConfig({
navbar: navbarEs,
sidebar: sidebarEs,
},
'/fr/': {
selectText: 'Langues',
selectLanguageName: 'Français',
editLinkText: 'Modifier la page sur GitHub',
navbar: navbarFr,
sidebar: sidebarFr,
},
'/ja/': {
selectText: '言語',
selectLanguageName: '日本語',
Expand Down
10 changes: 10 additions & 0 deletions .vuepress/configs/navbar/fr.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
import type { NavbarConfig } from '@vuepress/theme-default';

export const navbarFr: NavbarConfig = [
{ text: 'Installez Nu !', link: '/fr/book/installation' },
{ text: 'Prise en main', link: '/fr/book/getting_started' },
{
text: 'Documentation',
children: [{ text: 'Le Livre Nushell', link: '/fr/book/' }],
},
];
1 change: 1 addition & 0 deletions .vuepress/configs/navbar/index.ts
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
export * from './de.js';
export * from './en.js';
export * from './es.js';
export * from './fr.js';
export * from './ja.js';
export * from './pt-BR.js';
export * from './ru.js';
Expand Down
29 changes: 29 additions & 0 deletions .vuepress/configs/sidebar/fr.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
import type { SidebarConfig } from '@vuepress/theme-default';
import { commandCategories } from './command_categories';

export const sidebarFr: SidebarConfig = {
'/fr/book/': [
{
text: 'Introduction',
link: '/fr/book/README.md',
collapsible: false,
},
{
text: 'Installation',
link: '/fr/book/installation.md',
collapsible: false,
children: ['/fr/book/default_shell.md'],
},
{
text: 'Prise en main',
link: '/fr/book/getting_started.md',
collapsible: false,
children: [
'/fr/book/quick_tour.md',
'/fr/book/moving_around.md',
'/fr/book/thinking_in_nu.md',
'/fr/book/cheat_sheet.md',
],
},
],
};
1 change: 1 addition & 0 deletions .vuepress/configs/sidebar/index.ts
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
export * from './de.js';
export * from './en.js';
export * from './es.js';
export * from './fr.js';
export * from './ja.js';
export * from './pt-BR.js';
export * from './ru.js';
Expand Down
4 changes: 2 additions & 2 deletions book/default_shell.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,8 @@
| Terminal | Platform | Instructions |
| :--------------: | ------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
| GNOME Terminal | Linux & BSDs | Open `Edit > Preferences`. In the right-hand panel, select the `Command` tab, tick `Run a custom command instead of my shell`, and set `Custom command` to the path to Nu. |
| GNOME Console | Linux & BSDs | Type the command `gsettings set org.gnome.Console shell "['/usr/bin/nu']"` (replace `/usr/bin/nu` with the path to Nu). Equivalently, use [dconf Editor](https://apps.gnome.org/DconfEditor/) to edit the `/org/gnome/Console/shell` key. |
| Kitty | Linux & BSDs | Press `Ctrl`+`Shift`+`F2` to open `kitty.conf`. Go to `shell` variable, uncomment the line and replace the `.` with the path to Nu. |
| GNOME Console | Linux & BSDs | Type the command `gsettings set org.gnome.Console shell "['/usr/bin/nu']"` (replace `/usr/bin/nu` with the path to Nu). Equivalently, use [dconf Editor](https://apps.gnome.org/DconfEditor/) to edit the `/org/gnome/Console/shell` key. |
| Kitty | Linux & BSDs | Press `Ctrl`+`Shift`+`F2` to open `kitty.conf`. Go to `shell` variable, uncomment the line and replace the `.` with the path to Nu. |
| Konsole | Linux & BSDs | Open `Settings > Edit Current Profile`. Set `Command` to the path to Nu. |
| XFCE Terminal | Linux & BSDs | Open `Edit > Preferences`. Check `Run a custom command instead of my shell`, and set `Custom command` to the path to Nu. |
| Terminal.app | macOS | Open `Terminal > Preferences`. Ensure you are on the `Profiles` tab, which should be the default tab. In the right-hand panel, select the `Shell` tab. Tick `Run command`, put the path to Nu in the textbox, and untick `Run inside shell`. |
Expand Down
2 changes: 1 addition & 1 deletion book/moving_around.md
Original file line number Diff line number Diff line change
Expand Up @@ -153,7 +153,7 @@ Nu also provides some basic [filesystem commands](/commands/categories/filesyste
::: tip NOTE
Under Bash and many other shells, most filesystem commands (other than `cd`) are actually separate binaries in the system. For instance, on a Linux system, `cp` is the `/usr/bin/cp` binary. In Nushell, these commands are built-in. This has several advantages:

- They work consistently on platforms where a binary version may not be available (e.g., Windows). This allows the creation of cross-platform scripts, modules, and custom commands.
- They work consistently on platforms where a binary version may not be available (e.g. Windows). This allows the creation of cross-platform scripts, modules, and custom commands.
- They are more tightly integrated with Nushell, allowing them to understand Nushell types and other constructs
- As mentioned in the [Quick Tour](quick_tour.html), they are documented in the Nushell help system. Running `help <command>` or `<command> --help` will display the Nushell documentation for the command.

Expand Down
61 changes: 61 additions & 0 deletions fr/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,61 @@
---
home: true
heroImage: null
heroText: Nushell
tagline: Un nouveau type de shell
actionText: Prise en main →
actionLink: /fr/book/
features:
- title: Les pipelines pour contrôler n'importe quel OS
details: Nu fonctionne sur Linux, macOS, BSD, et Windows. Apprennez-le une fois, utilisez le partout après.
- title: Tout est donnée
details: Les pipelines Nu utilisent des données structurées, ce qui vous permet de sélectionner, filtrer et trier de la même manière à chaque fois. Arrêtez de parser des chaînes de caractères et commencez à résoudre des problèmes.
- title: Des plugins puissants
details: Il est aisé d'étendre Nu en utilisant un système de plugin puissant.
---

<img src="https://www.nushell.sh/frontpage/ls-example.png" alt="Capture montrant l'utilisation de la commande ls" class="hero"/>

### Nu fonctionne avec les données existantes

Nu parle [JSON, YAML, SQLite, Excel, et plus](/book/loading_data.html), prêt à l'emploi. Il est facile d'injecter des données dans un pipeline Nu, qu'elles proviennent d'un fichier, d'une base de donnée, ou d'une API web :

<img src="https://www.nushell.sh/frontpage/fetch-example.png" alt="Capture montrant un fetch avec une API web" class="hero"/>

### Nu a d'excellents messages d'erreur

Nu opère sur des données typées, il détecte donc des bugs que les autres shells ne détectent pas. Et quand les choses plantent, Nu indique éxactement où et pourquoi :

<img src="https://www.nushell.sh/frontpage/miette-example.png" alt="Capture montrant Nu détectant une erreur de type" class="hero"/>

## Obtenir Nu

Nushell est disponible sous forme de [binaires téléchargeables](https://github.com/nushell/nushell/releases), [via votre package manager préféré](https://repology.org/project/nushell/versions), dans [une GitHub Action](https://github.com/marketplace/actions/setup-nu), ou en [code source](https://github.com/nushell/nushell). Lisez [les instructions d'installation détaillées](/fr/book/installation.html) ou lancez-vous directement :

#### macOS / Linux :

##### Homebrew

```shell
$ brew install nushell
```

##### Profil Nix

```shell
$ nix profile install nixpkgs#nushell
```

#### Windows :

```shell
$ winget install nushell
```

Après l'installation, lancez Nu en tapant `nu`.

## Communauté

Rejoingnez-nous [sur Discord](https://discord.gg/NtAbbGn) si vous avez une question à propos de Nu !

Vous pouvez contribuer à améliorer ce site en [nous donnant des retours](https://github.com/nushell/nushell.github.io/issues) ou en [créant une PR](https://github.com/nushell/nushell.github.io/pulls).
64 changes: 64 additions & 0 deletions fr/book/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,64 @@
# Introduction

Bonjour, et bienvenue dans le projet Nushell.
L'objectif de ce projet est d'appliquer la philosophie Unix des shells, où les pipelines connectent de simples commandes entre elles, et de l'adapter au style de développement moderne.
Ainsi, plutôt que d'être simplement un shell ou un langage de programmation, Nushell réunit les deux en intégrant un langage de programmation riche et un shell complet dans un seul package.

Nu s'inspire de nombreux domaines familiers : des shells traditionnels comme bash, des shells orientés objets comme PowerShell, des langages à typage graduel comme TypeScript, de la programmation fonctionnelle, de la programmation système, et plus encore. Cependant, plutôt que de chercher à tout faire, Nu concentre son énergie à bien faire certaines choses :

- Être un shell flexible et multiplateforme avec une approche moderne
- Résoudre les problèmes comme un langage de programmation moderne qui travaille avec la structure de vos données
- Fournir des messages d'erreur clairs et un support IDE propre

## Ce livre

Le livre est divisé en chapitres qui sont eux-mêmes subdivisés en sections.
Vous pouvez cliquer sur les en-têtes des chapitres pour obtenir plus d'informations à leur sujet.

- [Installation](/fr/book/installation.md), sans surprise, vous aide à installer Nushell sur votre système.
- [Prise en main](/fr/book/getting_started.md) vous guide dans vos débuts. Il explique également certains des principes de conception où Nushell diffère des shells typiques comme Bash.
- [Fondamentaux de Nu](/book/nu_fundamentals.md) explique les concepts de base du langage Nushell.
- [Programmer en Nu](/book/programming_in_nu.md) explore plus en profondeur les fonctionnalités du langage et montre plusieurs façons d'organiser et structurer votre code.
- [Nu en tant que Shell](/book/nu_as_a_shell.md) se concentre sur les fonctionnalités du shell, notamment la configuration et l'environnement.
- [Passer à Nu](/book/coming_to_nu.md) a pour but d'offrir un démarrage rapide aux utilisateurs venant d'autres shells ou langages.
- [Notes de Conception](/book/design_notes.md) fournit une explication approfondie de certains des choix de conception de Nushell.
- [Avancé (ou pas)](/book/advanced.md) aborde des sujets plus avancés (ils ne sont pas _si_ avancés que ça, n'hésitez pas à les consulter aussi !).

## Les Nombreux Morceaux de Nushell

Le projet Nushell se compose de plusieurs dépôts et sous-projets.
Vous pouvez tous les trouver sous [notre organisation sur GitHub](https://github.com/nushell).

- Le dépôt principal de Nushell se trouve [ici](https://github.com/nushell/nushell). Il est divisé en plusieurs crates qui peuvent être utilisés comme des bibliothèques indépendantes dans votre propre projet, si vous le souhaitez.
- Le dépôt de notre page [nushell.sh](https://www.nushell.sh), y compris ce livre, se trouve [ici](https://github.com/nushell/nushell.github.io).
- Nushell dispose de son propre éditeur de ligne, qui [a son propre dépôt](https://github.com/nushell/reedline)
- [`nu_scripts`](https://github.com/nushell/nu_scripts) est un endroit pour partager des scripts et des modules avec d'autres utilisateurs, en attendant que nous ayons un gestionnaire de packages.
- [Nana](https://github.com/nushell/nana) est un effort expérimental pour explorer une interface utilisateur graphique pour Nushell.
- [Awesome Nu](https://github.com/nushell/awesome-nu) contient une liste d'outils qui fonctionnent avec l'écosystème Nushell : des plugins, des scripts, des extensions pour éditeurs, des intégrations tierces, etc.
- [Nu Showcase](https://github.com/nushell/showcase) est un espace pour partager des travaux autour de Nushell, que ce soit des blogs, des œuvres d'art ou autre chose.
- [Request for Comment (RFC)](https://github.com/nushell/rfcs) sert d'endroit pour proposer et discuter des changements de conception majeurs. Bien qu'il soit actuellement sous-utilisé, nous prévoyons de l'utiliser davantage à mesure que nous nous rapprochons de la version 1.0 et au-delà.

## Contribuer

Nous accueillons volontiers les contributions !
[Comme vous pouvez le voir](#les-nombreux-morceaux-de-nushell), il y a de nombreux endroits où contribuer.
La plupart des dépôts contiennent un fichier `CONTRIBUTING.md` avec des conseils et des détails qui devraient vous aider à démarrer (sinon, réfléchissez à contribuer une correction !).

Nushell lui-même est écrit en [Rust](https://www.rust-lang.org).
Cependant, vous n'avez pas besoin d'être un programmeur en Rust pour aider.
Si vous connaissez un peu le développement web, vous pouvez contribuer à l'amélioration de ce site web ou du projet Nana.
[Les Dataframes](dataframes.md) peuvent bénéficier de votre expertise en traitement de données.

Si vous avez écrit un script sympa, un plugin, ou intégré Nushell quelque part, nous serions heureux de voir votre contribution à `nu_scripts` ou à Awesome Nu.
Découvrir des bugs avec des étapes pour les reproduire et les signaler sur GitHub est également une aide précieuse !
Vous pouvez contribuer à Nushell simplement en utilisant Nushell !

Étant donné que Nushell évolue rapidement, ce livre a constamment besoin d'être mis à jour.
Contribuer à ce livre ne nécessite pas de compétences particulières, à part une familiarité de base avec le Markdown.
En outre, vous pouvez envisager de traduire des parties dans votre langue.

## Communauté

L'endroit principal pour discuter de quoi que ce soit qui concerne Nushell est notre [Discord](https://discord.com/invite/NtAbbGn).
Vous pouvez également nous suivre sur [Twitter](https://twitter.com/nu_shell) pour des news et des mises à jour.
Enfin, vous pouvez utiliser les discussions ou ouvrir des issues sur GitHub.
Loading

0 comments on commit 251f13e

Please sign in to comment.