Punto de partida de un artículo
Contenido RST de ejemplo para usar como base y modificar para su artículo.
Encabezado principal de su artículo
#############################################
:lang: es
:category: una categoría válida
:date: 2025-10-11 20:03:36+00:00
:tags: artículo, plantilla
:slug: nombre-unico-del-articulo
:authors: Pierre Bernatchez
:summary: Resumen en una línea de su artículo
.. |copy| unicode:: 0xA9 .. signo de copyright
.. |---| unicode:: U+02014 .. guión largo
:trim:
.. footer:: Copyright |copy| 2025 Pierre Bernatchez |---| todos los derechos reservados.
Comience aquí
Modifique el encabezado principal por algo adecuado para su artículo.
Modifique la categoría por una apropiada para su artículo.
Modifique la fecha. Puede usar el comando de línea de comandos "date -u --rfc-3339=seconds" para obtener una cadena de fecha con el formato correcto.
Modifique las etiquetas con palabras clave relevantes para su artículo.
Modifique el slug para que sea el nombre único de su artículo. Lo usamos como base para el nombre del archivo .rst. Por ejemplo, slugname-en.rst, slugname-es.rst, slugname-fr.rst son los 3 nombres de archivo en los diferentes idiomas para el artículo con el slug: slugname.
Modifique authors con su propio nombre.
Modifique el resumen por algo apropiado para su artículo.
Modifique también el nombre en la línea footer por el suyo.
Escriba su artículo usando el marcado RST, comenzando en comience aquí
Tenga en cuenta que hay dos scripts de Python de conveniencia que pueden generar un punto de partida para un nuevo artículo.
Generar un punto de partida de artículo sin imagen
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)
O BIEN
Generar un punto de partida de artículo con una imagen
newshot -h
Salida
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)