Contribuer à la documentation Kubernetes

Edit This Page

Organisation du contenu

Ce site utilise Hugo. Dans Hugo, l’organisation du contenu est un concept de base.

Note: Astuce Hugo: Démarrez Hugo avec hugo server --navigateToChanged pour les sessions d’édition de contenu.

Listes de pages

Ordre des pages

Le menu latéral de la documentation, le navigateur de la page de documentation, etc. sont listés selon l’ordre de tri par défaut de Hugo, qui trie par poids (à partir de 1), par date (la plus récente en premier), et enfin par titre du lien.

Si vous voulez déplacer une page ou une section vers le haut, placez un poids dans l’entête de la page :

title: My Page
weight: 10
Note: Pour les poids de page, il peut être judicieux de ne pas utiliser 1, 2, 3…, mais un autre intervalle, disons 10, 20, 30… Ceci vous permet d’insérer des pages où vous voulez plus tard.

Le menu principal Documentation est construit à partir des sections ci-dessous docs/ avec le drapeau main_menu placé dans l’entête du fichier de contenu de la section `_index.md’ :

main_menu: true

Notez que le titre du lien est récupéré à partir du linkTitle de la page, donc si vous voulez qu’il soit différent du titre, changez-le dans le fichier du contenu cible :

main_menu: true
title: Page Title
linkTitle: Title used in links
Note: Ce qui précède doit être fait par langue. Si vous ne voyez pas votre section dans le menu, c’est probablement parce qu’elle n’est pas identifiée comme une section par Hugo. Créez un fichier de contenu _index.md dans le dossier de la section.

Le menu latéral de la barre de documentation est construit à partir de l’arborescence de la section courante commençant sous docs/.

Il affichera toutes les sections et leurs pages.

Si vous ne voulez pas lister une section ou une page, mettez l’option toc_hide à true dans l’entête :

toc_hide: true

Lorsque vous naviguez vers une section contenant du contenu, la section ou la page spécifique (par exemple _index.md) est affichée. Sinon, la première page à l’intérieur de cette section est affichée.

Le navigateur de page sur la page d’accueil de la documentation est construit en utilisant toutes les sections et pages qui sont directement sous la section docs.

Si vous ne voulez pas lister une section ou une page, mettez l’option toc_hide à true dans la partie avant :

toc_hide: true

Les liens du site dans le menu en haut à droite – et aussi dans le pied de page – sont construits par des recherches de pages. C’est pour s’assurer que la page existe réellement. Ainsi, si la section case-studies n’existe pas dans un site (langue), le lien n’apparaitra pas.

Paquets de pages

In addition to standalone content pages (Markdown files), Hugo supports Page Bundles.

One example is Custom Hugo Shortcodes. On considère qu’il s’agit d’un “paquet de feuilles”. Tout ce qui se trouve sous le répertoire, y compris le fichier `index.md’, fera partie du paquet. Cela inclut également les liens relatifs aux pages, les images qui peuvent être traitées, etc :

en/docs/home/contribute/includes
├── example1.md
├── example2.md
├── index.md
└── podtemplate.json

Un autre exemple largement utilisé est celui du paquet includes. Il définit headless : true dans l’entête, ce qui signifie qu’il n’obtient pas son propre URL. Il n’est utilisé que dans d’autres pages.

en/includes
├── default-storage-class-prereqs.md
├── federated-task-tutorial-prereqs.md
├── index.md
├── partner-script.js
├── partner-style.css
├── task-tutorial-prereqs.md
├── user-guide-content-moved.md
└── user-guide-migration-notice.md

Quelques notes importantes sur les fichiers dans les paquets :

  • Pour les paquets traduits, tous les fichiers non contenus manquants seront hérités des fichiers de langue anglaise. Cela permet d’éviter les doublons.
  • Tous les fichiers d’un bundle sont ce que Hugo appelle Resources et vous pouvez fournir des métadonnées par langue, comme les paramètres et le titre, même s’il ne prend pas en charge les entêtes (fichiers YAML etc.). Voir Page Resources Metadata.
  • La valeur que vous obtenez de .RelPermalink d’un Resource est relative à la page. Voir Permalinks.

Styles

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.

A suivre

Feedback