Wikipedia (un enfoque alternativo)

Este apartado no propone reemplazar Wikipedia ni su ecosistema. Es un ejercicio de diseño: cómo podría representarse contenido enciclopédico con un formato Human-First y, a la vez, estructurado y validable.

La idea es mostrar un enfoque alternativo para:

• contenido editorial colaborativo,
• con secciones y referencias,
• y con fragmentos que son “datos” (fichas, enlaces, categorías).

Qué necesita una página tipo Wikipedia

Una página enciclopédica suele tener:

• Título y metadatos.
• Resumen inicial (lead).
• Secciones jerárquicas.
• Enlaces internos y externos.
• Referencias (citas).
• Categorías.
• A veces una “ficha” (infobox) con datos estructurados.

STXT permite modelar todo eso como:

• texto libre en bloques >> donde importa la lectura,
• estructura explícita donde importa el árbol,
• y validación opcional si se desea consistencia.

Ejemplo 1 — Página mínima

Una página muy pequeña, con resumen y una sección.

Page (@com.example.wiki):
	Title: STXT
	Lead >>
		STXT (Semantic Text) es un formato textual jerárquico diseñado
		para ser legible por humanos y fiable para máquinas.

	Sections:
		Section:
			Heading: Descripción
			Content >>
				STXT utiliza indentación para definir jerarquía y ofrece
				bloques literales `>>` para texto multilínea.

	Categories:
		Category: Formatos de datos
		Category: Lenguajes de marcado

Ejemplo 2 — Secciones anidadas

En Wikipedia es muy común tener secciones y subsecciones. En STXT eso es un árbol natural.

Page (@com.example.wiki):
	Title: Lenguajes de marcado

	Lead >>
		Un lenguaje de marcado es un sistema para anotar un documento
		de forma que su estructura sea distinguible del contenido.

	Sections:
		Section:
			Heading: Historia
			Content >>
				Los lenguajes de marcado han evolucionado desde sistemas
				para impresión hasta formatos estructurados para la web.

			Subsections:
				Section:
					Heading: SGML
					Content >>
						SGML fue un estándar importante para describir documentos estructurados.

				Section:
					Heading: HTML
					Content >>
						HTML se popularizó con la World Wide Web como formato para hipertexto.

		Section:
			Heading: Usos
			Content >>
				Se utilizan para documentación técnica, publicaciones y contenido web.

Ejemplo 3 — Enlaces internos y externos

En Wikipedia hay enlaces “internos” (a otras páginas) y enlaces externos. En STXT se pueden expresar como nodos explícitos, sin “inventar” sintaxis dentro del texto.

Page (@com.example.wiki):
	Title: STXT

	Lead >>
		STXT se puede comparar con otros formatos como JSON y YAML.

	Links:
		Internal:
			Link:
				Title: JSON
				Page: JSON
			Link:
				Title: YAML
				Page: YAML
		External:
			Link:
				Title: Repositorio de ejemplo
				Url: https://example.com/stxt

	Sections:
		Section:
			Heading: Comparación
			Content >>
				Ver también los formatos relacionados listados en la sección de enlaces.

Ejemplo 4 — Referencias y citas

Un patrón típico en enciclopedias es:

• el texto menciona algo,
• una referencia lo respalda,
• la referencia aparece en una lista.

Una forma clara en STXT es separar:

• referencias como un bloque procesable,
• y “marcas” de cita dentro del texto como algo opcional (por ejemplo [ref: ...]).

Page (@com.example.wiki):
	Title: Indentación

	Lead >>
		La indentación se usa en distintos lenguajes para expresar estructura. [ref: r1]

	Sections:
		Section:
			Heading: Uso en formatos textuales
			Content >>
				Algunos formatos dependen de la indentación para representar jerarquía. [ref: r1]
				Otros la usan sólo como estilo visual.

	References:
		Reference:
			Id: r1
			Title: Indentation style guide (ejemplo)
			Author: Example Org
			Year: 2024
			Url: https://example.com/indentation

Ejemplo 5 — Referencias con “nota” editorial

A veces una referencia necesita contexto: por qué se usa o qué limita. Como es texto humano, encaja bien en un bloque >>.

Page (@com.example.wiki):
	Title: Datos estructurados

	Lead >>
		Las fichas (infobox) ayudan a resumir información clave. [ref: r2]

	References:
		Reference:
			Id: r2
			Title: Structured data overview (ejemplo)
			Url: https://example.com/structured-data
			Note >>
				Referencia usada sólo como ejemplo de cómo adjuntar notas editoriales
				a una fuente. En un sistema real, esto vendría de un catálogo de referencias.

Ejemplo 6 — Categorías y mantenimiento

Wikipedia maneja categorías, plantillas de mantenimiento y “metadatos de comunidad”. En STXT pueden representarse como secciones de metadatos, separadas del contenido principal.

Page (@com.example.wiki):
	Title: Software libre

	Lead >>
		El software libre es software que respeta la libertad de los usuarios.

	Sections:
		Section:
			Heading: Definición
			Content >>
				Suele asociarse a licencias que permiten usar, estudiar, modificar y distribuir.

	Categories:
		Category: Software
		Category: Licencias

	Maintenance:
		Needs citations: true
		Last reviewed: 2025-11-01
		Notes >>
			Marcado para revisión porque faltan referencias en la sección de historia.

Ejemplo 7 — “Ficha” (infobox) como datos reales

Una ficha es básicamente un objeto con campos. En STXT se representa como un subárbol con nombres claros.

Page (@com.example.wiki):
	Title: Tomcat

	Infobox:
		Type: Software
		Name: Apache Tomcat
		Initial release: 1999
		License: Apache License 2.0
		Website: https://tomcat.apache.org
		Written in: Java

	Lead >>
		Apache Tomcat es un contenedor web y servidor HTTP para aplicaciones Java.

	Sections:
		Section:
			Heading: Descripción
			Content >>
				Implementa especificaciones como Servlet y JavaServer Pages (JSP).

Ejemplo 8 — Ficha con listas y valores repetidos

Las fichas reales suelen tener listas (por ejemplo, “autores” o “lenguajes”). Con STXT, las repeticiones son naturales.

Page (@com.example.wiki):
	Title: Python

	Infobox:
		Type: Lenguaje de programación
		Name: Python
		Designed by:
			Person: Guido van Rossum
		First appeared: 1991
		Paradigms:
			Paradigm: Orientado a objetos
			Paradigm: Imperativo
			Paradigm: Funcional
		Typing discipline:
			Item: Dinámico
			Item: Fuerte

	Lead >>
		Python es un lenguaje de programación interpretado, de alto nivel y propósito general.

Ejemplo 9 — Plantillas como “bloques” reutilizables

Wikipedia usa plantillas para reutilizar fragmentos (avisos, cajas, etc.). En STXT, una “plantilla” podría ser un nodo estructurado que el renderizador interpreta.

Page (@com.example.wiki):
	Title: Energía solar

	Lead >>
		La energía solar es la energía obtenida a partir de la radiación del Sol.

	Boxes:
		Box:
			Type: notice
			Title: Artículo en desarrollo
			Content >>
				Este artículo es un ejemplo. La sección de historia está incompleta.

		Box:
			Type: see-also
			Title: Véase también
			Items:
				Item:
					Title: Energía eólica
					Page: Energía eólica
				Item:
					Title: Energía hidroeléctrica
					Page: Energía hidroeléctrica

Ejemplo 10 — Variantes de contenido sin romper el árbol

Un reto típico en wiki es mezclar:

• una tabla,
• un bloque de código,
• y texto normal,

sin que el formato “se pelee” con la estructura. En STXT, la forma directa es usar bloques >> para lo literal.

Page (@com.example.wiki):
	Title: Puertos TCP

	Lead >>
		Los puertos TCP se usan para identificar servicios en una máquina.

	Sections:
		Section:
			Heading: Puertos conocidos
			Content >>
				Tabla simple (texto literal):

				Port | Servicio
				80   | HTTP
				443  | HTTPS
				22   | SSH

		Section:
			Heading: Ejemplo de configuración
			Content >>
				Ejemplo (texto literal):

				Server:
					Port: 8080
					Host: 0.0.0.0

Ejemplo 11 — Artículo con “versionado” editorial

Sin asumir un sistema concreto, se puede incluir metadatos editoriales para auditoría o control de cambios.

Page (@com.example.wiki):
	Title: STXT

	Editorial:
		Status: Draft
		Last updated: 2026-01-11
		Reviewed by:
			Person: Mery Adams
		Change log:
			Entry:
				Date: 2026-01-10
				Summary: Añadido ejemplo de enlaces y referencias
			Entry:
				Date: 2026-01-11
				Summary: Reorganización de secciones y ficha

Ejemplo 12 — Template mínimo para páginas wiki

Si se desea consistencia, se puede validar con un template sencillo. No obliga a la “forma Wikipedia”, sólo define un esqueleto básico.

Template (@stxt.template): com.example.wiki
	Description: Estructura mínima para páginas tipo wiki
	Structure >>
		Page:
			Title: (1)
			Infobox: (?)
			Lead: (1) TEXT

			Sections: (?)
				Section: (*)
					Heading: (1)
					Content: (1) TEXT
					Subsections: (?)
						Section: (*)
							Heading: (1)
							Content: (1) TEXT

			Links: (?)
			References: (?)
				Reference: (*)
					Id: (1)
					Title: (1)
					Url: (?)
					Note: (?) TEXT

			Categories: (?)
				Category: (*)

			Maintenance: (?)
			Editorial: (?)