Una introducción rápida al markup de "gemtext"

La manera más común de gestionar contenido textual en Gemini no es solo en texto sin formato como en Gopher, sino utilizando un lenguaje de marcado ligero llamado "Gemtext" (que se gestiona con text/gemini de tipo MIME no oficial). Este documento es una rápida introducción a ese lenguaje de marcado. Tiene algunas similaridades superficiales con Markdown, lo que hará que sea fácil de aprender si conoces MD, pero es muy distinto en otros aspectos.

Una vez que hayas leído este documento, tal vez quieras recordar ocasionalmente refiriendote a:

Hoja de atajos de Gemtext

Texto

El texto en los documentos de Gemtext se escribe usando "líneas largas", es decir, tú o tu editor, no deberían insertar caracteres de una nueva línea cada 80 caracteres aproximadamente. En vez de eso, déjalo en manos del cliente receptor Gemini, para ajustar sus líneas al tamaño de la pantalla del dispositivo y a las preferencias del usuario. De esta manera, el contenido de Gemtext se verá bien y será fácil de leer en monitores de escritorio, pantallas de laptops, tabletas y teléfonos inteligentes.

Ten en cuenta que aunque los clientes de Gemini dividirán líneas de texto que sean más largas que la pantalla del usuario, no unirán líneas que sean más cortas que la pantalla del usuario, como pasaría con Markdown, HTML o LaTeX. Por ejemplo, esto significa que las listas de "puntos" o poemas con líneas deliberadamente cortas se mostrarán de manera correcta, sin que el autor tenga que hacer ningún trabajo extra o que el cliente tenga que ser más inteligente para reconocer y gestionar ese tipo de contenido de forma correcta.

Para la mayoría de la escritura "diaria", este enfoque significa que lo más pobable es que quieras usar solo una línea por párrafo.

Ten en cuenta que los clientes interpretan literalmente las líneas en blanco, es decir, si colocas dos o tres líneas en blanco entre los párrafos, el lector verá dos o tres líneas en blanco.

Enlaces

Al igual que Gopher (y a diferencia de Markdown o HTML), Gemtext únicamente te permite colocar enlaces a otros documentos en una línea aparte. No puedes transformar una sola palabra en medio de una oración en un enlace. Toma un poco de tiempo acostumbrarse a esto, pero significa que los enlaces se pueden encontrar muy fácilmente y los clientes pueden diseñarlos de manera distinta (por ejemplo, para aclarar qué protocolo usan o para mostrar el nombre de dominio para ayudar a los usuarios a decidir si quieren seguirlos o no) sin interferir con la legibilidad de tu contenido textual.

Las líneas de enlace se ven así:

Eso sería:

Empiezan con los dos caracteres =>,

seguidos por un espacio en blanco opcional (espacios o pestañas, tantos como gustes),

seguido por una URL (cualquier protocolo que quieras).

Pueden terminar ahí si quieres, ¡como en el ejemplo de sftp!

O pueden continuarse con al menos un espacio o pestaña,

Y luego una etiqueta amigable con los humanos, que puede ser tan larga como quieras

En el ejemplo anterior todas las URLs y etiquetas se alineaban perfectamente, porque el autor fue pedante. Pero a Gemini no le importa y esto también es aceptable:

Títulos

Gemtext admite tres niveles de títulos. Los títulos están limitados a una sola línea y comienza con uno, dos o tres símbolos de #, seguidos por un espacio obligatorio:

Ésta es la única sintaxis de título admitida. Subrayar sus títulos con los símbolos - o = como en Markdown no hará nada.

Es estrictamente opcional que los clientes hagan algo especial con los títulos. Muchos clientes los reconocerán y usarán una fuente más grande, un color diferente o algún otro tipo de estilo, pero algunos no lo harán y solo los usarán como líneas de texto ordinarias y los imprimirán así. Esto está bien, porque se supone que los títulos no deben de ser usados para controlar la apariencia de tu contenido. En su lugar, proporcionan información semántica importante sobre la estructura del contenido. Algunos clientes usarán títulos para generar automáticamente una tabla de contenido para su usuario, lo que puede ser útil para explorar documentos grandes. El software para generar feeds Atom o RSS puede usar títulos para detectar automáticamente los títulos de las publicaciones para gemlog.

Listas

Gemtext admite listas desordenadas. Cada elemento de una lista se escribe como una sola línea larga, que comienza con un solo símbolo de * seguido de un espacio obligatorio:

Ésta es la única sintáxis de lista admitida. Usar - en lugar de * como en Markdown no hará nada. Las listas anidadas no están admitidas.

Es totalmente opcional que los clientes hagan algo especial con los elementos en la lista y algunos los verán como otra línea de texto más. La única razón por la que están definidos es para que los clientes más avanzados puedan reemplazar el * con una viñeta más estilizada, por lo tanto, cuando los elementos de la lista (que son demasiado largos para entrar en la pantalla del dispositivo) se dividen en varias líneas, las líneas después de la primera pueden ser desplazadas del margen por el mismo espacio que tiene el símbolo de viñeta. No es nada más que un detalle tipográfico.

Citas en bloque

Gemtext admite citas en bloque. El contenido citado está escrito como una sola línea larga, que empieza con un carácter de >:

Es totalmente opcional que los clientes hagan algo en especial con las citas en bloque y algunos clientes las verán como cualquier otra línea de texto. En cuanto a los elementos de una lista, están definidos solo para permitir una tipografía más agradable en clientes ambiciosos.

Texto preformateado

Gemtext está minuciosamente diseñado para ser muy fácil de analizar y renderizar. Los clientes de Gemini procesan Gemtext una línea a la vez, renderizando cada línea independientemente de las anteriores o posteriores, simplemente observando los primeros caracteres de una línea para buscar algo como =>, #, *, etc.

Una línea que comienza con ``` (es decir, con tres comillas inversas) le dice al cliente que alterne entre el modo de análisis ordinario y el"modo preformateado". En el modo preformateado, los clientes no rectifican si una línea es un enlace, un título u otra cosa. Sencillamente se imprimen como están. Además, mientras que los clientes pueden usar fuentes de varios tamaños para el resto del texto, en el modo preformateado los clientes deben usar una fuente con un tamaño fijo. De esta manera, un par de líneas ``` actúan similarmente a las etiquetas <pre> y </pre> en HTML.

El texto preformateado se puede usar para incluir arte ASCII, código fuente o contenido similar en un documento de Gemtext, sin que los clientes malinterpreten las líneas como títulos, elementos de una lista, etc. También se puede utilizar para escribir documentos como este, que explican la sintaxis de Gemtext con ejemplos - puedes ver los ejemplos de sintaxis más arriba sin que el cliente los interprete como lo haría normalmente porque se ejecutan en modo preformateado.

Todo lo que venga después de los caracteres ``` en una línea que alterna la línea preformateada *en* (es decir, la primera, tercera, quinta, etc., alternando líneas en un documento) puede tratarse como "texto alternativo" para el contenido preformateado. Generalmente no deberías de confiar en que este contenido sea visible para el usuario, pero, por ejemplo, los motores de búsqueda pueden clasificarlo y los lectores de pantalla pueden leerlo a los usuarios para ayudarlo a decidir si el contenido preformateado debe leerse en voz alta (por ejemplo, ASCII art generalmente no debería de leerse, pero el código fuente quizás sí). Actualmente no existe un acuerdo establecido sobre cómo se debería de formatear el texto alternativo.