Tengo que producir bastantes documentos (quizás unos 16). Los documentos comparten un número de secciones estándar. Por ejemplo, cada documento tendrá una Introducción común y cada uno incluirá una sección sobre Arquitectura de seguridad y Modelos de amenazas .
Planeé poner esas secciones compartidas en documentos de Word separados y luego combinar o fusionar los documentos de Word a la carta para producir un documento más grande.
Conozco DocBook y sé cómo combinar libros/secciones separados en un libro más grande. En este escenario, tendría un archivo XML separado para cada tema y luego los incluiría en los distintos libros. DocBook se encargará de la tabla de contenido, los encabezados de las secciones, el índice, etc.
¿Cómo combino o combino varios documentos de Word en un solo documento más grande? Estoy especialmente interesado en una forma de hacerlo desde la línea de comandos para no tener que luchar con la interfaz de usuario.
¿Qué software se utiliza para hacer esto en la plataforma Windows?
El estándar DITA fue creado para resolver exactamente este problema.
Puede crear fragmentos de documentación y luego combinarlos para crear libros completos.
Es muy útil cuando se utiliza el mismo capítulo en varias documentaciones (por ejemplo, se incluye un capítulo sobre Modelos de amenazas en la documentación de varios productos).
También es muy conveniente cuando se producen varios manuales ligeramente diferentes , por ejemplo, para varias versiones personalizadas del mismo software.
Al ser DITA un estándar, existen muchas herramientas que lo implementan. Recomendaría Componize , que también proporciona gestión de documentos.
DITA Open Toolkit es una implementación de código abierto de la cadena de herramientas DITA.
Está escrito en Java y se ejecuta en Windows/Mac/Linux.
Guía del usuario: http://www.dita-ot.org/2.1/user-guide/transforming-dita-content.html
Las partes mismas deben estar escritas en Docbook o en el XML especificado por DITA , a su elección. Ambos formatos tienen algunos editores WYSIWYG disponibles.
Sugeriría escribir su sección como DocBooks y luego usar pandoc para combinar y convertir a docx para MS-Word.
Es posible que desee utilizar un formato intermedio durante el procesamiento para agregar etiquetas ToC, etc.
izzy
Tomás Weller
izzy