Skip to content

Preparazione dell'ambiente

Jump to bottom
Alessandro Campolo edited this page Sep 16, 2024 · 3 revisions

L'installazione dei programmi verrà documentata per le tre principali piattaforme

  • Windows
  • MacOS
  • Linux e Unix-like

TeX Live

Essendo il processo più lungo, è consigliabile cominciare con l'installazione di TeX Live.

ATTENZIONE:
Nel progetto di esempio viene usato il pacchetto minted per la colorazione della sintassi. L'uso di questo pacchetto richiede l'interprete Python con il modulo pygments installato.

Seguire questa facile guida per installare Python https://www.aranzulla.it/come-installare-python-1210886.html, mettere la spunta sulla casella "Aggiungi Python 3.X al PATH", finita l'installazione, cliccare su "Disable PATH length limit".

Successivamente aprire un terminale in cui digitare pip install Pygments per installare il suddetto modulo (dopo ogni comando inserito nel terminale, anche nei casi successivi, premere invio per eseguire il comando).

Windows

Per l'installazione su Windows scaricare l'installer da https://mirror.ctan.org/systems/texlive/tlnet/install-tl-windows.exe.

L'installer è firmato con una chiave non registrata in Windows, di conseguenza SmartScreen visualizzerà un avviso, l'installer è completamente sicuro ed è possibile ignorare questo avviso.

Cliccare "Ulteriori informazioni" per mostrare il pulsante "Esegui comunque" e cliccarlo.

Nella prima schermata dell'installer scegliere "Install", poi premere "Next" e infine "Install".

Nella schermata che si apre scegliere il mirror italiano dal menu a tendina.

Dal momento che si userà solo Visual Studio Code per la scrittura, è possibile escludere TeXworks dall'installazione. Utenti più esperti possono usare le opzioni avanzate per selezionare manualmente i pacchetti da installare e velocizzare l'installazione. Questa parte non è attualmente oggetto della documentazione e viene lasciata come triviale esercizio per il lettore.

L'installazione di tutti i pacchetti può richiedere anche due ore, è possibile continuare a seguire i passaggi successivi di questa guida.

Risoluzione dei problemi

In uno dei casi di installazione su Windows il processo non andava a buon fine nella cartella predefinita, possibili soluzioni:

  • Eseguire l'installazione con l'antivirus disattivato
  • Riavviare l'installazione come amministratore
  • Tornare al passaggio di configurazione dell'ambiente e cambiare la cartella di installazione da C:/texlive/20XX a C:/Programmi/texlive/20XX.

MacOS

Dopo il download di \url{https://mirror.ctan.org/systems/mac/mactex/MacTeX.pkg}, fare doppio clic per installarlo. Seguite le semplici istruzioni. L'installazione su MacOS richiede circa dieci minuti.

Il programma di installazione presenta:

  1. una pagina di benvenuto

  1. una pagina ReadMe con ulteriori informazioni

  1. una pagina di licenza software

  1. una finestra di dialogo per accettare la licenza

  1. una pagina di conferma della posizione di installazione

  1. una pagina con il progresso dell'installazione (confermare autenticandosi)

  1. una pagina finale

Al termine dell'installazione una finestra di dialogo chiede se si vuole eliminare l'installer, spostarlo nel cestino per risparmiare spazio su disco.

Risoluzione dei problemi

  • Nel caso in cui la compilazione dei documenti dovesse dare un errore di tipo ENOENT, è necessario aggiungere il compilatore al PATH, per farlo aprire un terminale e scrivere:
nano $HOME/.zshrc

Nel file che si apre aggiungere alla fine la riga

export PATH="/usr/local/texlive/2024/bin/universal-darwin:$PATH"

Per sicurezza verificare il percorso, perchè la cartella 2024 cambia in base alla versione, mentre la cartella universal-darwin cambia in base, non solo alla versione, ma anche all'architettura del processore.
Dopo questo passaggio è consigliabile chiudere COMPLETAMENTE Visual Studio Code dal menù in alto a sinistra e riaprirlo, se non dovesse risolvere, riavviare il computer.

  • A volte, l'installatore visualizza una finestra di dialogo che dice “Verifica...” e poi l'installazione si blocca. In tutti i casi conosciuti, il riavvio del Macintosh risolve il problema. Dopo il riavvio, eseguire nuovamente l'installazione.
  • Se durante l'installazione vengono segnalati altri problemi, riferirsi alla sezione Errori di installazione della guida ufficiale.
  • MacTeX scrive un collegamento simbolico /Library/TeX/texbin che punta alla directory dei binari di TeX Live. Configurare i programmi GUI per utilizzare questo collegamento. I programmi GUI forniti si configurano automaticamente.

Linux e Unix

Per voi uomini temerari che non avete paura di usare un terminale, propongo i comandi per l'installazione su distribuzioni Debian-based:

sudo apt install texlive-science texlive-latex-extra latexmk texlive-extra-utils texlive-publishers texlive-science texlive-xetex

Visual Studio Code

Per la scrittura si userà Visual Studio Code, editor multipiattaforma estensibile con numerosi plug-in. D'ora in poi ci si riferirà ad esso col suo nome breve: vscode.

Installazione

Windows, MacOS e distribuzioni Linux senza snap

Per l'installazione su queste piattaforme si consiglia di seguire direttamente il sito del programma https://code.visualstudio.com/download.

Distribuzioni con snap

sudo snap install code --classic

Configurazione

Installato Visual Studio Code, seguire la configurazione guidata iniziale (è possibile saltare questo passaggio), una volta terminata, la schermata presentata sarà simile a questa.

Cliccare su per aprire il menu delle estensioni.

Nella barra di ricerca cercare Latex Workshop e premere su installa per avviare l'installazione. Terminata l'installazione aprire il menu delle azioni rapide con Ctrl + Alt + P (Cmd + Alt + P su MacOS).

Cercare "Open User Settings (JSON)" come in figura sopra e selezionare la voce.

Nella schermata che si apre incollare il contenuto del file my_settings.json presente nella cartella del progetto su GitHub https://github.com/a13ssandr0/TesiUnirc/blob/c610ac6218d6cdb98ae88a5b00fd51c0c3e25d69/my_settings.json

ATTENZIONE: Il file che si sta modificando è un file JSON, in quanto tale richiede alcuni semplici accorgimenti di sintassi. Se, come nella figura precedente, sono già presenti altre righe, dopo l'ultima è necessario aggiungere una virgola prima di incollare il resto delle impostazioni.

Il risultato finale dovrebbe essere qualcosa di simile a

Clone this wiki locally