199 lines
8.0 KiB
Markdown
199 lines
8.0 KiB
Markdown
---
|
|
title: Utilisation des modèles de page
|
|
content_type: concept
|
|
weight: 30
|
|
card:
|
|
name: contribute
|
|
weight: 30
|
|
---
|
|
|
|
<!-- 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.
|
|
|
|
Les templates de page sont dans le répertoire [`layouts/partials/templates`](https://git.k8s.io/website/layouts/partials/templates) du dépôt [`kubernetes/website`](https://github.com/kubernetes/website).
|
|
|
|
{{< note >}}
|
|
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 >}}
|
|
|
|
|
|
|
|
<!-- body -->
|
|
|
|
## Concept template
|
|
|
|
Une page de concept explique certains aspects de Kubernetes.
|
|
Par exemple, une page conceptuelle peut décrire l'objet Kubernetes `Deployment` et expliquer le rôle qu'il joue en tant qu'application une fois qu'il est déployé, dimensionné et mis à jour.
|
|
Généralement, les pages conceptuelles n'incluent pas de séquences d'étapes, mais fournissent plutôt des liens vers des tâches ou des tutoriels.
|
|
|
|
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_type: concept`.
|
|
- Dans le corps de la page, définissez les variables `capture` requises et les variables optionnelles que vous voulez inclure :
|
|
|
|
| Variable | Required? |
|
|
|---------------|-----------|
|
|
| overview | yes |
|
|
| body | yes |
|
|
| whatsnext | no |
|
|
|
|
Le corps de la page ressemblera à ceci (supprimez toutes les captures optionnelles dont vous n'avez pas besoin) :
|
|
|
|
```
|
|
{{%/* capture overview */%}}
|
|
|
|
{{%/* /capture */%}}
|
|
|
|
{{%/* capture body */%}}
|
|
|
|
{{%/* /capture */%}}
|
|
|
|
{{%/* capture whatsnext */%}}
|
|
|
|
{{%/* /capture */%}}
|
|
```
|
|
|
|
- Remplissez chaque section de contenu. Suivez ces lignes directrices :
|
|
- Organiser le contenu avec les rubriques H2 et H3.
|
|
- Pour `overview`, définir le contexte du sujet à l'aide d'un seul paragraphe.
|
|
- Pour `body`, expliquer le concept.
|
|
- Pour `whatsnext`, fournir une liste à puces de sujets (5 au maximum) pour en apprendre davantage sur le concept.
|
|
|
|
[Annotations](/docs/concepts/overview/working-with-objects/annotations/) est un exemple publié du template de concept.
|
|
Cette page utilise également le modèle de concept.
|
|
|
|
## Template de tâche
|
|
|
|
Une page de tâches montre comment faire une seule chose, généralement en donnant une courte séquence d'étapes.
|
|
Les pages de tâches ont une explication minimale, mais fournissent souvent des liens vers des sujets conceptuels qui fournissent un contexte et des connaissances connexes.
|
|
|
|
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_type: task`.
|
|
- Dans le corps de la page, définissez les variables `capture` requises et les variables optionnelles que vous voulez inclure :
|
|
|
|
| Variable | Required? |
|
|
|---------------|-----------|
|
|
| overview | yes |
|
|
| prerequisites | yes |
|
|
| steps | no |
|
|
| discussion | no |
|
|
| whatsnext | no |
|
|
|
|
Le corps de la page ressemblera à ceci (supprimez toutes les captures optionnelles dont vous n'avez pas besoin) :
|
|
|
|
```
|
|
{{%/* capture overview */%}}
|
|
|
|
{{%/* /capture */%}}
|
|
|
|
{{%/* capture prerequisites */%}}
|
|
|
|
{{</* include "task-tutorial-prereqs.md" */>}} {{</* version-check */>}}
|
|
|
|
{{%/* /capture */%}}
|
|
|
|
{{%/* capture steps */%}}
|
|
|
|
{{%/* /capture */%}}
|
|
|
|
{{%/* capture discussion */%}}
|
|
|
|
{{%/* /capture */%}}
|
|
|
|
{{%/* capture whatsnext */%}}
|
|
|
|
{{%/* /capture */%}}
|
|
```
|
|
|
|
- Dans chaque section, écrivez votre contenu.
|
|
Suivez les directives suivantes :
|
|
- Utilisez un minimum d'en-têtes H2 (avec deux caractères `#` en tête de liste).
|
|
Les sections elles-mêmes sont intitulées automatiquement par le modèle.
|
|
- Pour `overview`, utilisez un paragraphe pour définir le contexte de l'ensemble du sujet.
|
|
- Pour `prerequisites`, utiliser des listes à puces dans la mesure du possible.
|
|
Commencez à ajouter des prérequis supplémentaires sous la balise `include`.
|
|
Les conditions préalables par défaut incluent un cluster Kubernetes en cours d'exécution.
|
|
- Pour `steps`, utiliser des listes numérotées.
|
|
- Pour la discussion, utilisez le contenu normal pour développer l'information couverte dans la section `steps`.
|
|
- Pour `whatsnext`, donnez une liste de 5 sujets au maximum qui peuvent être intéressant à lire ensuite.
|
|
|
|
Voici un exemple de sujet publié qui utilise le template de tasks [Using an HTTP proxy to access the Kubernetes API](/docs/tasks/access-kubernetes-api/http-proxy-access-api).
|
|
|
|
## Tutorial template
|
|
|
|
Une page de tutoriel montre comment atteindre un objectif qui est plus grand qu'une seule tâche.
|
|
Typiquement, une page de tutoriel comporte plusieurs sections, chacune d'entre elles ayant une séquence d'étapes.
|
|
Par exemple, un tutoriel pourrait fournir un aperçu d'un exemple de code qui illustre une certaine caractéristique de Kubernetes.
|
|
Les didacticiels peuvent inclure des explications au niveau de la surface, mais devraient être reliés à des sujets connexes sur les concepts pour des explications approfondies.
|
|
|
|
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_type: tutorial`.
|
|
- Dans le corps de la page, définissez les variables `capture` requises et les variables optionnelles que vous voulez inclure :
|
|
|
|
| Variable | Required? |
|
|
|---------------|-----------|
|
|
| overview | yes |
|
|
| prerequisites | yes |
|
|
| objectives | yes |
|
|
| lessoncontent | yes |
|
|
| cleanup | no |
|
|
| whatsnext | no |
|
|
|
|
Le corps de la page ressemblera à ceci (supprimez toutes les captures optionnelles dont vous n'avez pas besoin) :
|
|
|
|
```
|
|
{{%/* capture overview */%}}
|
|
|
|
{{%/* /capture */%}}
|
|
|
|
{{%/* capture prerequisites */%}}
|
|
|
|
{{</* include "task-tutorial-prereqs.md" */>}} {{</* version-check */>}}
|
|
|
|
{{%/* /capture */%}}
|
|
|
|
{{%/* capture objectives */%}}
|
|
|
|
{{%/* /capture */%}}
|
|
|
|
{{%/* capture lessoncontent */%}}
|
|
|
|
{{%/* /capture */%}}
|
|
|
|
{{%/* capture cleanup */%}}
|
|
|
|
{{%/* /capture */%}}
|
|
|
|
{{%/* capture whatsnext */%}}
|
|
|
|
{{%/* /capture */%}}
|
|
```
|
|
|
|
- Dans chaque section, écrivez votre contenu. Suivez les directives suivantes :
|
|
- Utilisez un minimum d'en-têtes H2 (avec deux caractères `#` en tête de liste).
|
|
Les sections elles-mêmes sont intitulées automatiquement par le template.
|
|
- Pour `overview`, utiliser un paragraphe pour définir le contexte de l'ensemble du sujet.
|
|
- Pour `prerequisites`, utiliser des listes à puces dans la mesure du possible.
|
|
Ajoutez des prérequis supplémentaires en dessous de ceux inclus par défaut.
|
|
- Pour `objectives`, utiliser des listes à puces.
|
|
- Pour `lessoncontent`, utiliser un mélange de listes numérotées et de contenu narratif, le cas échéant.
|
|
- Pour `cleanup`, utiliser des listes numérotées pour décrire les étapes de nettoyage de l'état du cluster une fois la tâche terminée.
|
|
- Pour `whatsnext`, Donnez une liste de 5 sujets au maximum qu'il serait intéressant à lire ensuite.
|
|
|
|
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/).
|
|
|
|
|
|
|
|
## {{% 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/)
|
|
|
|
|