Desde hace un tiempo estamos publicando una pequeña revista online en Hipatia llamada Ágora. Desde Hipatia puedes colaborar con esta revista publicando cualquier contenido a través del comando zine. Todos tus artículos deben estar guardados bajo el directorio ~/pub/blog/.
Estos artículos no son publicados en el momento en que los termines de escribir sino que pasan por un proceso de revisión por parte de un editor que aceptará o rechazará el artículo si su contenido no es apropiado. Esto puede hacer que su publicación se demore unos días. Por tanto debes tener paciencia. Si el artículo es adecuado será publicado sin problemas.
El comando para crear un artículo nuevo es sencillo. Situate en tu directorio personal y ejecuta el comando zine new.
$ zine new
Se ha creado el fichero 20221011.md. Usa nano u otro editor para escribirlo
Ejecuta: nano /home/sdemingo/pub/blog/20221011.md
Como puedes ver, un nuevo fichero cuyo nombre es la fecha de publicación al revés se ha creado en el directorio bajo el directorio pub que es un directorio público donde todos podemos compartir información con los demás. Bajo este directorio, todos tus artículos se organizan en el subdirectorio blog/. Por lo tanto, para encontrar la ruta donde poder ver todos tus artículos solo has de ir a este directorio usando el siguiente comando y cambiando sdemingo por tu nombre de usuario:
$ cd /home/sdemingo/pub/blogEn este directorio econtrarás tus artículos en ficheros cuyo nombre es la fecha en la que los creaste pero al revés. Abre el fichero de tu artículo recién creado con nano o con cualquier otro editor y puedes empezar a crear tu artículo.
Para escribir el artículo no debes preocuparte de nada más que del propio texto. Aún así, puedes utilizar ciertos caracteres para marcar formato del texto. Estos caracteres forma parte del lenguaje de marcado Markdown. Utiliza estas marcas ligeras dentro de tu contenido para indicar como quieres visualizar parte de tu artículo. Por ejemplo, si quieres utilizar una lista, poner un encabezado, usar un tipo de fuente en negrita, etc.
Además, si has abierto el artículo con nano verás que en su primera línea aparece la palabra @+BORRADOR. No quites esta marca mientras escribes tu artículo. Esta marca evita que el moderador de la revista lo considere acabado y listo para la publicación. Tras terminar de redactarlo y estar seguro que lo tienes ya listo y corregido, borra esta marca de la primera línea y entrará en la cola de artículos listos para ser moderados y publicados.
Incluir imágenes usando Markdown es muy sencillo. Únicamente debes enlazar la imagen poniendo en una línea aparte en el lugar del documento en el que quieres escribir la siguiente marca:
Sutituyendo lo que va entre paréntesis con la URL de la imagen que quieres enlazar. De esta forma, la imagen que has incluido debe estar ya compartida en algúna URL de Internet. Este es el método más sencillo de vincular imágenes a tu artículo.
Si quieres compartir imágenes que no estén ya publicadas y sean originales tendrás que guardarlas en tu cuenta. Para ello es necesario que las alojes junto con tu artículo. Debes asegurate de tener creado el directorio img bajo el directorio donde guardas tus artículos en ~/pub/blog. Ejecuta:
$ ls ~/pub/blogSi aparece un directorio llamado img en el listado ya lo tienes creado de una vez anterior. En caso contrario deberás crearlo ejecutando:
$ mkdir ~/pub/blog/imgUna vez creado el directorio, deja allí la imagen que quieres publicar junto con tu artículo. Puedes subirla desde tu casa u equipo local usando el tutorial donde explicamos como hacerlo. Cuando tengas tu imágen subida puedes enlazarla a tu artículo usando una línea de Markdown como se indica a continuación.
Es importante que tu imagen tenga como prefijo img/ para que quede bien vinculada. Recuerda que no puedes subir imágenes de gran tamaño. El límite actual para cada imagen alojada en Hipatia des de 500 Kilobytes.
Para conocer si tu artículo ha sido publicado o rechazado por algún motivo puedes ejecutar periódicamente el comando:
zine logEste comando te mostrará la lista de artículos que tienes, tanto publicados como rechazados. En este segundo caso además se te mostrarán los motivos del rechazo.
Además, aunque tu artículo haya sido aceptado puedes realizar en cualquier momento una modificación de su texto para actualizar su contenido. Esta modificación debe ser de nuevo aprobada por el moderador y puede tardar un tiempo en ser publicada.
Si tu artículo ha sido rechazado, deberás realizar las modificaciones indicadas por el moderador. Ponte en contacto con el si tienes alguna duda sobre los motivos del rechazo. Una vez termines las modificaciones, tus cambios serán de nuevo revisados por el moderador para poder ser publicados.
Este obra está bajo una licencia de Creative Commons Reconocimiento-NoComercial-CompartirIgual 4.0 Internacional.