Introducción

Mantener el CV actualizado en multiples idiomas

El primer problema que he querido resolver al querer hacer más programático mi CV ha sido el mantener actualizado múltiples ediciones en Español e Inglés del mismo CV.

Originalmente trabajaba con dos documentos, que con el paso del tiempo se fueron desincronizando, pues empezó a volverse usual que me era más requerida la edición en ingles que la edición en español, sin embargo la edición en español estaba más completa pues contenía todo lo que había hecho en el pasado.

Implementación

Multilingual Markdown Generator

Después de analizar el problema y diversos formatos en los que pudiera trabajar, encontré que tener mi CV en formato Markdown y utilizar el programa Multilingual Markdown Generator (mmg) resultaba ser la opción más conveniente, pues de Markdown podia transformar fácilmente el documento final a otros formatos sea HTML o PDF con ayuda de Pandoc.

Aunque mmg tiene soporte para generar HTML y PDF de forma directa, Pandoc proporciona mayor flexibilidad para manejar los la hoja de estílos. Además que al querer generar el PDF, arroja un error, presumiblemente relacionado con el motor de generación de PDF weasypdf, pues el mismo error ocurre en Pandoc al querer utilizar dicho motor:

PDF.init() takes 1 positional argument but 3 were given

Un sólo código base

La ventaja de utilizar mmd reside principalmente en que tanto la edición inglesa cómo la española, residen en un mismo documento base, en el cuál, mediante el uso de comentarios, se hace la distinción entre el contenido que será en español y el que será en inglés, pudiendo de esta forma hacer una comparación lado a lado de las diferencias entre ambas ediciones.

Ejemplo de uso

Basta con nombrar el archivo base de la forma *.base.md y en él, configurar nuestros idiomas objetivos con el siguiente comentario:

<!-- multilingual suffix: es-MX, en-US -->

Posteriormente el inicio de cada edición podrá marcarse con alguno de los siguientes comentarios según sea conveniente:

<!-- [common] -->
<!-- [es-MX] -->
<!-- [en-US] -->

Al ejecutar:

mmg -o as-is -y *.base.md

Obtendremos un archivo Markdown por cada idioma configurado en el archivo base. A continuación, con Pandoc, es posible generar el HTML o PDF final.

$ pandoc --metadata title="Document title" -t html5 --css style.css -V geometry:margin=1cm -s ${BASE_NAME}.en-US.md -o ${BASE_NAME}.en-US.pdf

$ pandoc --metadata title="Document title" -t html5 --css style.css -V geometry:margin=1cm -s ${BASE_NAME}.en-US.md -o ${BASE_NAME}.en-US.html

En la página oficial del proyecto se puede consultar la documentación pertinente.

Referencias

https://mmg.ryul1206.dev/