Mettre en place un blog

Chinaski est livré d'abord comme un blog : posts, catégories, index paginé et flux font tous partie des composants standards. Ce guide met en place un blog fonctionnel : la structure d'URL, l'écriture et l'organisation des posts, les catégories, le titre de la page d'index et la pagination, le flux, et les variantes par langue.

Étape 1 : Choisir le domicile URL du blog

Dans Settings, choisissez le post URL prefix : le chemin sous lequel vivent vos posts. La valeur par défaut est blog, ce qui donne des URL comme /en/blog/my-post/.

Vous pouvez définir un préfixe différent par langue : utile si « blog » se traduit (journal/ dans une langue, blog/ dans une autre).
Un préfixe vide place les posts à la racine de la langue (/en/my-post/) si l'index doit être la page d'accueil.
Changer de préfixe est sûr : chaque post publié reçoit une redirection automatique depuis son ancienne adresse au prochain build, donc renommer plus tard ne casse jamais les liens.
La page d'accueil du site pointe par défaut vers le blog (une redirection racine est générée quand aucune page racine n'existe), ou choisissez n'importe quelle page comme cible d'accueil dans les réglages.

Étape 2 : Choisir le titre de l'index

La page d'index du blog a un titre que vous pouvez définir sans toucher aux templates, avec cette chaîne de repli :

Un blog index title par langue (réglages).
Un blog index title global au site.
Le préfixe URL avec initiale majuscule (« blog » → « Blog »).
Le mot littéral « Blog ».

Écrivez-le dans n'importe lequel des réglages par langue ; le builder choisit le bon par langue.

Étape 2b : Écrire des posts

Utilisez l'éditeur de posts exactement comme pour les pages (même éditeur de corps), plus les champs propres aux posts :

Excerpt : affiché dans les listes et le partage social ; facultatif (un extrait automatique est dérivé du texte d'ouverture pour les besoins de la recherche si vous le laissez vide).
Category : une par post (voir ci-dessous).
Tags : séparés par des virgules, affichés par votre thème.
Author : à choisir dans la liste d'auteurs gérée (plusieurs auteurs par post sont pris en charge).
Sticky : épingle le post en haut de l'index.
Featured image : avec texte alt et point focal.
Scheduling : publication/dépublication à des heures futures ou passées.
SEO fields et réglages de sitemap par post.

Importez du contenu existant comme brouillons via des fichiers markdown avec front matter (title, slug, category, language).

Deux motifs particuliers :

Gardez un post modèle. Marquez un post comme modèle (« use as template ») pour le réutiliser comme point de départ de formats récurrents (par exemple, une revue hebdomadaire) : les modèles sont tenus à l'écart du listing public.
Protégez un post par mot de passe pour les pièces réservées aux membres (les règles de verrouillage des Protected Pages s'appliquent).

Étape 3 : Les catégories

Les catégories sont gérées dans leur propre section d'admin, par langue : chacune a un nom, un slug et une description.
Vous n'avez pas à prédéfinir les catégories : enregistrer un post avec une valeur de catégorie l'ajoute automatiquement à la liste gérée.
Chaque catégorie reçoit sa propre page de listing (avec pagination et ses propres URL de partage/canoniques), accessible depuis les posts par le thème ; les templates de listing de catégorie sont le même template d'index de blog, filtré.

Étape 4 : L'index et ses pages

La liste des posts est paginée automatiquement selon le réglage posts per page (10 par défaut). La page 2 et au-delà vivent sous .../page/2/ avec des URL canoniques appropriées, pour que les moteurs de recherche ne brouillent pas les pages entre elles. Le template d'index reçoit tout ce dont il a besoin (liste des posts avec dates/liens, pagination, nom de catégorie quand filtré) ; les thèmes n'ont qu'à faire le rendu.

Étape 4b : Le flux RSS

Le blog de chaque langue reçoit son propre flux sous /…/feed.xml, servi au préfixe du blog, l'adresse du flux étant disponible pour les thèmes comme variable. Une nuance : le fichier de flux n'est généré que lorsqu'au moins un post est publié : un blog tout neuf sans aucun post n'a pas encore de fichier de flux (son index peut afficher un lien de flux qui ne mène nulle part tant que le premier post n'est pas en ligne).

Étape 5 : Posts liés (facultatif)

Les liens « liés » entre posts sont rédigés, pas automatiques : reliez des posts entre eux comme liés dans l'éditeur (ou via l'API), et le block intégré de posts liés restitue ces connexions par post. La mise en relation par tags ou par similarité n'existe pas ici ; les relations sont délibérées.

Étape 6 : La découverte (intégrée)

Au moment du build, les sorties destinées aux moteurs de recherche se mettent à jour automatiquement :

Le sitemap inclut l'index du blog et chaque post publié (avec les priorités par défaut documentées sur la page du sitemap ; les posts protégés par mot de passe sont exclus).
Les pages de catégorie ont leurs propres URL canoniques pour que les moteurs de recherche traitent correctement chaque combinaison catégorie/page.
Comme tout le reste, les posts sont des enregistrements par langue : les traductions reçoivent leur propre entrée de flux, leurs liens hreflang et leur entrée de sitemap via le processus de clés de traduction.

La version courte

Écrivez des posts dans la langue par défaut, organisez avec des catégories (elles construisent vos pages de catégorie), définissez le titre de l'index une fois, et l'index paginé, les pages de catégorie et le flux RSS proviennent du même build qui publie les pages. Un renommage du préfixe garde les anciens liens vivants, et les traductions s'insèrent dans les mêmes structures.