A pandoc LaTeX template for creating a curriculum vitae.
Go to file
2020-02-23 19:06:38 +01:00
LICENSE Initial commit 2020-02-01 21:25:48 +00:00
pancv.tex optional arguments 2020-02-22 14:44:27 +01:00
README.md add docker documentation 2020-02-23 19:06:38 +01:00

pancv

A pandoc LaTeX template for creating a curriculum vitae.

English

Pancv is a template for pandoc for the realization of curriculum vitae.

Pancv uses packages moderncv and europasscv.

Warning: Europass support is still experimental.

Installation

  • Install pandoc and a LaTeX distribution.
  • Download the latest version of this template from the release page.
  • Move the template pancv.tex to your pandoc templates folder and rename the file to pancv.latex. The location of the templates folder depends on your operating system.
    • Unix, Linux, macOS: ~/.pandoc/templates/
    • Windows XP: C:\Documents And Settings\USERNAME\Application Data\pandoc\templates
    • Windows Vista or later: C:\Users\USERNAME\AppData\Roaming\pandoc\templates

Usage

Once all the necessary material is installed and configured you can use pancv through the --template flag.

In the following example all variables have been set within the cv.yaml file and cv.pdf has been chosen as the output file.

pandoc cv.yaml --template pancv -o cv.pdf

Variables

  • europass (boolean) equal to true if you want a curriculum in europass format
  • name
    • first (string) name.
    • family (string) surname.
  • address
    • first (string) address.
    • second (string) [optional] address.
  • email (string) email address.
  • mobile (string) mobile phone number.
  • phone (string) phone number.
  • cron-sections (list) chronological sections.
    • section (string) section name.
    • entries (list) elements of the section.
      • year (string) duration.
      • degree (string)
      • institution (string)
      • city (string) [optional].
      • grade (string) [optional].
      • description (string) [optional].
  • sections (list) sections.
    • section (string) section name.
    • items (list) elements of the section.
      • left (string) left part of the section.
      • right (string) right part of the section.

Docker

This template can also be used through a docker container.

The first operation to do is to retrieve the norangebit/pandocker image through the following command:

docker pull norangebit/pandocker

after which you can run the container with the command:

docker run --rm --volume "`pwd`:/data" --user `id -u`:`id -g` norangebit/pandocker <cmd>

where instead of <cmd> the desired pandoc command must be inserted. For example, you can get the same result as the previous example through the command:

docker run --rm --volume "`pwd`:/data" --user `id -u`:`id -g` norangebit/pandocker pandoc cv.yaml --template pancv -o cv.pdf

Italiano

Pancv è un template per pandoc per la realizzazione di curriculum vitae.

Pancv utilizza il pacchetto moderncv e il pacchetto europasscv.

Attenzione: Il supporto al formato europass è ancora in fase sperimentale.

Installazione

  • Installare pandoc e una distribuzione LaTeX.
  • Scaricare l'ultima versione di questo tema dalla pagina delle release.
  • Copiare il file pancv.tex nella cartella dei template e rinominarlo in pancv.latex. La cartella dei template varia a seconda del sistema operativo.
    • Unix, Linux, macOS: ~/.pandoc/templates/
    • Windows XP: C:\Documents And Settings\USERNAME\Application Data\pandoc\templates
    • Windows Vista o superiore: C:\Users\USERNAME\AppData\Roaming\pandoc\templates

Uso

Una volta installato e configurato tutto il materiale necessario sarà possibile utilizzare pancv attraverso il flag --template.

Nel seguente esempio tutte le variabili sono state settate all'interno del file cv.yaml e come file di output è stato scelto cv.pdf.

pandoc cv.yaml --template pancv -o cv.pdf

Variabili

  • europass (boolean) pari a true se si desidera un curriculum in formato europass
  • name
    • first (string) nome.
    • family (string) cognome.
  • address
    • first (string) indirizzo.
    • second (string) [opzionale] indirizzo.
  • email (string) indirizzo email.
  • mobile (string) numero di cellulare.
  • phone (string) numero fisso.
  • cron-sections (list) sezioni cronologiche.
    • section (string) nome della sezione.
    • entries (list) elementi della sezione.
      • year (string) durata.
      • degree (string)
      • institution (string)
      • city (string) [opzionale]
      • grade (string) [opzionale]
      • description (string) [opzionale]
  • sections (list) sezioni.
    • section (string) nome della sezione.
    • items (list) elementi della sezione.
      • left (string) parte di sinistra della sezione.
      • right (string) parte di destra della sezione.

Docker

Questo template può essere utilizzato anche a traverso un container docker.

La prima operazione da fare è recuperare l'immagine norangebit/pandocker attraverso il seguente comando:

docker pull norangebit/pandocker

dopo di che è possibile eseguire il container con il comando:

docker run --rm --volume "`pwd`:/data" --user `id -u`:`id -g` norangebit/pandocker <cmd>

dove al posto di <cmd> va inserito il comando pandoc desiderato. Per esempio si può ottenere lo stesso risultato dell'esempio precedente attraverso il comando:

docker run --rm --volume "`pwd`:/data" --user `id -u`:`id -g` norangebit/pandocker pandoc cv.yaml --template pancv -o cv.pdf