gemtext

Qué es

Gemtext es el formato documental del protocolo Gemini: texto UTF-8
sencillo donde los primeros caracteres de cada línea deciden su
tipo. Así, un cliente puede renderizar toda una página en una pasada
de arriba abajo. La especificación lo llama formato de hipertexto
Gemini, los servidores lo etiquetan como `text/gemini` y los
archivos suelen terminar en `.gmi`.

Hay seis tipos de línea. Una que empieza por `=>` es un enlace:
dirección absoluta o relativa y una etiqueta opcional después. Una
línea de tres acentos graves activa o desactiva el modo
preformateado; todo lo que queda entre dos de esas líneas se muestra
tal cual en una fuente de ancho fijo. Uno, dos o tres signos de
almohadilla forman un encabezado; un asterisco seguido de espacio,
un elemento de lista; un signo mayor que, una cita. Las demás líneas
son texto ordinario y el cliente las ajusta al ancho de la pantalla
que las muestre.

```text
i# Notas de campo		engineer.company	70

Una línea de texto es un párrafo, sea larga o corta. El cliente la ajusta.

i=> /archive/ Notas anteriores		engineer.company	70
i=> gemini://example.org/ Otra cápsula		engineer.company	70

i* Un elemento de lista		engineer.company	70
> Una línea citada
```

La especificación divide esos seis tipos en tres básicos que todo
cliente debe admitir, texto, enlaces y conmutador de preformato, y
tres que un cliente mínimo puede mostrar como texto sencillo. Ese es
todo el formato. No hay negrita, cursiva, tablas, imágenes dentro
del texto, anidamiento ni forma de hacer pulsable una palabra en
mitad de una frase. El analizador conserva un solo bit de estado: si
está dentro de un bloque preformateado.

Se suele comparar gemtext con Markdown, al que se parece a primera
vista. La diferencia es para qué sirve cada uno. Markdown es código
fuente que se convertirá a otra cosa; gemtext ya es el documento
terminado y su único renderizador es el cliente del lector. El único
hábito estructural que toma de los antiguos menús Gopher es colocar
cada enlace en una línea propia.

Por qué importa

Elegir gemtext es elegir quién controla la página. El autor decide
la estructura: qué líneas son encabezados, cuáles enlaces y dónde
está el código. El cliente decide todo lo demás: fuente, longitud de
línea, color, espaciado y si los encabezados forman un índice de
contenidos. La especificación dice claramente que no pretende dar al
autor un control preciso de la presentación. Para algunos es un
alivio; para otros descarta la opción. Conviene saberlo antes de
convertir una sola página.

El alivio está en lo que desaparece. Una página gemtext no lleva
hoja de estilo, script, fuente web, aviso de cookies ni píxel de
seguimiento; solo hay que actualizar las palabras. Las páginas son
pequeñas y rápidas de escribir a mano. Los enlaces no obtienen nada
por sí solos: la especificación prohíbe al cliente abrir una
conexión de red solo para mostrar uno. La página no puede traer una
imagen o fuente de terceros a espaldas del lector.

El coste es igual de concreto. Solo llega a quienes usan un cliente
Gemini, una audiencia pequeña frente a la web. No hay formularios:
una cápsula solo pide entrada mediante un código de estado del
protocolo, no mediante algo dentro del documento. La prosa debe
funcionar sin enlaces dentro de las frases. Una frase HTML como
«consulte la página de precios para más detalles» conserva las
palabras, pero pierde el enlace. Escribir bien gemtext exige frases
que sigan teniendo sentido con el enlace en la línea de debajo.

Por eso, para la mayoría de las organizaciones, la pregunta realista
es añadir gemtext al sitio web, no sustituirlo, a partir de la misma
fuente y la misma compilación. Así planteado, cuesta poco y también
pone a prueba la escritura. Si la página sigue leyéndose claramente
como columna de líneas de texto y enlaces, su estructura ya estaba
en las palabras.

Cómo se aplica en la práctica

Este sitio publica gemtext junto a HTML. Engineer en una terminal da
la dirección `gemini://engineer.company/`, dice que cada página
existe también en ese formato y enumera clientes: Amfora, Lagrange y
Bombadillo en terminal; Castor y Kristall en ventana. También
explica por qué. Un despliegue escribe una carpeta que leen todas
las puertas de entrada: la copia gemtext no puede desincronizarse
del HTML. Si una página se lee bien como gemtext, su estructura es
real y no una apariencia pintada.

La explicación de cómo se replicó el sitio en Gemini y Gopher
describe la construcción. Gemtext es otro formato de salida de la
misma compilación, no otra cadena de herramientas. Se añadieron
tipos de medios y formatos de salida propios al generador; cada
página, sección y término de taxonomía recibió un documento Gemini
junto a su HTML y su gemelo Markdown. Eran 777 en la etapa de
implementación documentada, servidos por un pequeño demonio en el
mismo host. Los formatos nuevos se marcan como representaciones no
alternativas. Una comparación de compilaciones separada midió cero
bytes HTML cambiados al añadirlos; no midió posteriores cambios
editoriales o visuales.

Las plantillas muestran qué implica la conversión. Se saca cada
enlace de su frase: las palabras quedan donde hacen falta y la
dirección baja a una línea `=>` propia. Se eliminan las marcas de
negrita, los guiones de lista pasan a asteriscos y un bloque de
código delimitado se conserva intacto: la delimitación Markdown y el
conmutador de preformato gemtext son los mismos tres acentos graves.

Dónde surgen los problemas

Líneas partidas que nunca se unen

La prosa llega como columna irregular de líneas cortas, partidas a
mitad de una oración. El original se dividió a 80 columnas, como
suele hacerse en Markdown, y la especificación prohíbe al cliente
unir líneas cortas consecutivas en otras largas. Escriba cada
párrafo en una sola línea o haga que el conversor una los saltos de
línea introducidos solo para ajustar el texto antes de escribir el
archivo.

Enlaces que salen de la cápsula

El primer enlace abre un navegador web. El conversor escribió todos
como direcciones `https://` absolutas y el cliente Gemini las
entrega a otro programa. Escriba la navegación con rutas relativas a
la raíz como `/about/`, que se resuelven dentro de la cápsula, y
mantenga un enlace deliberado por página a su versión web.

Código que se convierte en una sola línea

Un ejemplo de código aparece como línea larga pegada al delimitador
inicial. El conversor trató el bloque como prosa y unió sus líneas
con las demás. Divida el documento por sus delimitadores antes de
cualquier otro paso, conserve cada bloque preformateado tal cual y
limite el texto alternativo de la línea de conmutación a algo breve,
como el nombre del lenguaje.

Markdown que aparece como caracteres literales

Guiones de lista, asteriscos dobles, encabezados subrayados, listas
anidadas y enlaces entre corchetes aparecen tal cual. Gemtext solo
reconoce asterisco y espacio para una lista y almohadillas para un
encabezado; no tiene marcado dentro de las frases. Convierta esas
construcciones al generar la salida o escriba directamente en
gemtext.

Frases que no señalan ningún destino

Un párrafo dice «pulse aquí» o «como se enlaza arriba» y el lector
no sabe adónde ir. El enlace salió de la frase y las palabras
restantes nunca decían adónde llevaba. Escriba etiquetas que nombren
su destino: así, tanto la frase como la línea `=>` tienen sentido
por separado.

Lecturas adicionales

  * Introducción breve al marcado gemtext — Recorrido del proyecto
por todos los tipos de línea, con notas para quienes conocen
Markdown.

  * Especificación del formato de hipertexto Gemini — Texto
normativo: tipos de línea, estado del analizador, reglas de ajuste,
parámetro `lang` y gramática formal.

  * Especificación del protocolo de red Gemini — Cómo sirve gemtext
una cápsula: solicitudes, códigos de estado y reglas TLS del
cliente.

  * Preguntas frecuentes del proyecto Gemini — Razones del diseño,
entre ellas por qué los enlaces ocupan líneas propias.

hEsta página en la web	URL:https://engineer.company/es/glossary/gemtext/	engineer.company	70
