Ir al contenido
Chronus Tabula

Mejora el mapa.

Cada país, guerra o acontecimiento es un pequeño fichero con su fuente. Corrígelo o amplíalo; no hace falta programar.

Avisar de un error Guía completa

Tres formas de ayudar.

Elige según el tiempo que tengas. Todas cuentan.

5 minutos

Avisar de un error

¿Una fecha de reinado mal, una frontera que no cuadra, una batalla en el sitio equivocado? Cuenta qué has visto y en qué año; una plantilla te guía.

Abrir un aviso
En local, con el asistente

Aportar datos

Añade o corrige gobernantes, población, batallas, acontecimientos o territorios, siempre con su fuente. Se edita en tu copia del proyecto y llega por pull request. Es donde más ayuda hace falta.

Ver ejemplos con el asistente
Con Git

Código y diseño

JavaScript sin dependencias ni compilación, y un pequeño servidor en Python estándar. Mejoras de interfaz, accesibilidad o rendimiento son bienvenidas.

Ver el repositorio

Edita sin tocar el JSON.

El panel de administración incluye un asistente que convierte cada ficha en un formulario. Te avisa de los errores antes de guardar y escribe el fichero con el formato correcto.

Solo funciona en tu equipo. La web publicada no tiene panel ni guarda cambios: descarga el proyecto, edita las fichas en local con el asistente y propón los cambios con un pull request en GitHub. Se publican cuando alguien del proyecto los revisa y los fusiona.

  1. Descarga el proyecto

    Haz un fork del repositorio y clónalo en tu equipo. Solo necesitas Python.

  2. Arranca el panel

    En la carpeta del proyecto, python api/servidor.py. Abre http://localhost:9000/admin.html#editor; la primera vez crearás un usuario y una contraseña locales.

  3. Edita y guarda

    Escoge Países, Conflictos, Eventos o Territorios, busca la ficha o pulsa + Nuevo. Revisar cambios muestra los errores y las líneas que cambiarán; Guardar en datos/ escribe el fichero en tu copia y el mapa local lo muestra al recargar.

  4. Propón el cambio

    Haz commit de los ficheros de datos/, súbelos a tu fork y abre un pull request contando qué cambias y de dónde sale. Hasta entonces, el cambio solo existe en tu equipo.

Tres ejemplos

Corregir un dato

La fecha de un reinado

Felipe II aparece en España de 1556 a 1598. Si una fecha estuviera mal:

  1. Países, busca españa y ábrela.
  2. Despliega Gobernantes, localiza la fila de Felipe II y cambia Hasta.
  3. En Fuentes, + Añadir y escribe en Identificador de dónde sale el dato, por ejemplo wikipedia-es:Felipe II de España.
  4. Revisar cambios: el diff marca solo esa línea y la fuente nueva. Guarda.

Si escribes un año de fin anterior al de inicio, el asistente no deja guardar y te dice por qué: «'desde' (1556) es posterior a 'hasta' (1550)».

Añadir un acontecimiento

La Universidad de Salamanca, 1218

  1. Eventos → + Nuevo evento.
  2. Nombre: Fundación de la Universidad de Salamanca; Año: 1218.
  3. En Coordenadas, Elegir en el mapa y pincha sobre Salamanca (≈ 40,96, −5,66).
  4. Países: Reino de León; una Descripción de una frase y el Artículo de Wikipedia: Universidad de Salamanca.
  5. Fuentes → + Añadir: Identificador wikipedia-es:Universidad de Salamanca y Licencia CC BY-SA.

Al guardar se crea datos/eventos/1218-fundacion-de-la-universidad-de-salamanca.json y aparece como ⭐ en el mapa de 1218.

Ampliar un conflicto

Una batalla que falta

La Guerra de los Treinta Años aún no tiene la batalla de la Montaña Blanca (1620).

  1. Conflictos, busca treinta y ábrelo.
  2. Despliega Batallas → + Añadir.
  3. Nombre: Batalla de la Montaña Blanca; Año: 1620; coordenadas junto a Praga (≈ 50,08, 14,32) con Elegir en el mapa.
  4. Añade su fuente en Fuentes del conflicto y revisa.

No te preocupes por el orden: al guardar, las batallas se ordenan por año.

En países, Vínculos con otras fichas relaciona reinos entre sí (predecesor, sucesor, parte de, incluye, antecesor territorial): eliges la otra ficha de una lista y el vínculo inverso se escribe solo en ella. Así, al seguir España en el mapa se resaltan también Castilla, Aragón o Navarra en su época.

Antes del pull request, git diff te enseña exactamente qué ha escrito el asistente. Si otra persona ha cambiado la misma ficha mientras la editabas, el asistente no la sobrescribe y te pide recargarla. En países y conflictos el Identificador no se cambia desde aquí, y los polígonos de las zonas se editan como texto.

Un fichero por entidad.

Todo el conocimiento del mapa vive en datos/. Cada cambio toca solo su fichero, el diff se lee de un vistazo y dos personas no chocan aunque trabajen a la vez.

datos/
  paises/<id>.json               espana.json, rd-congo.json, sacroimperio.json…
  conflictos/<id>.json           guerra-de-los-cien-anos.json…
  eventos/<año>-<nombre>.json    1492-descubrimiento-de-america.json, 480ac-batalla-de-salamina.json…
  territorios/<nombre>.json      gibraltar.json, ceuta.json…
schema/                          el contrato de cada tipo de ficha (JSON Schema)

Países

Nombre, nombres en los mapas y por época, gobernantes con fechas, población, escudos y banderas, reseña, fuentes y marca de revisión.

Conflictos

Guerras con inicio, fin y bandos; zonas de frente u ocupadas por fases, y sus batallas con coordenadas y año.

Eventos

Acontecimientos e inventos con año, lugar y descripción breve. El fichero empieza por el año: 480ac-… para el 480 a. C.

Territorios

Enclaves e islas que no se ven a escala mundial, con el país del que heredan el color y desde cuándo.

Los años negativos son a. C., las coordenadas son siempre [latitud, longitud] y casi todos los campos son opcionales. Las fronteras son ficheros GeoJSON aparte, de historical-basemaps.

Aportar datos, paso a paso.

El resumen; la guía completa detalla cada campo con ejemplos.

  1. Haz un fork y clona el repositorio

    Solo necesitas Python para servirlo en tu equipo.

  2. Arranca la app

    python api/servidor.py abre el mapa en http://localhost:9000/ y el panel en /admin.html.

  3. Edita la ficha

    Con el asistente del panel, que valida y guarda por ti, o con cualquier editor de texto en datos/.

  4. Formatea y valida

    python api/formatear.py y python api/validar.py. Si ambos están en verde, la integración continua también lo estará.

  5. Abre un pull request

    Comprueba en el mapa los años que tocan tus datos y cuenta qué añades y de dónde sale. Al fusionarse, se publica solo.

Las herramientas, en detalle

  • Panel de administración

    Asistente de edición de fichas y conectores con Wikidata, Wikipedia y Our World in Data que dejan propuestas para revisar. Solo funciona en tu equipo.

  • formatear.py

    Formato canónico: claves en orden fijo, listas por año, tabuladores. Los diffs solo muestran cambios reales.

  • validar.py

    Esquema, años, coordenadas, nombres en los mapas, referencias y marcas de revisión. Cada aviso indica fichero y campo.

  • compilar.py y dividir.py

    Juntan datos/ en el historia.json que descarga la web, y al revés. Normalmente los lanzan el servidor y el despliegue.

  • Despliegue

    En cada push a main, GitHub Actions formatea, valida y, si todo pasa, publica la web.

Reglas de oro.

Todo con fuente

Cada dato cita de dónde sale en fuentes: Wikipedia, Wikidata, un libro, un censo. Sin fuente no se acepta.

Hechos, no textos ajenos

Nombres, fechas y cifras, nunca párrafos copiados. Los textos que se guardan van atribuidos y con su licencia.

Español primero

Nombres y textos en español; la interfaz también existe en inglés.

Validador en verde

Antes de proponer un cambio, el formateador y el validador deben pasar sin errores.

¿Te animas?

Ir al repositorio Volver al mapa