¿Por qué no debes escribir un libro con un procesador de texto convencional?

En la actualidad los libros se distribuyen en múltiples formatos (HTML, PDF, MS Word y ePub) para diferentes propósitos, y un procesador de texto convencional no puede generar continuamente todos estos productos.

Así que el flujo de trabajo más eficaz, consiste en realizar un solo manuscrito (usando código) para componer, compilar y publicar el libro de forma simultánea en todos los formatos que desees.

Ademas, en los procesadores convencionales, formatear tu texto, hacer que se vean bien las figuras y corregir los saltos de página rebeldes puede ser tedioso y llevar mucho tiempo.

En conclusión: si quieres tener todo organizado y consistente, o si necesitáis trabajar en equipo, etc. Microsoft Word y similares (OpenOffice?) NO es lo que necesitas. De tal manera que, para crear un libro, lo mejor es usar un lenguaje de marcado (código), que nos permitá concentrarnos en el contenido "sin preocuparnos por aplicar formatos".

 Marcado y estructura

Usted puede usar los siguientes "códigos" que facilitarán la redacción (hay más, pero estos son los 3 principales):

  • Markdown (en RMarkdown no logre hacer glosarios)
  • reStructuredText (RST)
  • AsciiDoc

Estos son lenguajes de marcado es decir una serie de comandos con los cuales usted puede marcar el contenido (texto) según corresponda; para que al producir un determinado formato, esté tenga un tratamiento especifico. Todos estos lenguajes pueden producir múltiples formatos de salida: HTML, PDF, Word, entre otros.

Markdown

Se recomienda usar Markdown para cualquier redacción rápida, pero simple. Markdown es excelente para crear documentos de carácter general, está muy bien representado por GitHub y otras herramientas de escritorio, pero para la creación un artículo o libro completo, Markdown se queda corto.

RST

RST es una herramienta más completa, pues además de los estilos de texto más comunes, RST provee:

  • Más formatos de listas:
    • Listas de definición.
    • Listas de parámetros.
    • Numeración de listas arbitrariamente.
  • Bloques de texto pre-formateado (para código),
  • Bloques de documentación de pruebas,
  • Citas,
  • Notas a pie de página,
  • Directivas, una manera de extender el lenguaje con construcciones propias,

RST no tiene ‘sabores’ o dialectos.

  • Hyperlinks con diferentes destinos: externos, internos, etc.

Esta última característica permite crear documentos interconectados que son muy útiles para textos amplios.

AsciiDoc

AsciiDoc ofrece todo lo de las dos herrmientas anteriores y más:

  1. Formatos de párrafo: párrafos de introducción y pre-formateados fáciles.
  2. Secciones prediseñadas: cuadros de aviso, de notas, etc.
  3. Formateo y sintaxis de código con notas; MUY ÚTILES!,
  4. Barras laterales,
  5. Macros,
  6. Generación de tablas desde CSV,
  7. Videos,
  8. Fórmulas,
  9. Iconos,
  10. Y muchas muchas cosas más, gracias a extensiones.