Projets et fichiers

Un projet est un ensemble de fichiers conservés sur votre appareil, dont l’un est le fichier principal qui est composé. Vous pouvez importer tout un projet d’un coup en ouvrant un .zip ou un dossier, par exemple téléchargé depuis un autre éditeur LaTeX.

Ce qu’est un projet

Un projet contient tous les fichiers dont votre document a besoin : les sources .tex, un fichier .bib avec vos références, des images et des fichiers de données pour les courbes. Les fichiers peuvent être rangés dans des dossiers, comme chapters/intro.tex ou figures/plot.png.

Les projets sont enregistrés dans le stockage de votre navigateur sur cet appareil, un instant après chaque modification. Le panneau Projets les liste, du plus récent au plus ancien, et permet de les renommer, d’en changer ou de les supprimer. Supprimer un projet ici ne supprime jamais une copie que vous avez enregistrée dans Google Drive.

Le fichier principal

Un fichier .tex est le fichier principal : celui qui contient \documentclass et \begin{document}. C’est le fichier qui est composé, et il intègre les autres avec \input et \include. Le panneau Fichiers le marque avec principal.

Pour composer un autre fichier, ouvrez son menu dans le panneau Fichiers et choisissez Composer ce fichier, ou sélectionnez-le sous Fichier principal.

Un fichier principal avec une bibliographie

LaTeXCopierOuvrir dans l'éditeur (s’ouvre dans un nouvel onglet)

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

L’exemple ci-dessus a besoin d’un second fichier, refs.bib, dans le même projet. Ouvrez-le dans l’éditeur pour voir les deux fichiers. Pour en savoir plus sur les références, voir Bibliographies et citations.

Plusieurs fichiers .tex

Découpez un long document en un fichier par chapitre et intégrez-les au fichier principal. \input{chapters/intro} insère le fichier à l’endroit de la commande ; \include{chapters/intro} fait de même en commençant d’abord une nouvelle page. L’extension .tex peut être omise.

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

Dans l’onglet Problèmes, les erreurs d’un fichier inclus renvoient au bon fichier et à la bonne ligne. Voir Projets à plusieurs fichiers pour les détails, y compris ce qui se passe avec \includeonly et le paquet subfiles.

Ajouter des fichiers

Il existe plusieurs façons d’ajouter des fichiers au projet ouvert :

• Déposez des fichiers n’importe où sur l’éditeur.
• Dans le panneau Fichiers, utilisez Importer pour des fichiers ou Dossier pour tout un dossier de cet appareil.
• Utilisez Nouveau fichier pour créer un fichier vide. Tapez un chemin comme chapters/intro.tex pour le placer dans un dossier.
• Utilisez Drive ou Dossier de Google Drive pour ajouter des fichiers depuis votre Google Drive. Voir Enregistrer dans Google Drive.

Si le projet contient déjà un fichier du même nom, l’éditeur vous demande s’il faut le remplacer ou garder le vôtre.

L’éditeur accepte les fichiers .tex, .bib, .sty, .cls, .bst, .txt, .md, .csv et autres fichiers texte similaires, les images (PNG, JPG, SVG, PDF et quelques autres) et les fichiers .zip, qui sont décompressés.

Importer un projet depuis un .zip ou un dossier

La plupart des éditeurs LaTeX et toutes les installations TeX conservent un projet sous forme de dossier. Pour en importer un dans Scissor LaTeX :

1. Téléchargez le projet en .zip depuis l’autre éditeur, ou retrouvez son dossier sur votre ordinateur.
2. Dans Scissor LaTeX, choisissez Nouveau projet, puis Ouvrir des fichiers .tex ou .zip ou Ouvrir un dossier.
3. L’éditeur le décompresse, conserve sa structure de dossiers et choisit le fichier principal.

Quand il y a plus d’un document complet, l’éditeur préfère main.tex, puis un fichier portant le nom du dossier, puis celui dont le chemin est le plus court. Une note vous indique quel fichier il a choisi, et vous pouvez le changer sous Fichier principal.

Un dossier peut contenir jusqu’à 2,000 fichiers et 100 Mo. Quand un dossier est plus volumineux, les sources sont conservées en priorité et le reste est écarté et compté.

Fichiers dont le document a besoin mais qui manquent au projet

Après l’ouverture ou l’ajout de fichiers, l’éditeur vérifie ce à quoi votre document fait référence : images dans \includegraphics, fichiers .bib, fichiers dans \input et \include, et fichiers de données des courbes. S’il manque quelque chose, le panneau Fichiers le liste, avec des boutons pour l’importer ou l’ajouter depuis Drive. Un fichier que vous ajoutez sous son seul nom va là où le document l’attend : plot.png arrive dans figures/ si le document demande figures/plot.png.

En attendant, une image manquante est dessinée sous forme de cadre en pointillés avec son nom, et l’onglet Problèmes indique quelles images manquent.

Une image dans le projet, une manquante

LaTeXPréambule : \usepackage{graphicx}CopierOuvrir dans l'éditeur (s’ouvre dans un nouvel onglet)

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

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

Onglet Problèmes : Images not in the project: figures/missing.png

Vos propres fichiers .sty et .cls

Un projet peut contenir ses propres fichiers .sty et .cls : ils sont conservés, enregistrés dans Drive et exportés avec le projet. L’aperçu ne les lit cependant pas encore. Un \usepackage{mymacros} qui désigne votre propre fichier est signalé dans l’onglet Problèmes comme un paquet non disponible, et les commandes qui y sont définies sont ignorées.

En attendant, copiez les lignes \newcommand et \newenvironment dont vous avez besoin depuis votre fichier .sty dans le préambule du fichier principal. Elles y fonctionnent, et le document se compile toujours dans une installation 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}

Ce qui diffère d’une installation TeX

Chaque exemple de cette page est composé par Scissor LaTeX lors de la génération du site. Dernière mise à jour : 2026-11-07.