From f39ec4df40e1dfcf04545f53d13274f82796a51c Mon Sep 17 00:00:00 2001 From: piccihud Date: Sun, 16 Apr 2023 19:32:56 +0200 Subject: [PATCH] add pandoc.md and fix other files --- pandoc.md | 87 ++++++++++++++++++++++++++++++++++++++++++++++ systemdservices.md | 8 ++--- 2 files changed, 91 insertions(+), 4 deletions(-) create mode 100644 pandoc.md diff --git a/pandoc.md b/pandoc.md new file mode 100644 index 0000000..e277420 --- /dev/null +++ b/pandoc.md @@ -0,0 +1,87 @@ +# Pandoc + +Pandoc è un tool open source da linea di comando scritto che serve a convertire da un linguaggio di markup ad un altro in modo semplice e veloce. Supporta svariati formati tra cui: + +- latex +- markdown +- html + +Inoltre è in grado di convertire i file da un determinato linguaggio di markup ad un formato pdf, epub, ecc. + +## Installazione + +```bash +sudo apt install pandoc texlive-latex-extra texlive-latex-base texlive-xetex texlive-publishers texlive-fonts-extra +``` +## Sintassi + +Per convertire un file da un formato all’altro basterà eseguire: + +```bash +pandoc -s nomefile.formato -o nomefile.nuovoformato +``` +Per esempio, per convertire un file markdown note.md in un file pdf note.pdf: + +```bash +pandoc -s note.md -o note.pdf +``` + +### Altre opzioni + +- `-f FORMAT`: specifica il formato di input del documento +- `-t FORMAT`: specifica il formato di output del documento +- `-o FILE`: specifica il nome del file di output +- `-s` o `--standalone`: crea un documento autonomo con intestazione e piè di pagina +- `--template=FILE`: specifica il file di modello yaml da utilizzare +- `-V KEY=VALUE`, ovvero `--variable=KEY:VALUE`: imposta una variabile di modello +- `-H FILE`, `--include-in-header=FILE`: include il contenuto del file specificato nell'intestazione del documento +- `--toc`: per aggiungere un indice, utile per pdf e epub +- `--number-sections`: per numerare sezioni, capitoli e sottocapitoli, utile per la conversione nel formato pdf e epub +- `--pdf-engine=xelatex`: per specificare un motore di conversione alternativo a quello predefinito. Questa scelta rispetto al motore pre-impostato, pdflatex, deriva dal fatto che con xelatex è possibile creare pdf anche da documenti che hanno caratteri speciali in formato UnicodeQuesta scelta rispetto al motore pre-impostato, pdflatex, deriva dal fatto che con xelatex è possibile creare pdf anche da documenti che hanno caratteri speciali in formato Unicode +- `-V lang=it`: con l'opzione `-V` vengono introdotte le variabili. Serve per comunicare a LaTeX di utilizzare la sintassi italiana +- `-V colorlink`: serve per rendere i link colorati +- `-V table-use-row-colors=true`: le righe delle tabelle sono colorate alternativamente + +Ecco un esempio di comando: + +```bash +pandoc -s file.md -f markdown -t pdf --pdf-engine=xelatex -V lang=it -V colorlinks=true -V linkcolor=teal -V urlcolor=teal -V toccolor=gray --template eisvogel --listings -V table-use-row-colors=true -o file.pdf +``` + +## Tema personalizzato + +Qui un ottimo tema personalizzato: [https://github.com/Wandmalfarbe/pandoc-latex-template](https://github.com/Wandmalfarbe/pandoc-latex-template) + +### Installazione del tema personalizzato + +```bash +cd +wget -c https://github.com/Wandmalfarbe/pandoc-latex-template/blob/master/eisvogel.tex + +mkdir -p ~/.local/share/pandoc/templates/ +mv eisvogel.tex ~/.local/share/pandoc/templates/ +``` +Maggiori informazioni sulle variabili di Pandoc: [https://pandoc.org/MANUAL.html#variables-for-latex](https://pandoc.org/MANUAL.html#variables-for-latex) + +### Personalizzare header + +Al principio del file .md: + +```md +--- +title: "The Document Title" +author: [Example Author, Another Author] +date: "2017-02-20" +keywords: [Markdown, Example] +... +--- +``` + +## Collegamenti + +- [https://linuxhub.it/articles/howto-convertire-i-formati-con-pandoc/](https://linuxhub.it/articles/howto-convertire-i-formati-con-pandoc/) +- [https://www.avvocati-e-mac.it/blog/2019/4/9/compilare-un-atto-telematico-in-markdown-con-pandoc](https://www.avvocati-e-mac.it/blog/2019/4/9/compilare-un-atto-telematico-in-markdown-con-pandoc) +- [https://www.howtogeek.com/678022/how-to-use-pandoc-to-convert-files-on-the-linux-command-line/](https://www.howtogeek.com/678022/how-to-use-pandoc-to-convert-files-on-the-linux-command-line/) +- [https://jdhao.github.io/2019/05/30/markdown2pdf_pandoc/](https://jdhao.github.io/2019/05/30/markdown2pdf_pandoc/) +- [https://learnbyexample.github.io/customizing-pandoc/](https://learnbyexample.github.io/customizing-pandoc/) +- [https://it.wikibooks.org/wiki/Scrivere_in_modo_sostenibile_usando_il_testo_semplice_con_Pandoc_e_Markdown](https://it.wikibooks.org/wiki/Scrivere_in_modo_sostenibile_usando_il_testo_semplice_con_Pandoc_e_Markdown) diff --git a/systemdservices.md b/systemdservices.md index fd658b8..2a5a6b9 100644 --- a/systemdservices.md +++ b/systemdservices.md @@ -1,7 +1,7 @@ --- class: post title: Systemd e gestione dei servizi -date: aaaa-mm-gg +date: "2023-04-16" layout: post author: piccihud published: false @@ -83,7 +83,7 @@ Ogni sezione ha diverse opzioni disponibili. Questa la struttura base di un servizio: -```systemd +```bash [Unit] Description=una descrizione del servizio After=lista di servizi che vengono eseguiti prima @@ -162,7 +162,7 @@ Ad ogni service si può associare un `timer`. Questa pratica potrebbe essere uti Associare al precedente servizio `avvio.service` un `avvio.timer` nella cartella `/etc/systemd/system`: -```systemd +```bash [Unit] Description=un timer associato ad avvio.service @@ -216,7 +216,7 @@ systemctl start avvio.timer #### Riavvio automatico di un servizio -```systemd +```bash /etc/systemd/system/daemon.service [Unit]