Publicaciones y contenidos editoriales

Los sistemas editoriales viven en una tensión constante entre:

• contenido rico y narrativo (texto largo, secciones, contexto),
• estructura (capítulos, metadatos, relaciones),
• y datos (estado, fechas, autores, etiquetas).

Qué entendemos por “publicaciones”

En este contexto, “publicación” incluye:

• Artículos y posts largos.
• Libros y capítulos.
• Documentación técnica.
• Informes públicos.
• Whitepapers.
• Blogs corporativos o técnicos.

Problemas habituales en flujos editoriales

En la práctica aparecen patrones repetidos:

• Markdown:

  • Flexible, pero pobre en semántica.
  • Metadatos ad-hoc (front-matter YAML).
  • Difícil de validar estructura.

• CMS tradicionales:

  • Modelos rígidos.
  • Edición acoplada a una herramienta concreta.
  • Difícil versionado en Git.

• XML editorial:

  • Muy potente.
  • Demasiado verboso para edición manual.

STXT propone otra vía:

• Un único formato para texto, estructura y datos.
• Separación clara entre contenido y reglas.
• Edición con cualquier editor de texto.

Ejemplo 1 — Artículo técnico

Artículo con metadatos, secciones y texto largo.

Article (@com.acme.editorial.article):
	Title: Introducción a STXT
	Slug: introduccion-a-stxt
	Authors:
		Author:
			Name: Joan Costa
			Role: Editor
	Published date: 2026-01-10
	Status: Draft
	Tags:
		Tag: stxt
		Tag: formatos
		Tag: documentacion

	Abstract >>
		STXT es un lenguaje textual diseñado para equilibrar
		legibilidad humana y fiabilidad para máquinas.

	Content >>
		## ¿Por qué otro formato?

		La mayoría de formatos existentes fuerzan una elección:
		o son cómodos para humanos o son fiables para máquinas.

		STXT intenta eliminar esta dicotomía.

		## Principios

		- Human First
		- Sintaxis mínima
		- Validación opcional
		- Seguridad por diseño

Observaciones del ejemplo

• El texto largo vive en bloques >>.
• La estructura editorial (título, autores, estado) es explícita.
• El contenido puede contener Markdown sin interferir con STXT.

Ejemplo 2 — Publicación multi-sección

Libro o documento largo dividido en secciones.

Publication (@com.acme.editorial.publication):
	Title: STXT — El libro
	ISBN: 978-1-23456-789-0
	Language: es
	Status: In Progress

	Chapters:
		Chapter:
			Number: 1
			Title: Introducción
			Content >>
				Este capítulo introduce los conceptos básicos de STXT.

		Chapter:
			Number: 2
			Title: Sintaxis
			Content >>
				En este capítulo se describe la sintaxis del lenguaje
				con ejemplos prácticos.

		Chapter:
			Number: 3
			Title: Validación
			Content >>
				Templates y Schemas permiten añadir reglas semánticas.

Flujo editorial típico con STXT

Un flujo habitual puede ser:

1. El autor escribe el documento STXT.
2. Se versiona en Git.
3. Un template valida estructura mínima.
4. Se transforma a HTML, PDF u otros formatos.
5. Se publica.

Cada paso es independiente y sustituible.

Validación con @stxt.template

Un template editorial asegura coherencia sin imponer rigidez.

Template (@stxt.template): com.acme.editorial.article
	Description: Artículo editorial estándar
	Structure >>
		Article:
			Title: (1)
			Slug: (1)
			Authors: (1)
				Author: (+)
					Name: (1)
					Role: (?)
			Published date: (?) DATE
			Status: (1) ENUM [Draft, Review, Published]
			Tags: (?)
				Tag: (+)

			Abstract: (?) TEXT
			Content: (1) TEXT

Este template:

• Garantiza metadatos mínimos.
• Controla el estado editorial.
• Permite texto libre sin restricciones artificiales.

Separación contenido / presentación

Con STXT:

• El documento no conoce HTML, CSS ni layout.
• La presentación se decide en una fase posterior.
• El mismo contenido puede renderizarse de múltiples formas.

Ejemplos:

• Web
• PDF
• EPUB
• Documentación interna

Ventajas prácticas

• Autoría cómoda: escribir sin pelearse con etiquetas.
• Diffs limpios: cambios textuales claros en control de versiones.
• Validación ligera: evita artículos incompletos.
• Automatización: índices, tablas de contenidos, feeds.
• Longevidad: el contenido sobrevive a herramientas concretas.

Recomendaciones editoriales

• Usa TEXT para cuerpo y secciones largas.
• Mantén metadatos concisos y estables.
• Evita acoplar contenido a formatos de salida.
• Usa templates para guiar, no para limitar.

Resumen

STXT es especialmente adecuado para publicación editorial:

• El texto sigue siendo texto.
• La estructura es explícita.
• La validación es opcional.
• El contenido puede evolucionar sin cambiar de formato.