Progetti e file

Un progetto è un insieme di file conservati sul tuo dispositivo, uno dei quali è il file principale che viene impaginato. Puoi importare un intero progetto in una volta aprendo un .zip o una cartella, per esempio uno scaricato da un altro editor LaTeX.

Che cos’è un progetto

Un progetto contiene tutti i file di cui il tuo documento ha bisogno: i sorgenti .tex, un file .bib con i tuoi riferimenti bibliografici, le immagini e i file di dati per i grafici. I file possono trovarsi in cartelle, come chapters/intro.tex o figures/plot.png.

I progetti vengono salvati nella memoria del browser su questo dispositivo, un attimo dopo ogni modifica. Il pannello Progetti li elenca, dal più recente, e ti permette di rinominarli, passare dall’uno all’altro o eliminarli. Eliminare un progetto qui non elimina mai una copia che hai salvato su Google Drive.

Il file principale

Un file .tex è il file principale: quello con \documentclass e \begin{document}. È il file che viene impaginato, e include gli altri con \input e \include. Il pannello File lo contrassegna con principale.

Per impaginare un altro file, apri il suo menu nel pannello File e scegli Impagina questo file, oppure selezionalo in File principale.

Un file principale con una bibliografia

LaTeXCopiaApri nell'editor (si apre in una nuova scheda)

\documentclass{article}
\begin{document}
\section{Background}
Long tables are discussed by \cite{mustermann2021}.
\bibliographystyle{plain}
\bibliography{refs}
\end{document}

L’esempio qui sopra ha bisogno di un secondo file, refs.bib, nello stesso progetto. Aprilo nell’editor per vedere entrambi i file. Maggiori informazioni sui riferimenti in Bibliografie e citazioni.

Più file .tex

Dividi un documento lungo in un file per capitolo e includili nel file principale. \input{chapters/intro} inserisce il file nel punto in cui si trova il comando; \include{chapters/intro} fa lo stesso ma prima inizia una nuova pagina. L’estensione .tex si può omettere.

\documentclass{report}
\begin{document}
\include{chapters/intro}
\include{chapters/method}
\input{appendix}
\end{document}

Gli errori in un file incluso rimandano al file e alla riga giusti nella scheda Problemi. Vedi Progetti con più file per i dettagli, compreso cosa succede con \includeonly e con il pacchetto subfiles.

Aggiungere file

Ci sono diversi modi per aggiungere file al progetto aperto:

• Trascina i file in un punto qualsiasi dell’editor.
• Nel pannello File, usa Carica per i file o Cartella per un’intera cartella da questo dispositivo.
• Usa Nuovo file per creare un file vuoto. Scrivi un percorso come chapters/intro.tex per metterlo in una cartella.
• Usa Drive o Cartella da Google Drive per aggiungere file dal tuo Google Drive. Vedi Salvare su Google Drive.

Se il progetto contiene già un file con lo stesso nome, l’editor chiede se sostituirlo o tenere il tuo.

L’editor accetta file .tex, .bib, .sty, .cls, .bst, .txt, .md, .csv e file di testo simili, immagini (PNG, JPG, SVG, PDF e pochi altri formati) e file .zip, che vengono estratti.

Importare un progetto da un .zip o da una cartella

La maggior parte degli editor LaTeX e ogni installazione TeX conservano un progetto come cartella. Per portarne uno in Scissor LaTeX:

1. Scarica il progetto come .zip dall’altro editor, oppure trova la sua cartella sul tuo computer.
2. In Scissor LaTeX, scegli Nuovo progetto, poi Apri file .tex o .zip o Apri una cartella.
3. L’editor lo estrae, mantiene la sua struttura di cartelle e sceglie il file principale.

Quando c’è più di un documento completo, l’editor preferisce main.tex, poi un file con lo stesso nome della cartella, poi quello con il percorso più breve. Una nota ti dice quale file ha scelto, e puoi cambiarlo in File principale.

Una cartella può contenere fino a 2,000 file e 100 MB. Quando una cartella è più grande, vengono tenuti prima i sorgenti e il resto viene escluso e contato.

File di cui il documento ha bisogno ma che mancano nel progetto

Dopo che apri o aggiungi file, l’editor controlla a cosa fa riferimento il tuo documento: immagini in \includegraphics, file .bib, file in \input e \include, e file di dati dei grafici. Se manca qualcosa, il pannello File lo elenca, con pulsanti per caricarlo o aggiungerlo da Drive. Un file che aggiungi con il solo nome finisce dove il documento se lo aspetta, quindi plot.png va in figures/ se il documento chiede figures/plot.png.

Fino ad allora, un’immagine mancante viene disegnata come un riquadro tratteggiato con il suo nome, e la scheda Problemi indica quali immagini mancano.

Un’immagine nel progetto, una mancante

LaTeXPreambolo: \usepackage{graphicx}CopiaApri nell'editor (si apre in una nuova scheda)

\includegraphics[width=0.45\linewidth]{figures-plot.png}

\includegraphics[width=0.45\linewidth]{figures/missing.png}

Scheda Problemi: Images not in the project: figures/missing.png

I tuoi file .sty e .cls

Un progetto può contenere i propri file .sty e .cls: vengono conservati, salvati su Drive ed esportati con il progetto. L’anteprima però non li legge ancora. Un \usepackage{mymacros} che indica un tuo file viene segnalato nella scheda Problemi come pacchetto non disponibile, e i comandi definiti al suo interno vengono saltati.

Finché le cose non cambiano, copia le righe \newcommand e \newenvironment che ti servono dal tuo file .sty nel preambolo del file principale. Lì funzionano, e il documento si compila comunque in un’installazione TeX.

\documentclass{article}
% from mymacros.sty
\newcommand{\project}{River Survey}
\newcommand{\unit}[1]{\,\mathrm{#1}}
\begin{document}
The \project{} measured a flow of $44\unit{m^3/s}$.
\end{document}

In cosa differisce da un’installazione TeX

Ogni esempio di questa pagina viene composto da Scissor LaTeX quando il sito viene generato. Ultimo aggiornamento: 2026-11-07.