Páginas y nodos

La forma sigue al peso, y el peso cambia

Un nodo es para lo que lleva una afirmación y su argumento; un elemento de lista, para lo que lleva una línea; una celda, para lo que lleva una palabra. Una tabla sirve para comparar valores a lo largo de sus filas, así que un conjunto de entidades va en nodos y no en sus filas. El peso cambia a medida que un tema crece y mengua, y por eso las cosas cruzan esas fronteras en ambos sentidos: una viñeta que ha ido creciendo hasta ocupar varios párrafos pasa a ser un nodo, una lista que ya desborda el nombre que la encabeza pasa a ser secciones, y varios nodos con una sola frase cada uno pasan a ser una lista.

Una afirmación escondida dentro de un cuerpo no tiene dirección y nunca llega al esquema. Se esconde en un arranque en negrita, en una viñeta que se alarga varios párrafos, en una fila de una tabla de catálogo o en una segunda afirmación dentro del mismo bloque; un encabezado ## escrito dentro de un cuerpo es lo mismo. También se esconde en el texto corrido, sin marca alguna: una página de secciones bien nombradas, sin hijos bajo ninguna de ellas, guarda dentro de los cuerpos todas las afirmaciones que hace, y quien recorre su esquema no se entera de ninguna. El caso inverso es un encabezado sobre una sola frase, que gasta una fila del esquema y una pantalla de espacio en blanco en lo que ya decía una viñeta.

Ambos fallos se ven desde fuera. En una página bien formada, cada afirmación que hace un cuerpo tiene su fila en el esquema. Y un cuerpo que, con el título tapado, se lee como una nota al pie de su propio encabezado es un elemento de lista.

El título lleva exactamente lo que contiene el cuerpo

En el nivel h2, el título nombra una sección con un sintagma nominal de pocas palabras: el nivel superior se lee como un índice, y una frase ahí compite con el título de la propia página. Más abajo, el título enuncia la afirmación y el cuerpo la argumenta, y eso es lo que permite a un lector tomar la afirmación directamente del esquema y abrir el cuerpo solo para el argumento. Un nodo que agrupa hijos nombra una sección a cualquier profundidad.

Las secciones dan forma a las afirmaciones. Sin ellas, una página es una ristra de enunciados h2, como los que deja una sola pasada de escritura, y no se encuentra nada en ella sin leerla entera.

Qué merece una página

Un tema es una página cuando un lector llegaría a él directamente, y un bloque cuando no significa nada separado de su nodo padre. La misma prueba divide un tema que ha crecido: pasado un par de docenas de filas del esquema, o unas pocas pantallas de cuerpo, una página se recorre a saltos en lugar de leerse y su sumario deja de ser un mapa, así que una sección que puede abrirse sin haber leído lo anterior es una página propia, y las secciones que solo tienen sentido en secuencia se mantienen, en cambio, breves.

Una página de ejemplo

Solo los títulos, que es como un lector se encuentra una página:

Normas de visado
  Quién lo necesita
    Los ciudadanos de la UE no
    Una escala en tránsito cuenta como entrada
  Solicitud
    El formulario solo se presenta en línea
    Las tasas se pagan en el consulado

Los dos h2 nombran las secciones. Las cuatro afirmaciones que tienen debajo son lo que contiene la página, así que un lector toma una afirmación del esquema y abre un cuerpo solo para el argumento. Bajo el tercer título, el cuerpo la argumenta y no dice nada que ya dijera el título:

Las autoridades de inmigración consideran entrada un transbordo en zona de tránsito, así que un viajero que cambia de avión necesita el mismo visado que uno que sale del aeropuerto. La aerolínea lo exige al facturar, que es donde suele descubrirse que falta el visado.

Una página con subpáginas las recomienda en vez de enumerarlas

La página de inicio y toda página con subpáginas abren con lo que vale la pena leer debajo y enlazan unas pocas páginas que los lectores buscan, aunque estén a mucha profundidad: unos pocos enlaces destacados, no una copia del árbol, que el lector ya tiene junto al texto. Una lista de todas las subpáginas solo tiene sentido donde el lector debe elegir entre todas ellas, como con las formas de instalación. Una página así tiene secciones propias y no solo una entradilla: sin ellas no tiene sumario y parece inacabada.

Un cuerpo que repite lo que registra el motor se desactualiza

Cada nodo lleva su propio historial, su propio updated_at, su lugar en el sumario y la lista de nodos que lo enlazan. Un cuerpo que repita cualquiera de esas cosas se desactualiza en cuanto alguien edita la página o su estructura sin actualizar esa frase, y a partir de ahí informa mal.

Por eso un cuerpo sano no contiene nada de eso: ningún bloque que documente su propia obsolescencia, porque el historial guarda lo que sustituyó; ningún sello de “comprobado en abril”, porque se desactualiza solo y no dice nada fiable sobre si el contenido está al día; ningún texto que enumere las secciones de abajo, porque el sumario ya las enumera; ningún pie de “volver a X”, porque los enlaces entrantes ya están en la página. Lo que decide es de dónde saca una frase su verdad. Si la saca del árbol de esta página, se va, porque el lector ve ese árbol y el árbol cambia sin consultar a la frase. Si la saca del tema, se queda, aunque su número coincida hoy con el árbol: el año de fundación es contenido, la fecha de revisión es metadato, y las tres leyes de la robótica siguen siendo tres haga lo que haga esta wiki.

Cómo llega una referencia a un nodo

Una referencia corta, page:N o block:N, apunta al nodo y no a las palabras de su encabezado. Una referencia a un bloque nombra una afirmación; una referencia a una página nombra un tema. No cruza el límite de una wiki: a otra wiki se llega por su URL y se comporta como un enlace externo, porque una referencia que cruzara se resolvería en wikis que el lector no puede abrir.