
 1. Modalità TexMaths
 
A partire dalla versione 0.51, TexMaths offre due modalità di equazione, a seconda della posizione del cursore in un documento Writer, Impress o Draw. Quando il cursore si trova all'interno di una casella di testo (in Impress è qui che si digita il testo, in Draw si può accedere a una casella di testo facendo doppio clic su un modulo e in Writer quando una casella di testo viene inserita nella pagina), TexMaths passa automaticamente alla modalità Testo. In tutti gli altri casi, TexMaths utilizza la modalità LaTeX.

In modalità LaTeX, l'equazione viene visualizzata come un'immagine grafica in formato PNG o SVG. In modalità Testo, l'equazione viene inserita come un set di caratteri utilizzando i font TexMaths (questi font sono specifici di TexMaths e vengono installati automaticamente quando necessario). Questo perché, a causa di una limitazione di LibreOffice, non è possibile inserire elementi grafici all'interno di una casella di testo e quindi TexMaths deve inserire le equazioni come testo.
 
La modalità Testo presenta alcune caratteristiche e limitazioni che verranno spiegate di seguito, nel paragrafo 6.



 2. La barra degli strumenti di TexMaths

Una volta installata l'estensione TexMaths in LibreOffice, si dovrebbe poter vedere una nuova barra degli strumenti in Writer, Impress e Draw. Questa è la barra degli strumenti di TexMaths. In Writer, questa barra degli strumenti è composta da quattro icone, mentre in Impress e Draw ce ne sono solo tre.

In Writer, facendo clic sull'icona più a sinistra (quella con il simbolo Pi greco blu) si avvia la macro Equazioni TexMaths. La seconda icona è utilizzata per Equazioni Numerate TexMaths. La terza icona è associata alla macro Ricompila Equazioni TexMaths. Infine, facendo clic sull'icona più a destra si apre la finestra di dialogo Configurazione di Sistema TexMaths. Si noti che in Impress e Draw la seconda icona non è presente. È presente anche un sottomenu Strumenti/TexMaths, situato appena sopra il sottomenu Strumenti/Macro.
 


 3. Introduzione alle Equazioni TexMaths

Se LaTeX è già installato sul tuo sistema, per iniziare a usare TexMaths basta fare clic sull'icona "Equazioni TexMaths" dalla barra degli strumenti di TexMaths. TexMaths cercherà i programmi esterni che utilizza per generare le equazioni LaTeX. Poi, digitare del codice LaTeX nel campo di testo dell'editor delle equazioni TexMaths e fare clic sul pulsante LaTeX per generare l'immagine dell'equazione.

Esempio: x(t) = \mu ^2 (t) dovrebbe produrre l'equazione x(t)=µ²(t)

A partire da TexMaths 0.46, l'editor delle equazioni offre caselle di simboli per inserire codice LaTeX per oltre 300 simboli. Basta fare clic sul simbolo selezionato e il codice LaTeX corrispondente verrà inserito nella posizione del cursore nell'editor di equazioni. Le icone dei simboli possono essere nascoste nella scheda Interfaccia della finestra di dialogo Configurazione di sistema di TexMaths. Qui è anche possibile definire il colore dei simboli (nero o bianco).

Se il cursore del documento è posizionato all'interno di una casella di testo, TexMaths passa automaticamente alla modalità Testo e installa i font TexMaths per l'utente locale. In questo caso, le equazioni non vengono inserite come immagini grafiche PNG o SVG, ma come normali caratteri utilizzando i font TexMaths.



 4. Generare equazioni LaTeX

Una volta digitati i parametri di un'equazione, è possibile generarla facendo clic sul pulsante LaTeX nella finestra di dialogo Equazioni di TexMaths. In modalità LaTeX, viene generata un'immagine dell'equazione nel formato, tipo e dimensione selezionati. È possibile scegliere tra i compilatori LaTeX, XeLaTeX e LuaLaTeX nella finestra di dialogo Configurazione di sistema. In modalità Testo, viene inserito un set di caratteri utilizzando i font TexMaths che rappresentano l'equazione. La dimensione del font è uguale a quella del font del testo.



 5. Modalità LaTeX

   5.1. Slezione del formato immagine

TexMaths può generare e inserire due tipi di immagini in un documento LibreOffice (quando il cursore non si trova all'interno di una casella di testo). Per selezionare il formato immagine, usare il selettore situato nel riquadro "Formato immagine".

Il formato immagine predefinito è il formato vettoriale SVG. Consente di ridimensionare le equazioni LaTeX senza perdita di precisione e non richiede l'installazione di alcun font matematico speciale in LibreOffice, poiché i simboli matematici vengono semplicemente disegnati utilizzando curve. Questo è il formato preferito (e predefinito), ma potrebbero verificarsi alcuni problemi durante l'esportazione di documenti LibreOffice in MS Office (vedere paragrafo 11).

L'altro formato immagine supportato è PNG, un formato di immagine raster. Pertanto, è necessario selezionare una risoluzione per utilizzarlo. Sebbene la risoluzione predefinita sia 600 dpi, è possibile scegliere tra diversi valori predefiniti. Non dovrebbero esserci problemi di compatibilità quando si utilizza il formato PNG per l'esportazione di documenti MS Office.

Si noti che ciascun formato è disponibile solo se il programma esterno corrispondente (dvisvgm per SVG e dvipng per PNG) è installato sul sistema con il percorso impostato tramite la finestra di dialogo Configurazione di sistema di TexMaths (solitamente provati al primo avvio). Almeno uno di questi due programmi è necessario per eseguire TexMaths.


   5.2. Dimensione font

TexMaths può gestire diverse dimensioni dei caratteri per le equazioni. Per modificare la dimensione del carattere, usare il selettore situato nel riquadro dimensioni font. Si può scegliere tra dimensioni predefinite o digitare quella che si preferisce se questa non è elencata.


   5.3. Trasparenza
 
È possibile attivare o disattivare la trasparenza dell'immagine dell'equazione selezionando la casella di controllo Trasparenza nella finestra di dialogo Equazioni di TexMaths. Questa opzione può essere utile quando lo sfondo del documento non è bianco. La trasparenza può essere utilizzata sia con i formati immagine SVG che PNG.


   5.4. Tipi di equazione

In modalità LaTeX, TexMaths può generare tre tipi di equazioni LaTeX:
- equazioni visive
- equazioni visive in linea
- equazioni in codice LaTeX

Per selezionare un tipo di equazione, basta utilizzare il pulsante di scelta situato nel riquadro Tipo equazione.

Per generare equazioni visive o equazioni visive in linea, basta selezionare il tipo di equazione appropriato e quindi digitare la formula dell'equazione nel campo di testo della finestra di dialogo Equazioni di TexMaths.

Esempio: per generare il simbolo greco alfa, basta battere \alpha

Le equazioni visive in linea si ottengono allo stesso modo, ma la differenza sta nello stile dell'equazione generata, che si integra meglio nel testo in Writer. Ad esempio, l'indice e l'esponente della somma vengono visualizzati accanto al segno di somma e non sotto o sopra.
 
Entrambi i tipi di equazioni sono ideali per semplici equazioni a riga singola e l'allineamento verticale nel testo è corretto, ma non possono gestire equazioni multilinea o ambienti LaTeX più generali. Per questo tipo di equazioni, selezionare il tipo di equazione LaTeX e inserire l'equazione tra le istruzioni \begin{} e \end{}. Puoi si può utilizzare qualsiasi istruzione dell'ambiente LaTeX.

Esempio: digitare le seguenti righe per visualizzare un'equazione composta da tre linee, allineate sul segno di uguale.
\begin{align*}
x &= 1 \\
y &= 2x+1\\
&= 3\\
\end{align*}


   5.5. Nome equazione
 
Nella finestra di dialogo Equazioni di TexMaths, è possibile inserire un'etichetta nel campo di testo Nome. Questa opzione può essere utilizzata per recuperare un'equazione tramite il suo nome e può essere utile quando si gestiscono le animazioni in Impress.


   5.6. Preferenze

TexMaths include alcune impostazioni predefinite. Se queste non soddisfano le proprie esigenze, si possono modificare utilizzando la finestra di dialogo "Preferenze" di TexMaths, accessibile facendo clic sul pulsante "Preferenze". Questa finestra di dialogo consente di modificare il formato dell'immagine, la dimensione del carattere, il tipo di equazione, ecc. per ogni tipo di documento di LibreOffice. È possibile salvare le nuove impostazioni, ripristinare quelle predefinite o caricare quelle già salvate.


   5.7. Preambolo LaTeX

Facendo clic sul pulsante "Preambolo" si apre la finestra di dialogo "Preambolo" di TexMaths, che consente di modificare il preambolo LaTeX. Ad esempio, per generare equazioni colorate, rimuovere il commento dalle tre righe seguenti del preambolo predefinito, modificare il valore del colore RGB a piacere e salvare il preambolo.

%\definecolor{fgcolor}{RGB}{0,0,255}
%\definecolor{bgcolor}{RGB}{255,0,0}
%\pagecolor{bgcolor}\color{fgcolor}

Ora, tutte le nuove equazioni avranno lo schema colori definito nel preambolo. Si noti che le equazioni con un colore di sfondo non sono più trasparenti, anche se l'opzione di trasparenza è stata selezionata. Pertanto, è necessario rimuovere lo sfondo colorato se si desidera la trasparenza.

Il preambolo viene memorizzato nelle proprietà del documento. In questo modo, ogni documento può avere il proprio preambolo. Si noti che il preambolo predefinito è globale e non può essere modificato. Si noti che LaTeX, XeLaTeX e LuaLaTeX hanno un preambolo predefinito diverso.


   5.8. I comandi \input, \include e \usepackage
 
A partire da TexMaths 0.41, i comandi LaTeX \input e \include possono essere utilizzati per inserire il contenuto di un file di testo LaTeX (.tex). Si presuppone che i file .tex inseriti si trovino nella stessa cartella del documento.

Esempio: nel documento my_doc.odt, il comando LaTeX:

\include{my_equations}

può essere utilizzato per inserire il contenuto del file LaTeX my_equations.tex, a condizione che questo file si trovi nella stessa cartella di my_doc.odt.

È anche possibile utilizzare file .sty personalizzati tramite i comandi \usepackage. Questi comandi devono essere inseriti nel preambolo e poi (se lo si desidera) memorizzati nel documento corrente. I file .sty devono trovarsi nella stessa cartella del documento.

Esempio: nel documento my_doc.odt, lo stile del documento my_style.sty può essere utilizzato aggiungendo al preambolo LaTeX il comando:

\usepackage{my_style}

Il file my_style.sty deve trovarsi nella stessa cartella di my_doc.odt, altrimenti non funzionerà.


   5.9. Da testo a LaTeX in Writer
 
Inserire del codice LaTeX direttamente in un documento Writer (ovvero senza aprire la finestra di dialogo di TexMaths), selezionare il testo e fare clic sull'icona "Equazioni TexMaths" (oppure usare una scorciatoia da tastiera, se definita). Il testo selezionato viene quindi convertito automaticamente in un'immagine di un'equazione LaTeX. Il formato dell'immagine, la dimensione e il tipo di equazione applicati sono quelli predefiniti nelle Preferenze di TexMaths. Nota: questa operazione non funziona in Writer quando il cursore si trova all'interno di una casella di testo.


   5.10. Modifica delle equazioni

All'interno di un documento di LibreOffice, selezionare un'immagine di equazione (già generata con TexMaths) e fare clic sull'icona "Equazioni TexMaths" nella barra degli strumenti di TexMaths (oppure usare una scorciatoia da tastiera, se definita). Verrà visualizzata la finestra di dialogo "Equazioni TexMaths" con il testo dell'equazione selezionato. Modificare questo testo e fare clic sul pulsante LaTeX per generare l'equazione modificata.

Naturalmente si può chiudere un documento, riaprirlo e modificare le equazioni salvate.


   5.11. Ricompilazione di equazioni TexMaths

Quando un documento (in Writer, Impress o Draw) contiene molte equazioni, può essere utile modificarne la dimensione del carattere, la trasparenza, il formato dell'immagine, ecc. in un'unica operazione. Questo è lo scopo della macro Ricompila Equazioni di TexMaths.

Facendo clic sull'icona della barra degli strumenti correlata (quella con l'ingranaggio) si apre una finestra di dialogo in cui è possibile modificare diversi parametri dell'equazione e il preambolo. Se non si desidera modificare un parametro da un elenco, abilitare il pulsante Lascia invariato.

In uno qualsiasi dei tre tipi di documento, è possibile ricompilare tutte le equazioni del documento selezionando l'opzione Ricompila Tutte le Equazioni.

Nei documenti di Writer, selezionando l'opzione Ricompila le Equazioni Selezionate, è possibile scegliere di ricompilare solo le equazioni che si trovano all'interno dell'area di testo selezionata. Si noti che, a causa di alcune limitazioni relative alle selezioni in LibreOffice, questa macro non ricompila le equazioni presenti in tabelle, cornici di testo, intestazione e piè di pagina. Se necessario, è possibile ricompilare le equazioni una alla volta, modificandole come di consueto.

Nei documenti Impress e Draw, selezionando l'opzione Ricompila equazioni dalla diapositiva, è possibile ricompilare solo le equazioni presenti nella diapositiva corrente.

Una volta impostati tutti i parametri e le opzioni, fare clic sul pulsante Esegui e tutte le equazioni, o quelle selezionate, dovrebbero essere aggiornate con i nuovi valori dei parametri. Quando si gestiscono centinaia di equazioni, questa operazione può richiedere del tempo, quindi abbiate pazienza.


   5.12. Numerazione equazioni in Writer
 
Numerare le equazioni è semplice: basta fare clic sull'icona "Equazioni Numerate" di TexMaths (o digitare una scorciatoia da tastiera, se definita), inserire l'equazione e fare clic sul pulsante LaTeX. Un'equazione centrata e numerata (con numerazione a sinistra o a destra) verrà automaticamente inserita nel documento Writer.

È anche possibile selezionare la spaziatura desiderata e la didascalia dell'equazione nella scheda Opzioni della finestra di dialogo Configurazione di sistema di TexMaths.

Le equazioni numerate non possono essere inserite in Writer quando il cursore si trova all'interno di una casella di testo.

 
   5.13. Compatibilità con ooolatex

A partire dalla versione 0.34, TexMaths è compatibile con ooolatex. Ciò significa che se si dispone di un documento contenente equazioni ooolatex, è possibile modificarle selezionandole (una alla volta) e richiamando la macro TexMaths Equation. È quindi possibile modificare il codice LaTeX e rigenerare l'equazione in formato SVG o PNG, a seconda delle preferenze.



 6. Modalità testo

   6.1. Equazioni

La modalità Testo viene selezionata automaticamente da TexMaths quando il cursore si trova all'interno di una casella di testo. In Impress, questo è l'unico modo per inserire un'equazione in linea che si muove con il testo quando viene modificato. In modalità Testo, TexMaths tenta di convertire il codice LaTeX in un insieme di caratteri utilizzando i font TexMaths.

In modalità Testo, è possibile generare solo equazioni semplici con al massimo un livello di apice e pedice. Qualsiasi altro livello non è supportato. Si noti che in Impress è comunque possibile generare equazioni complesse in modalità LaTeX posizionando il cursore fuori dalle caselle di testo e cliccando sull'icona Equazione TexMaths.


   6.2. Ambienti

In modalità Testo, le parentesi graffe vengono utilizzate per ottenere ambienti con posizioni e proprietà diverse, come nella seguente equazione:
y_n = \sum_{n=1}^{N-1} x_n

Possono essere inseriti tutti i simboli che non sono visualizzati in grigio nella tavolozza dei simboli.

È anche possibile utilizzare alcuni semplici ambienti per formattare l'equazione:
- \text{}, \textrm{}, \textbf{}, \textit{} per la formattazione del testo
- \bold{}, \italic{}, \underline{} per il peso del testo
- \mathbb{}, \mathcal{}, \mathscr{}, \mathfrak{} per font matematici speciali
- \huge{}, \Huge{}, \large{}, \Large{}, \small{}, \tiny{} per la dimensione del carattere


È anche possibile annidare gli ambienti, come nell'esempio seguente:
w \textrm{\large{text}} x


   6.3. Condivisione di documenti con equazioni di testo
   
Se si desidera condividere un documento contenente equazioni di testo di TexMaths, non è necessario inviare i font di TexMaths al destinatario. Si può invece incorporare i font di TexMaths nel documento utilizzando il menu File / Proprietà / Font / Incorporamento font e abilitando l'opzione Incorpora font nel documento. Questa procedura funziona allo stesso modo per i documenti di Writer / Impress e Draw.


7. Cronologia

A partire dalla versione 0.51, un meccanismo di cronologia consente di recuperare i codici delle equazioni precedenti all'interno dell'editor di equazioni. I due pulsanti << e >> consentono di navigare nella cronologia, mentre il pulsante <> serve a cancellarla.
 

 8. Configurazione di sistema
 
Facendo clic sulla terza icona si apre la finestra di dialogo Configurazione di Sistema di TexMaths. Nella prima scheda di questa finestra di dialogo, è possibile modificare i percorsi dei file dei programmi esterni. A partire da TexMaths 0.46, è necessario fornire il percorso completo del file.

La seconda scheda consente di selezionare il compilatore LaTeX (LaTeX, XeLaTeX o LuaLaTeX, se questi ultimi sono installati e supportati dalla versione di dvisvgm utilizzata. Si noti che XeLaTeX non può essere utilizzato per generare immagini PNG di equazioni). Sono inoltre disponibili opzioni per la numerazione delle equazioni e la compatibilità con MS Word. Nella terza scheda, è possibile selezionare il font utilizzato nell'editor di equazioni e impostare varie opzioni relative alle icone dei simboli. La quarta scheda della finestra di dialogo Configurazione di Sistema consente di definire alcune scorciatoie da tastiera per avviare le macro di TexMaths.


 9. Esportazione documenti per MS Office
 
Se si prevede di esportare i documenti in MS Office (Word e PowerPoint, indipendentemente dalla versione), è possibile salvare i documenti di LibreOffice nei formati .docx e .pptx.

Si consiglia inoltre di impostare l'opzione di compatibilità dell'allineamento verticale di Word (nella finestra di dialogo Configurazione di sistema di TexMaths) se i documenti di Writer devono essere esportati in Word. Questo correggerà l'allineamento verticale irregolare delle equazioni in linea in Word.


 10. Scorciatoie da tastiera

Per configurare le scorciatoie per avviare le equazioni di TexMaths con o senza numerazione, fare clic sul pulsante Configurazione di sistema TexMaths nella barra degli strumenti di TexMaths e definire le scorciatoie. Per le equazioni senza numerazione, è possibile avere una singola scorciatoia per tutte le applicazioni o una diversa per ciascuna. Poiché le equazioni numerate possono essere utilizzate solo in Writer, esiste una sola scorciatoia per esse.

Nella finestra di dialogo Equazioni di TexMaths, è possibile utilizzare le seguenti scorciatoie:
- Esc per chiudere la finestra di dialogo senza generare un'equazione
- Alt-L o Ctrl-L per generare un'equazione
- Alt-P o Ctrl-P per visualizzare la finestra di dialogo Preferenze
- Alt-B o Ctrl-B per visualizzare la finestra di dialogo Preambolo

 11. Problemi conosciuti
 
- Sebbene sviluppato per LibreOffice, TexMaths può essere utilizzato anche in Apache Openoffice 4.x.

- Le equazioni che includono comandi PSTricks non possono essere visualizzate correttamente come immagini PNG a causa di dvipng. È possibile utilizzare in sicurezza il formato SVG.

- Quando si esportano documenti Impress con equazioni di testo in formato MS PowerPoint, anche se l'opzione di incorporamento dei font è abilitata in Impress, si verifica un bug che rende i font incorporati non disponibili in PowerPoint. Fortunatamente, ecco una soluzione alternativa: in Windows, con i font TexMaths installati, aprire il file .pptx con PowerPoint e incorporare i font (utilizzare File / Opzioni / Salva, quindi Incorpora font nel file e selezionare l'opzione di incorporamento desiderata). Ora il documento .pptx ha i font incorporati e può essere condiviso con altre persone.