Article éditorial

Tâche#

Utilisez ce motif pour un billet de blogue ou une note AJA durable : un article Markdown canonique, une provenance claire et des chemins discrets vers la prochaine page utile. Ce n’est ni une page de documentation, ni un index de référence, ni une liste de collection.

Composition#

L’article commence par l’En-tête de page et sa Rangée de métadonnées. Les billets de blogue et notes AJA reçoivent automatiquement Copier en Markdown. Un article qui appartient à une véritable séquence éditoriale peut ajouter la Navigation de collection; un article avec un petit ensemble de pages adjacentes peut déclarer les Articles liés. Les deux mécanismes de continuation sont facultatifs et répondent à des questions différentes.

Contenu et données#

Écrivez le corps en Markdown et gardez un front matter factuel : dates, description, étiquettes, appartenance à une collection et chemins related:. Le Markdown reste la représentation canonique exposée par le contrôle de copie; le HTML rendu est une présentation de cette source. Choisissez une collection seulement pour une appartenance durable et related: seulement pour des continuations précises et utiles.

Comportement adaptatif#

L’article reste une colonne de lecture unique et confortable. Les métadonnées de l’en-tête passent à la ligne dans l’ordre source, le contrôle de copie demeure un bouton compact et les listes de continuation conservent leurs rangées de liens ordinaires. Aucune information d’article n’est retirée sur petit écran; les métadonnées denses passent à la ligne plutôt que de devenir un menu impossible à trouver.

Implémentation#

Les layouts uniques de blogue et d’AJA rendent la coque d’article, entry-title-block.html, .Content brut, post-collection.html et related-posts.html. Le partial de titre d’entrée active le contrôle de copie pour les pages normales de blogue et d’AJA; layouts/_default/single.markdown.md produit la sortie Markdown canonique. Le CSS fournit l’échelle typographique et la disposition, et le JavaScript se limite à copier le Markdown lorsque le lecteur le demande.

Accessibilité#

• L’article possède un seul <h1> dans son en-tête; les liens et contrôles de métadonnées suivent un ordre de lecture stable.
• Le corps de lecture conserve les titres, liens, listes, tableaux et blocs de code sémantiques rendus depuis Markdown au lieu de les remplacer par des conteneurs de présentation génériques.
• Copier en Markdown est un bouton natif avec un message d’état poli. Il ne modifie pas le contenu de l’article et ne déplace pas le focus.
• La navigation de collection et les articles liés sont des asides nommés distincts et ne se rendent que lorsqu’ils contiennent des destinations. Ne les utilisez pas tous deux pour répéter les mêmes liens.
• Les dates utilisent des valeurs <time> lisibles par machine, tandis que les étiquettes, liens de collection et continuations restent des liens ordinaires utilisables au clavier.