Archétypes
Les archétypes sont des fichiers de départ pour les formes de contenu connues. Ils réduisent la dérive causée par le copier-coller en donnant à chaque type de page répété le même front matter initial et la même structure de départ.
Utilisez Conventions de nommage pour nommer les clés d’archétypes. Utilisez cette page lorsque vous ajoutez ou modifiez les fichiers physiques sous archetypes/.
Bibliothèque actuelle#
| Archétype | Famille de chemins visée | À utiliser pour |
|---|---|---|
blog-post | content/blog/**/name.en.md | Créer un article du site principal |
blog-section | content/blog/**/_index.en.md | Créer une page pivot de sujet du site principal |
brand-docs-page | content-brand/docs/**/name.en.md | Créer une page feuille de documentation marque |
brand-docs-section | content-brand/docs/**/_index.en.md | Créer une page pivot de documentation marque |
component | content-brand/docs/**/components/** | Créer une page de référence de composant |
docs-page | content*/docs/**/name.en.md | Créer une page feuille de documentation |
docs-section | content*/docs/**/_index.en.md | Créer une page pivot de documentation |
legal-page | content*/legal/**/name.en.md | Rédiger une page juridique ou de politique |
shortcode | content-brand/docs/**/shortcodes/** | Créer une page de référence de shortcode |
til-note | content/til/**/name.en.md | Créer une courte note AJA |
Créez le contenu avec un type explicite :
hugo new -k brand-docs-page content-brand/docs/site-governance/example.en.mdCréez la paire française à partir du même archétype, puis traduisez le front matter et le corps de façon intentionnelle :
hugo new -k brand-docs-page content-brand/docs/site-governance/example.fr.mdRègles#
- Gardez les archétypes courts; ils doivent démarrer une page, pas écrire la page.
- Incluez seulement les champs qui changent le comportement des gabarits ou qui évitent des oublis.
- N’incluez pas
aliases:vide sauf si l’archétype documente une migration d’URL. - Ne créez pas d’archétype propre à un site lorsque la forme générique suffit.
- Mettez cette page et Conventions de nommage à jour lorsqu’une nouvelle clé d’archétype est ajoutée.
Ce qui vit ailleurs#
Les champs de front matter sont gouvernés par Gouvernance du site > Contenu > Front matter. Le comportement des gabarits est documenté dans Front matter. Les archétypes fournissent seulement des fichiers de départ pour ces règles.