Variabili in documenti LaTeX esportati da Emacs Org Mode

La solita introduzione su Emacs, Org Mode e LaTeX

Questa è la solita introduzione su Emacs, Org Mode e LaTeX: se sapete già tutto potete saltarla.

Org Mode sotto GNU Emacs è un potente strumento per organizzare idee.

Una funzionalità eccellente di tale strumento è la possibilità di esportare i documenti direttamente da Org Mode verso LaTeX, l’eccellenza assoluta per l’impaginazione, così come verso altri linguaggi, come Markdown e HTML.

Nell’esportazione verso LaTeX, è possibile inserire comandi nella parte preliminare del documento in Org Mode, per modificare il risultato dell’eportazione nel documento PDF finale.

Le variabili sono utili comandi che consentono a LaTeX di sostituire automaticamente dei campi segnaposto con nomi, stringhe numeriche od ogni altra combinazione di testo e numeri.

Potete trovare informazioni su questo argomento nel mio precedente articolo.

Nell’attuale articolo propongo alcune soluzioni per la generazione di variabili durante l’esportazione di documenti da Org Mode a LaTeX.

In aggiunta, esclusivamente nella versione in italiano, riporto anche alcune impostazioni che consentono di superare alla radice i difetti di traduzione del sommario e di altri elementi (difetti, in ogni caso, già segnalati agli sviluppatori di Org).

Sezione preliminare essenziale in Org Mode per esportazione a LaTeX con generazione di variabili

Di seguito riporto un semplice preambolo in un documento Org Mode:

#+LANGUAGE: it
#+AUTHOR: Franco Pasut
#+TITLE: Titolo del documento
#+LATEX_HEADER: \usepackage[T1]{fontenc}
#+LATEX_HEADER: \usepackage[utf8]{inputenc}
#+LATEX_HEADER: \usepackage[italian]{babel}
#+LATEX_HEADER: \newcommand{\myname}{Franco}
#+LATEX_HEADER: \newcommand{\mysurname}{Pasut}

La prima riga imposta la lingua italiana, la seconda il nome dell’autore e la terza il titolo del documento.

Per quanto concerne la lingua italiana, tuttavia, ho riscontrato che l’esportazione generata solo dal comando #+LANGUAGE: it non sia completa.

Ad esempio: l’intestazione dell’Indice dei vari paragrafi viene indicata come “Contents” e le date restano impostate con il formato inglese.

Per avere una corretta esportazione di tutti gli elementi ho provato ad aggiungere anche i comandi di seguito indicati, che sono quelli tradizionalmente utilizzati in LaTeX per la corretta impostazione della lingua italiana.

#+LATEX_HEADER: \usepackage[T1]{fontenc}
#+LATEX_HEADER: \usepackage[utf8]{inputenc}
#+LATEX_HEADER: \usepackage[italian]{babel}

L’effetto è stato quello desiderato: le impostazioni di lingua nel documento esportato in LaTeX sono risultate complete e corrette!

Ovviamente è possibile aggiungere altre impostazioni preliminari, ma non è questo l’oggetto dell’articolo.

Le linee dedicate all’esportazione delle variabili

Sono, invece, le ultime due linee che vorrei evidenziare.

La riga #+LATEX_HEADER: \newcommand{\myname}{Franco} crea una nuova variabile chiamata “myname” che sarà sostituita, nel documento esportato in LaTeX, con il nome proprio “Franco”.

La linea #+LATEX_HEADER: \newcommand{\mysurname}{Pasut} crea una nuova variabile chiamata “mysurname” che sarà sostituita, nel documento esportato in LaTeX, con il nome proprio “Pasut”.

Ora potrete disseminare le variabili \myname{} e \mysurname{}, o qualsiasi altra variabile vorrete creare, nel documento Org Mode per, poi, ottenere la sostituzione automatica nel documento esportato in LaTeX con i nomi impostati, nel caso di specie Franco e Pasut.

Attenzione a non utilizzare nomi di variabili riservati al sistema Emacs: ve ne accorgereste subito perchè le variabili non sarebbero trasformate correttamente.

Come potete notare sopra, le variabili sono seguite dallo spazio vuoto {} che serve per distanziare i nomi generati dalle variabili dalle parole immediatamente successive.

Se, invece, dopo la variabile fosse presente un segno di interpunzione non occorrerebbe tale aggiunta.

A questo punto, per esportare il documento da Org Mode verso LaTeX premete C-c C-e ll o, se volete l’apertura automatica del documento esportato nel lettore di PDF, C-c C-e lo.

Perché le variabili?

Ma che senso ha creare variabili al posto dei nomi? Non sarebbe sufficiente scrivere i relativi contenuti direttamente nel documento?

Molto semplice: se nel documento esportato in LaTeX fosse necessario sostituire i nomi generati dalle variabili con altri, sarà sufficiente modificare l’assegnazione di variabile nel preambolo e non correrete il rischio di lasciare qualche “vecchio” nome sparso nel documento.

È una soluzione particolarmente utile se dovete riutilizzare il documento esportato in LaTeX.

Vi ringrazio per l’attenzione.