Seminario: Introducción a la edición ramificada para contenidos académicos y científicos

Fundamentación

Los cambios tecnológicos que se han dado en las últimas décadas junto con la masificación de tecnologías de comunicación y el acceso a ellas han integrado procesos en nuestra vida cotidiana. En el marco del contexto actual, con el aumento de la circulación de las publicaciones digitales, adquirir herramientas para obtener una publicación en diferentes formatos y de manera apropiada para múltiples plataformas se propone como una herramienta indispensable en el mercado editorial actual.

La capacidad de producir contenido que pueda ser distribuido eficientemente en formatos como PDF, ePub y HTML desde una única fuente origen no solo optimiza el flujo de trabajo sino que también asegura consistencia y calidad en todas las salidas. Creemos indispensable tanto la incorporación de herramientas que permitan explorar de manera crítica la tecnología disponible como el desarrollo de flujos de trabajo propios y la constante revisión y actualización en términos de aplicaciones y programas disponibles para la toma de decisiones en relación con una determinada publicación o proyecto editorial.

Este seminario, entonces, se propone como un espacio de formación disciplinar y específica complementario a diferentes propuestas de materias de la carrera en la que se encuentra inserto al mismo tiempo que aporta y actualiza la propuesta académica general. Los participantes serán guiados en el uso de lenguajes de marcado como Markdown y LaTeX, el control de versiones con Git, la utilización de editores de código y la herramienta gbTeXpublisher, con el objetivo final de habilitarlos para manejar de manera eficiente las diversas demandas del entorno editorial contemporáneo.

Además, es importante destacar que todo el software y los lenguajes que se presentarán en el seminario adhieren de diferentes formas a la lógica del código abierto, asegurando a los participantes no tener dependencia de ninguna empresa o software en particular y promoviendo una mayor libertad y flexibilidad en sus proyectos.

Introducción

En el mundo actual de la producción de contenido, la eficiencia y la versatilidad son claves. La edición ramificada permite generar múltiples formatos de salida (PDF, ePub, HTML y muchos otros) a partir de una única fuente origen. Este seminario está diseñado para introducir a los participantes en las herramientas y técnicas necesarias para implementar un flujo de trabajo eficiente en la producción de contenido multipropósito.

Objetivos del seminario

• Comprender los conceptos básicos de la edición ramificada.
• Explorar diversas herramientas de marcado como Markdown y LaTeX.
• Aprender a usar sistemas de control de versiones con Git para gestionar proyectos de documentación.
• Utilizar editores de código abierto como VSCode y TeXstudio para optimizar el proceso de edición.
• Implementar flujos de trabajo que permitan generar salidas en PDF, ePub y HTML desde una única fuente.
• Introducir el uso de Pandoc como herramienta de conversión de documentos.
• Manejar gestores bibliográficos.
• Incorporar metadatos en los documentos para mejorar la organización y búsqueda de la información.

Público objetivo

Este seminario está dirigido a:

• Estudiantes universitarios
• Editores
• Escritores técnicos
• Cualquier persona interesada en la producción de documentos multipropósito

Contenido del seminario

Módulo 1: Introducción a la edición ramificada

• Concepto de edición ramificada
• Ventajas y aplicaciones

Módulo 2: Herramientas de marcado

• Markdown
  • Sintaxis básica
  • Herramientas y plugins
• LaTeX
  • Introducción a LaTeX
  • Estructura de documentos y comandos básicos

Módulo 3: Control de versiones con Git

• GitHub y GitLab
  • Introducción, comandos básicos y flujos de trabajo

Módulo 4: Generación de salidas múltiples

• PDF
  • Herramientas y técnicas
  • Ejemplos prácticos
• ePub
  • Conversión desde formatos de marcado
  • Herramientas útiles
• HTML
  • Generación de sitios estáticos
  • Integración con GitHub Pages
• Múltiples salidas
  • Uso de Pandoc
  • Uso de gbTeXpublisher

Módulo 5: Gestión bibliográfica

• Visión general de las referencias bibliográficas
  • Importancia de la gestión bibliográfica en la producción de documentos.
  • Tipos de referencias, análisis comparativo y su uso en diferentes contextos
  • Integración con Markdown y LaTeX

Módulo 6: Metadatos en la documentación

• Características e importancia de los metadatos
• Cómo añadir metadatos en diferentes formatos de salida, utilizando Markdown y LaTeX

Bibliografía

Sarah Simpkin, «Introducción a Markdown», traducido por Víctor Gayol, Programming Historian en español 1 (2017).

Manual de LaTeX

Metodología

El seminario combinará teoría con prácticas en vivo. Cada módulo incluirá:

• Presentaciones teóricas para explicar los conceptos y herramientas.
• Ejercicios prácticos donde los participantes aplicarán lo aprendido.
• Proyectos finales en los que los participantes desarrollarán un documento que pueda ser exportado a múltiples formatos.

Evaluación y certificación

Al finalizar el seminario, los participantes deberán cumplir con los siguientes requisitos para obtener su certificación:

Participación activa: Los participantes deberán haber mostrado una participación activa en las discusiones dentro del repositorio de Git del seminario, específicamente en los issues designados para debates y consultas. Esta participación incluirá contribuir con ideas, resolver dudas, y colaborar con sus compañeros en la resolución de problemas planteados durante el curso.

Producción de múltiples salidas: Cada participante deberá producir la salida en tres formatos diferentes (PDF, ePub y HTML) de un libro de ejercicios proporcionado durante el seminario. Este proyecto final deberá demostrar el dominio de las herramientas y técnicas aprendidas, asegurando que la fuente origen se transforma correctamente en cada uno de los formatos de salida, manteniendo la coherencia y calidad del contenido.

Conclusión

Este seminario proporcionará a los participantes las habilidades y conocimientos necesarios para implementar una estrategia de edición ramificada en sus proyectos de documentación. Al finalizar, estarán equipados para producir contenido en múltiples formatos de manera eficiente y organizada, utilizando herramientas y lenguajes de código abierto que aseguran independencia y flexibilidad en sus proyectos editoriales.

Además, los participantes habrán demostrado su capacidad para colaborar y resolver problemas en un entorno de control de versiones, produciendo contenido de alta calidad en varios formatos y participando activamente en discusiones técnicas y de contenido. Esta experiencia práctica les permitirá aplicar lo aprendido en sus futuros proyectos editoriales, asegurando que puedan adaptarse a diversas demandas del mercado con confianza y habilidad.