add fr pages

This commit is contained in:
Karen Bradshaw
2020-05-30 15:36:51 -04:00
parent 6a9c673a92
commit 7daf3c55e9
80 changed files with 615 additions and 545 deletions
@@ -1,18 +1,18 @@
---
title: Organisation du contenu
content_template: templates/concept
content_type: concept
weight: 40
---
{{% capture overview %}}
<!-- overview -->
Ce site utilise Hugo.
Dans Hugo, l'[organisation du contenu](https://gohugo.io/content-management/organization/) est un concept de base.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
{{% note %}}
**Astuce Hugo:** Démarrez Hugo avec `hugo server --navigateToChanged` pour les sessions d'édition de contenu.
@@ -134,11 +134,12 @@ Quelques notes importantes sur les fichiers dans les paquets :
La source `SASS` des feuilles de style pour ce site est stockée sous `src/sass` et peut être construite avec `make sass` (notez que Hugo aura bientôt le support `SASS`, voir <https://github.com/gohugoio/hugo/issues/4243>.
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
* [Hugo shortcodes personnalisés](/docs/contribute/style/hugo-shortcodes/)
* [Style guide](/docs/contribute/style/style-guide)
{{% /capture %}}
@@ -1,16 +1,16 @@
---
title: Hugo Shortcodes personnalisés
content_template: templates/concept
content_type: concept
---
{{% capture overview %}}
<!-- overview -->
Cette page explique les shortcodes Hugo personnalisés pouvant être utilisés dans la documentation de Kubernetes Markdown.
En savoir plus sur shortcodes dans la [documentation Hugo](https://gohugo.io/content-management/shortcodes).
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Etat de la fonctionnalité
@@ -208,9 +208,10 @@ Rend à:
{{< tab name="JSON File" include="podtemplate" />}}
{{< /tabs >}}
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
* En savoir plus sur [Hugo](https://gohugo.io/).
* En savoir plus sur [écrire un nouveau sujet](/docs/home/contribute/write-new-topic/).
@@ -218,4 +219,4 @@ Rend à:
* En savoir plus sur [staging your changes](/docs/home/contribute/stage-documentation-changes/)
* En savoir plus sur [créer une pull request](/docs/home/contribute/create-pull-request/).
{{% /capture %}}
@@ -1,13 +1,13 @@
---
title: Utilisation des modèles de page
content_template: templates/concept
content_type: concept
weight: 30
card:
name: contribute
weight: 30
---
{{% capture overview %}}
<!-- overview -->
Lorsque vous ajoutez de nouveaux sujets, appliquez-leur l'un des templates suivants.
Ceci standardise l'expérience utilisateur d'une page donnée.
@@ -19,9 +19,9 @@ Chaque nouveau sujet doit utiliser un modèle.
Si vous n'êtes pas sûr du modèle à utiliser pour un nouveau sujet, commencez par un [template concept](#concept-template).
{{< /note >}}
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Concept template
@@ -31,7 +31,7 @@ Généralement, les pages conceptuelles n'incluent pas de séquences d'étapes,
Pour écrire une nouvelle page concept, créez un fichier Markdown dans un sous-répertoire du répertoire `/content/fr/docs/concepts`, avec les caractéristiques suivantes :
- Dans l'entête YAML de la page, définissez `content_template: templates/concept`.
- Dans l'entête YAML de la page, définissez `content_type: concept`.
- Dans le corps de la page, définissez les variables `capture` requises et les variables optionnelles que vous voulez inclure :
| Variable | Required? |
@@ -72,7 +72,7 @@ Les pages de tâches ont une explication minimale, mais fournissent souvent des
Pour écrire une nouvelle page de tâches, créez un fichier Markdown dans un sous-répertoire du répertoire `/content/fr/docs/tasks`, avec les caractéristiques suivantes :
- Dans l'entête YAML de la page, définissez `content_template: templates/task`.
- Dans l'entête YAML de la page, définissez `content_type: task`.
- Dans le corps de la page, définissez les variables `capture` requises et les variables optionnelles que vous voulez inclure :
| Variable | Required? |
@@ -132,7 +132,7 @@ Les didacticiels peuvent inclure des explications au niveau de la surface, mais
Pour écrire une nouvelle page de tutoriel, créez un fichier Markdown dans un sous-répertoire du répertoire `/content/fr/docs/tutorials`, avec les caractéristiques suivantes :
- Dans l'entête YAML de la page, définissez `content_template: templates/tutorial`.
- Dans l'entête YAML de la page, définissez `content_type: tutorial`.
- Dans le corps de la page, définissez les variables `capture` requises et les variables optionnelles que vous voulez inclure :
| Variable | Required? |
@@ -187,11 +187,12 @@ Pour écrire une nouvelle page de tutoriel, créez un fichier Markdown dans un s
Voici un exemple de sujet publié qui utilise le modèle de tutoriel [Running a Stateless Application Using a Deployment](/docs/tutorials/stateless-application/run-stateless-application-deployment/).
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
- En savoir plus sur le [style guide](/docs/contribute/style/style-guide/)
- En savoir plus sur l'[organisation des contenus](/docs/contribute/style/content-organization/)
{{% /capture %}}
@@ -1,7 +1,7 @@
---
title: Documentation Style Guide
linktitle: Style guide
content_template: templates/concept
content_type: concept
weight: 10
card:
name: contribute
@@ -9,15 +9,15 @@ card:
title: Documentation Style Guide
---
{{% capture overview %}}
<!-- overview -->
Cette page donne des directives de style d'écriture pour la documentation de Kubernetes.
Ce sont des lignes directrices, pas des règles.
Faites preuve de discernement et n'hésitez pas à proposer des modifications à ce document dans le cadre d'une pull request.
Pour plus d'informations sur la création de nouveau contenu pour les documents Kubernetes, suivez les instructions sur[l'utilisation des templates](/fr/docs/contribute/style/page-templates/) et [création d'une pull request de documentation](/fr/docs/contribute/start/#improve-existing-content).
{{% /capture %}}
{{% capture body %}}
<!-- body -->
{{< note >}}
La documentation de Kubernetes utilise [Blackfriday Markdown Renderer](https://github.com/russross/blackfriday) ainsi que quelques [Hugo Shortcodes](/docs/home/contribute/includes/) pour prendre en charge les entrées de glossaire, les onglets et la représentation de l'état des fonctionnalités.
@@ -403,13 +403,14 @@ Une caractéristique qui est nouvelle aujourd'hui pourrait ne pas être considé
| Dans la version 1.4, ... | Dans la version actuelle, ... |
| La fonction de fédération offre ... | La nouvelle fonctionnalité de la Fédération offre ... |
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
* En savoir plus sur [writing a new topic](/docs/home/contribute/write-new-topic/).
* En savoir plus sur [using page templates](/docs/home/contribute/page-templates/).
* En savoir plus sur [staging your changes](/docs/home/contribute/stage-documentation-changes/)
* En savoir plus sur [creating a pull request](/docs/home/contribute/create-pull-request/).
{{% /capture %}}
@@ -1,18 +1,19 @@
---
title: Rédiger une nouveau sujet
content_template: templates/task
content_type: task
weight: 20
---
{{% capture overview %}}
<!-- overview -->
Cette page montre comment créer un nouveau sujet pour la documentation Kubernetes.
{{% /capture %}}
{{% capture prerequisites %}}
## {{% heading "prerequisites" %}}
Créez un fork du dépôt de la documentation de Kubernetes comme décrit dans [Commencez à contribuer](/fr/docs/contribute/start/).
{{% /capture %}}
{{% capture steps %}}
<!-- steps -->
## Choisir un type de page
@@ -143,12 +144,13 @@ Pour un exemple d'un sujet qui utilise cette technique, voir [Running a Single-I
Placez les fichiers images dans le répertoire `/images`.
Le format d'image préféré est SVG.
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
* En savoir plus sur [l'utilisation des templates de pages](/docs/home/contribute/page-templates/).
* En savoir plus sur [le staging de vos changements](/docs/home/contribute/stage-documentation-changes/).
* En savoir plus sur [la création d'une pull request](/docs/home/contribute/create-pull-request/).
{{% /capture %}}