«

»

Imprimir esta Post

Dillinger + Dropbox + Pandoc

A veces necesitamos escribir rápidamente un documento, con un mínimo de formato. Eso implica abrir algo más que el editor del sistema (bloc de notas, kedit, etc…). Terminamos abriendo un documento Word, OpenOffice, una plantilla LaTeX los más acostumbrados… Y no acaba de ser práctico. Acabo de descubrir un servicio muy simpático para generar documentos rápidamente en formatos múltiples a partir de un único documento fuente. Para ello utilizamos tres herramientas: Dillinger, Dropbox y Pandoc.

Flujo de trabajo

 

  • Entramos en la aplicación online Dillinger. Esta web muestra un editor a la izquierda y un previo del aspecto del documento a la derecha. En Dillinger podremos escribir en el formato Markdown.
  • Importamos y/o grabamos nuestro trabajo en Dropbox. Si autorizamos en nuestra cuenta de Dropbox a Dillinger, nos creará una carpeta con su nombre en la que guardará nuestros archivos Markdown con el nombre que hayamos puesto de título.
  • Usamos pandoc para interpretar el archivo Markdown. De esta manera podemos generar archivos .html, .docx, .pdf, … Esto se hace por línea de comandos pero es tremendamente sencillo. Basta con ir a la carpeta Dropbox/Dillinger y escribir algo como:

Preparación del entorno

Necesitamos instalar Dropbox y pandoc en la máquina que vayamos a usar. Hay instaladores o paquetes para Windows, Mac OS y Linux. Dillinger no necesita instalación, y basta con entrar en la web.

Ventajas

  • No necesitas copiar y pegar el mismo texto en diferentes formatos. Con un sólo archivo .md tienes el mismo contenido para todo.
  • Centralizar los cambios. Por ejemplo, si quieres tener un texto en tu página web y ofrecerlo en .pdf para descarga, puedes generar el archivo .md que generará los otros dos. Si necesitas cambiar algo sólo necesitas editar el .md y generar nuevos .html y.pdf
  • Tiene las ventajas asociadas a trabajar en texto plano:
    • Editable en cualquier SO con casi cualquier editor del sistema
    • Alta capacidad de compresión
    • No depende de software privativo (como un archivo .docx, por ejemplo)
    • Se entiende muy bien con herramientas de control de código como Git o Subversion
  • Markdown es una sintaxis que mezcla contenido con formato de una manera poco invasiva, es decir, t
  • iene lo suficiente para que el texto pueda ser procesado por una máquina pero l
  • a introducción de marcas para formateo es fácilmente legible por un humano.

Desventajas

  • Aprender a escribir los archivos bien formateados. Si bien, lo básico (encabezados, negrita, cursiva y bolos) es muy sencillo e intuitivo.
  • Sucede a veces que el previo de Dillinger no se corresponde exactamente con la salida de pandoc (normalmente porque Dillinger es más permisivo con la sintaxis)
  • Privacidad. No olvidemos que permitimos el uso de nuestro Dropbox. Como siempre: uno debe ser responsable de saber dónde y con quién comparte su información y decidir en consecuencia.
  • Para convertir directamente a .pdf con pandoc se necesita pdflatex (MikTex para Windows sirve, por ejemplo). Si no, habrá que pasar por algún software intermedio que imprima o exporte a este formato.

Conclusión

Creo que merece la pena echarle un ojo a la combinación, sobre todo si eres de los más ancestrales del lugar y recuerdas cosas como el maquetado en Wordstar y similares. Si también acostumbras a generar documentación en múltiples formatos, es muy interesante. Para mí, sobre todo, el poder usar una archivo fuente para mis documentos (al igual que con LaTeX) y así poder integrar la documentación en Git, me resulta muy práctico. ¿Le echas un ojo y me cuentas?

Acerca del autor

Dani Ramírez

Artesano del conocimiento, del software y los juegos de mesa. También Ex-CEO de una empresa que nunca dio beneficios, Ex-programador a tiempo completo, Ex-estudiante de ingeniería... Knowledge, software and board game craftsman. Also, Ex-CEO-of-a-company-which-never-had-profits, Ex-full-time-programmer, Ex-engineering-student, ...

Enlace permanente a este artículo: http://danibishop.com/dillinger-dropbox-pandoc/

  • http://julitrows.wordpress.com julitrows

    Interesante el pandoc, aun tengo pendiente probarlo, pero suena bastante potente!

    En lugar de Dillinger, yo tiraría de el editor de texto plano que usemos, ya sea el Gedit, Sublime Text 2 (disponible en Win, Linux y Mac) o el que queramos. Cualquier editor medianamente actual debería soportar el coloreado Sintáctico de markdown. Si no, lo están haciendo mal 😛

    Para el tema del preview de Dillinger, por ejemplo para Sublime Text 2 hay una extensión que lanza el documento en el explorador para verlo formateado, y si no, hay una extensión de chrome que te parsea el markdown [1].

    Perdemos la preview “instantanea”, que a estas alturas de la película, pese a ser bonito tampoco es pa matarse, y a cambio ganamos el no otorgar permisos sobre nuestro github y dropbox a una aplicación externa. Además, la idea es de usar para markdown el mismo editor que usamos para el resto es mas atractiva que usar una aplicación exclusiva para ello, creo yo.

    He investigado, y hay un plugin para Sublime Text 2 para interactuar directamente con Pandoc [2], todo en uno ya, señora.

    Por lo demás, creo que Dillinger merece la pena simplemente por bajarlo y trastear el código, para ver como funciona el node.js que lleva por debajo.

    [1] https://chrome.google.com/webstore/detail/markdown-preview/jmchmkecamhbiokiopfpnfgbidieafmd
    [2] https://github.com/jclement/SublimePandoc

    • http://danibishop.com danibishop

      He borrado sin querer un comentario infinito en el que te respondía xD Resumen: 1) Para un uso continuado no tiene sentido, para mí y por ahora, el volcar la balanza al lado de la confianza en una herramienta online cuando uno tiene todo esto, como bien dices, en un editor en una máquina propia. 2) Como herramienta rápida para escribir algo mientras estás navegando, es muy cómodo desde cualquier máquina. Te bajas el archivo y listo. 3) Si tienes la carpeta Dillinger compartida con gente para generar un documento entre varios, puede ser una mina para documentación formateada generada rápidamente (ni Wikis, ni leches). 4) El preview es muy, muy cómodo en este caso, sobre todo para gente que empieza con Markdown.

      La idea de la entrada era comentar un posible uso de herramientas encadenadas, algo a lo que mucha gente no está acostumbrada. Sobre todo para un perfil early adopter que desconociera las herramientas o este posible uso. Para enganchados como nosotros… es un juguetito más 🙂

      ¡Totalmente de acuerdo en todas las apreciaciones y muy agradecido por las aportaciones de los links!

Pinterest