Guide d'utilisation de Firefly

Ce modèle de blog est construit avec Astro. Pour tout ce qui n’est pas mentionné dans ce guide, vous pouvez trouver des réponses dans la documentation Astro.

Front-matter d’un article

1
---
2
title: Mon premier article de blog
3
published: 2023-09-09
4
description: Ceci est mon premier article sur mon nouveau blog Astro.
5
image: ./cover.jpg
6
tags: [Frontend, Développement]
7
category: Développement Frontend
8
draft: false
9
---

Propriété	Description
`title`	Titre de l’article.
`published`	Date de publication de l’article.
`updated`	Date de mise à jour de l’article. Si non définie, la date de publication sera utilisée par défaut.
`pinned`	Permet d’épingler l’article en haut de la liste des articles.
`description`	Courte description de l’article. Affichée sur la page d’accueil.
`image`	Chemin de l’image de couverture de l’article. 1. Commençant par `http://` ou `https://` : image en ligne 2. Commençant par `/` : image dans le répertoire `public` 3. Sans préfixe : chemin relatif au fichier markdown
`tags`	Tags de l’article.
`category`	Catégorie de l’article.
`lang`	Code de langue de l’article (ex. `fr`). À définir uniquement si la langue de l’article diffère de la langue par défaut du site.
`licenseName`	Nom de la licence du contenu de l’article.
`licenseUrl`	Lien vers la licence du contenu de l’article.
`author`	Auteur de l’article.
`sourceLink`	Lien source ou référence du contenu de l’article.
`draft`	Si cet article est encore un brouillon, il ne sera pas affiché.
`comment`	Activer ou non les commentaires pour cet article. `true` par défaut.
`slug`	Chemin URL personnalisé de l’article. Si non défini, le nom de fichier sera utilisé comme URL.
`password`	Mot de passe de l’article. Une fois défini, le contenu sera chiffré avec AES-256-GCM ; les visiteurs devront entrer le mot de passe pour le consulter.
`passwordHint`	Indice du mot de passe. Affiché au-dessus du champ de saisie pour aider les visiteurs à se souvenir du mot de passe. Facultatif.

Emplacement des fichiers d’articles

Vos fichiers d’articles doivent être placés dans le répertoire src/content/posts/. Vous pouvez également créer des sous-répertoires pour mieux organiser vos articles et ressources.

1
src/content/posts/
2
├── article-1.md
3
└── article-2/
4
    ├── cover.png
5
    └── index.md

Personnaliser l’URL d’un article (Slug)

Qu’est-ce qu’un Slug ?

Le slug est la partie personnalisée du chemin URL d’un article. Si vous ne définissez pas de slug, le système utilisera le nom de fichier comme URL.

Exemples d’utilisation du Slug

Exemple 1 : utiliser le nom de fichier comme URL

1
---
2
title: Mon premier article de blog
3
published: 2023-09-09
4
---

Fichier : src/content/posts/my-first-blog-post.md

URL : /posts/my-first-blog-post

Exemple 2 : Slug personnalisé

1
---
2
title: Mon premier article de blog
3
published: 2023-09-09
4
slug: hello-world
5
---

Fichier : src/content/posts/my-first-blog-post.md

URL : /posts/hello-world

Exemple 3 : Slug pour un fichier avec un nom en langue étrangère

1
---
2
title: Comment utiliser le thème de blog Firefly
3
published: 2023-09-09
4
slug: how-to-use-firefly-blog-theme
5
---

Fichier : src/content/posts/comment-utiliser-firefly.md

URL : /posts/how-to-use-firefly-blog-theme

Recommandations pour le Slug

Utiliser l’anglais et des tirets : mon-super-article plutôt que mon super article
Rester concis : éviter les slugs trop longs
Être descriptif : l’URL doit refléter le contenu de l’article
Éviter les caractères spéciaux : utiliser uniquement des lettres, chiffres et tirets
Rester cohérent : utiliser des modèles de nommage similaires dans tout le blog

Points d’attention

Une fois le slug défini et publié, il est déconseillé de le modifier pour ne pas affecter le SEO et les liens existants
Si plusieurs articles utilisent le même slug, le dernier remplacera le précédent
Le slug est automatiquement converti en minuscules