Point de départ d'un article
Contenu RST d'exemple pour servir de base et être modifié pour votre article.
En-tête principal de votre article
#############################################
:lang: fr
:category: une catégorie valide
:date: 2025-10-11 20:03:36+00:00
:tags: article, modèle
:slug: nom-unique-de-l-article
:authors: Pierre Bernatchez
:summary: Résumé en une ligne de votre article
.. |copy| unicode:: 0xA9 .. signe copyright
.. |---| unicode:: U+02014 .. tiret cadratin
:trim:
.. footer:: Copyright |copy| 2025 Pierre Bernatchez |---| tous droits réservés.
Commencez ici
Modifiez l'en-tête principal par quelque chose de convenable pour votre article.
Modifiez la catégorie par une catégorie appropriée à votre article.
Modifiez la date. Vous pouvez utiliser la commande en ligne de commande "date -u --rfc-3339=seconds" pour obtenir une chaîne de date correctement formatée.
Modifiez les étiquettes avec des mots-clés pertinents pour votre article.
Modifiez le slug pour qu'il soit le nom unique de votre article. Nous l'utilisons comme base pour le nom de fichier du fichier .rst. Ainsi, slugname-en.rst, slugname-es.rst, slugname-fr.rst sont les 3 noms de fichiers en différentes langues pour l'article avec le slug : slugname.
Modifiez authors par votre propre nom.
Modifiez le résumé par quelque chose d'approprié à votre article.
Modifiez également le nom dans la ligne footer par le vôtre.
Rédigez votre article en utilisant le balisage RST, en commençant à commencez ici
Notez qu'il existe deux scripts Python pratiques qui peuvent générer un point de départ pour un nouvel article.
Générer un point de départ d'article sans image
newarticle -h
usage: newarticle [-h] [-a AUTHOR] [-l {en,fr,es,all}] [-d DUP] [-r]
articlename
Generate a skeleton article file
positional arguments:
articlename article name without the "-en.rst")
options:
-h, --help show this help message and exit
-a AUTHOR, --author AUTHOR
Author for copyright and for authors (default "Pierre
Bernatchez)"
-l {en,fr,es,all}, --lang {en,fr,es,all}
language of the new article (default: all)
-d DUP, --dup DUP Existing article name to duplicate category and tags
(default None)
-r, --recipe Treat this as a recipe. (Othewise generic)
OU
Générer un point de départ d'article avec une image
newshot -h
Sortie
usage: newshot [-h] [-a AUTHOR] [-l {en,fr,es,all}] [-d DUP] [-j] [-r]
articlename
Generate a skeleton article file which has a srcreenshot
positional arguments:
articlename article name without the "-en.rst")
options:
-h, --help show this help message and exit
-a AUTHOR, --author AUTHOR
Author for copyright and for authors (default "Pierre
Bernatchez)"
-l {en,fr,es,all}, --lang {en,fr,es,all}
language of the new article (default: all)
-d DUP, --dup DUP Existing article name to duplicate category and tags
(default None)
-j, --jpg Reference image as a .jpg rather than a .png a
(default: False)
-r, --recipe Treat this as a recipe. (Othewise generic)