Skip to content

Commit 251f13e

Browse files
LoicRiegelLoicRiegel
authored
Add french translation [#1532] (#1559)
* fix ponctuation in book/moving_around.md * Add french translation to project * Update i18n meta data after french translation
1 parent 8c9aaaa commit 251f13e

18 files changed

+1208
-5
lines changed

‎.vuepress/config.js

+14
Original file line numberDiff line numberDiff line change
@@ -15,12 +15,14 @@ import {
1515
navbarDe,
1616
navbarEn,
1717
navbarEs,
18+
navbarFr,
1819
navbarJa,
1920
navbarPtBR,
2021
navbarRU,
2122
navbarZhCN,
2223
sidebarDe,
2324
sidebarEn,
25+
sidebarFr,
2426
sidebarEs,
2527
sidebarJa,
2628
sidebarPtBR,
@@ -61,6 +63,11 @@ export default defineUserConfig({
6163
title: 'Nushell',
6264
description: 'Eine neue Art von Shell.',
6365
},
66+
'/fr/': {
67+
lang: 'fr-FR',
68+
title: 'Nushell',
69+
description: 'Un nouveau type de shell.',
70+
},
6471
'/es/': {
6572
lang: 'es-ES',
6673
title: 'Nushell',
@@ -129,6 +136,13 @@ export default defineUserConfig({
129136
navbar: navbarEs,
130137
sidebar: sidebarEs,
131138
},
139+
'/fr/': {
140+
selectText: 'Langues',
141+
selectLanguageName: 'Français',
142+
editLinkText: 'Modifier la page sur GitHub',
143+
navbar: navbarFr,
144+
sidebar: sidebarFr,
145+
},
132146
'/ja/': {
133147
selectText: '言語',
134148
selectLanguageName: '日本語',

‎.vuepress/configs/navbar/fr.ts

+10
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
import type { NavbarConfig } from '@vuepress/theme-default';
2+
3+
export const navbarFr: NavbarConfig = [
4+
{ text: 'Installez Nu !', link: '/fr/book/installation' },
5+
{ text: 'Prise en main', link: '/fr/book/getting_started' },
6+
{
7+
text: 'Documentation',
8+
children: [{ text: 'Le Livre Nushell', link: '/fr/book/' }],
9+
},
10+
];

‎.vuepress/configs/navbar/index.ts

+1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
export * from './de.js';
22
export * from './en.js';
33
export * from './es.js';
4+
export * from './fr.js';
45
export * from './ja.js';
56
export * from './pt-BR.js';
67
export * from './ru.js';

‎.vuepress/configs/sidebar/fr.ts

+29
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
import type { SidebarConfig } from '@vuepress/theme-default';
2+
import { commandCategories } from './command_categories';
3+
4+
export const sidebarFr: SidebarConfig = {
5+
'/fr/book/': [
6+
{
7+
text: 'Introduction',
8+
link: '/fr/book/README.md',
9+
collapsible: false,
10+
},
11+
{
12+
text: 'Installation',
13+
link: '/fr/book/installation.md',
14+
collapsible: false,
15+
children: ['/fr/book/default_shell.md'],
16+
},
17+
{
18+
text: 'Prise en main',
19+
link: '/fr/book/getting_started.md',
20+
collapsible: false,
21+
children: [
22+
'/fr/book/quick_tour.md',
23+
'/fr/book/moving_around.md',
24+
'/fr/book/thinking_in_nu.md',
25+
'/fr/book/cheat_sheet.md',
26+
],
27+
},
28+
],
29+
};

‎.vuepress/configs/sidebar/index.ts

+1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
export * from './de.js';
22
export * from './en.js';
33
export * from './es.js';
4+
export * from './fr.js';
45
export * from './ja.js';
56
export * from './pt-BR.js';
67
export * from './ru.js';

‎book/default_shell.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,8 @@
55
| Terminal | Platform | Instructions |
66
| :--------------: | ------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
77
| 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. |
8-
| 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. |
9-
| 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. |
8+
| 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. |
9+
| 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. |
1010
| Konsole | Linux & BSDs | Open `Settings > Edit Current Profile`. Set `Command` to the path to Nu. |
1111
| 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. |
1212
| 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`. |

‎book/moving_around.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -153,7 +153,7 @@ Nu also provides some basic [filesystem commands](/commands/categories/filesyste
153153
::: tip NOTE
154154
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:
155155

156-
- 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.
156+
- 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.
157157
- They are more tightly integrated with Nushell, allowing them to understand Nushell types and other constructs
158158
- 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.
159159

‎fr/README.md

+61
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
---
2+
home: true
3+
heroImage: null
4+
heroText: Nushell
5+
tagline: Un nouveau type de shell
6+
actionText: Prise en main →
7+
actionLink: /fr/book/
8+
features:
9+
- title: Les pipelines pour contrôler n'importe quel OS
10+
details: Nu fonctionne sur Linux, macOS, BSD, et Windows. Apprennez-le une fois, utilisez le partout après.
11+
- title: Tout est donnée
12+
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.
13+
- title: Des plugins puissants
14+
details: Il est aisé d'étendre Nu en utilisant un système de plugin puissant.
15+
---
16+
17+
<img src="https://www.nushell.sh/frontpage/ls-example.png" alt="Capture montrant l'utilisation de la commande ls" class="hero"/>
18+
19+
### Nu fonctionne avec les données existantes
20+
21+
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 :
22+
23+
<img src="https://www.nushell.sh/frontpage/fetch-example.png" alt="Capture montrant un fetch avec une API web" class="hero"/>
24+
25+
### Nu a d'excellents messages d'erreur
26+
27+
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 :
28+
29+
<img src="https://www.nushell.sh/frontpage/miette-example.png" alt="Capture montrant Nu détectant une erreur de type" class="hero"/>
30+
31+
## Obtenir Nu
32+
33+
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 :
34+
35+
#### macOS / Linux :
36+
37+
##### Homebrew
38+
39+
```shell
40+
$ brew install nushell
41+
```
42+
43+
##### Profil Nix
44+
45+
```shell
46+
$ nix profile install nixpkgs#nushell
47+
```
48+
49+
#### Windows :
50+
51+
```shell
52+
$ winget install nushell
53+
```
54+
55+
Après l'installation, lancez Nu en tapant `nu`.
56+
57+
## Communauté
58+
59+
Rejoingnez-nous [sur Discord](https://discord.gg/NtAbbGn) si vous avez une question à propos de Nu !
60+
61+
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).

‎fr/book/README.md

+64
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,64 @@
1+
# Introduction
2+
3+
Bonjour, et bienvenue dans le projet Nushell.
4+
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.
5+
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.
6+
7+
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 :
8+
9+
- Être un shell flexible et multiplateforme avec une approche moderne
10+
- Résoudre les problèmes comme un langage de programmation moderne qui travaille avec la structure de vos données
11+
- Fournir des messages d'erreur clairs et un support IDE propre
12+
13+
## Ce livre
14+
15+
Le livre est divisé en chapitres qui sont eux-mêmes subdivisés en sections.
16+
Vous pouvez cliquer sur les en-têtes des chapitres pour obtenir plus d'informations à leur sujet.
17+
18+
- [Installation](/fr/book/installation.md), sans surprise, vous aide à installer Nushell sur votre système.
19+
- [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.
20+
- [Fondamentaux de Nu](/book/nu_fundamentals.md) explique les concepts de base du langage Nushell.
21+
- [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.
22+
- [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.
23+
- [Passer à Nu](/book/coming_to_nu.md) a pour but d'offrir un démarrage rapide aux utilisateurs venant d'autres shells ou langages.
24+
- [Notes de Conception](/book/design_notes.md) fournit une explication approfondie de certains des choix de conception de Nushell.
25+
- [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 !).
26+
27+
## Les Nombreux Morceaux de Nushell
28+
29+
Le projet Nushell se compose de plusieurs dépôts et sous-projets.
30+
Vous pouvez tous les trouver sous [notre organisation sur GitHub](https://github.com/nushell).
31+
32+
- 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.
33+
- 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).
34+
- Nushell dispose de son propre éditeur de ligne, qui [a son propre dépôt](https://github.com/nushell/reedline)
35+
- [`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.
36+
- [Nana](https://github.com/nushell/nana) est un effort expérimental pour explorer une interface utilisateur graphique pour Nushell.
37+
- [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.
38+
- [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.
39+
- [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à.
40+
41+
## Contribuer
42+
43+
Nous accueillons volontiers les contributions !
44+
[Comme vous pouvez le voir](#les-nombreux-morceaux-de-nushell), il y a de nombreux endroits où contribuer.
45+
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 !).
46+
47+
Nushell lui-même est écrit en [Rust](https://www.rust-lang.org).
48+
Cependant, vous n'avez pas besoin d'être un programmeur en Rust pour aider.
49+
Si vous connaissez un peu le développement web, vous pouvez contribuer à l'amélioration de ce site web ou du projet Nana.
50+
[Les Dataframes](dataframes.md) peuvent bénéficier de votre expertise en traitement de données.
51+
52+
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.
53+
Découvrir des bugs avec des étapes pour les reproduire et les signaler sur GitHub est également une aide précieuse !
54+
Vous pouvez contribuer à Nushell simplement en utilisant Nushell !
55+
56+
Étant donné que Nushell évolue rapidement, ce livre a constamment besoin d'être mis à jour.
57+
Contribuer à ce livre ne nécessite pas de compétences particulières, à part une familiarité de base avec le Markdown.
58+
En outre, vous pouvez envisager de traduire des parties dans votre langue.
59+
60+
## Communauté
61+
62+
L'endroit principal pour discuter de quoi que ce soit qui concerne Nushell est notre [Discord](https://discord.com/invite/NtAbbGn).
63+
Vous pouvez également nous suivre sur [Twitter](https://twitter.com/nu_shell) pour des news et des mises à jour.
64+
Enfin, vous pouvez utiliser les discussions ou ouvrir des issues sur GitHub.

0 commit comments

Comments
 (0)