Introducción a la Documática, 1. Teoría.
Versión etiquetada en MarkDown y publicada en Read The Docs. Repositorio en GitHub.
El proyecto.
Introducción a la Documática, 1. Teoría. surgió como un proyecto personal a medidados de la década de 1990. En aquellos momentos, tan dinámicos en el mundo de la información y la documentación, no existía un manual que agrupase los conocimientos básicos de herramientas informáticas que debían adquirir los estudiantes de las diplomaturas y licenciaturas en Biblioteconomía y Documentación y en Documentación, respectivamente.
Así que puse manos a la obra, y su resultado fue una monografía, publicada por Kronos en Zaragoza en septiembre de 1997, de circulación limitada, que transformé en una versión web en 2002. Esta versión se retiró en 2010, y fue sustituida por una reedición en documento PDF, que puede obtenerse en el repositorio E-LIS. A pesar de publicarse bajo licencia GNU Free Documentation License, nadie tuvo las ganas, el empeño o los recursos para actualizar o ampliar su contenido.
El lector o lectora que vivió aquellos frenéticos años encontrará capítulos históricos (¿Quién recuerda a los host ECHO o Dialog?), figuras que recuperan, por ejemplo, el añorado navegador Netscape, o las aventuras y desventuras de Ibermarc y sus compañeros. Algunos capítulos están completamente superados; otros siguen siendo válidos en la actualidad.
El cambio a documentación técnica.
Se acostumbra a seguir un proceso muy tradicional para elaborar manuales, pero lo cierto es que los procesos de edición basados en autoedición con un procesador de texto no son eficientes en la actualidad. Las técnicas de escritura de documentos técnicos hacen posible simplificar los procesos de composición, y obtener productos de salida en diferentes formatos y plataformas de manera más simple y eficiente.
Ésta ha sido la aproximación seguida en este producto. Los documentos originales se han transformado con Pandoc en documentos de texto etiquetado en MarkDown, un lenguaje de etiquetado ligero, se han depositado en una plataforma Git, en este caso GitHub, y a partir de los documentos fuente se ha generado todo el conjunto de páginas web estáticas, usando el procesador MkDocs de Read The Docs. Un proceso que consume unos segundos.
La referencia bibliográfica.
Tramullas, Jesús (2020). Introducción a la Documática, 1. Teoría. Read The Docs. https://documatica.readthedocs.io