(latex_config)=
# LaTeX

{{phystool}} est conçu de façon à laisser à l'utilisateur la liberté de compiler ses
documents {{latex}} comme il le souhaite. L'idée de base est de faire en sorte que
chaque {{pdbfile}} génère un {{pdf}} indépendant et puisse facilement être inclu dans
une série d'exercice, un test ou tout autre document. Si l'objectif est, par exemple, de
produire une série d'exercices, quelques lignes de code suffisent:

```{code-block} latex
    :linenos:
    :caption: serie-exercices.tex
    :name: exercise-sheet

    \documentclass[pdb=~/tuto_db]{physperso}

    \begin{document}
        \PdbExercise{9d1f2b06-fc3a-4eb4-8f7e-dadc8f0f0888}
        \PdbExercise{b7ac63e2-b44b-4848-9f15-9531c93c4e95}
    \end{document}
```

Ce fichier {{tex}} inclut deux {{pdbfile}} simplement en faisant référence à leur
{{uuid}}. Le contenu de l'un de ces fichiers est:

```{code-block} latex
    :linenos:
    :caption: 9d1f2b06-fc3a-4eb4-8f7e-dadc8f0f0888.tex

    \begin{exercise}{Eureka}
        Vérifiez que la période d’oscillation d'Archimède est indépendante de
        la température du chat de Schrödinger.
    \end{exercise}
```

Comme indiqué [précédemment](#definition_type), {{phystool}} est capable de déterminer
que ce fichier est de type `exercice` avec `Eureka` pour titre car son `parttern` match
la première ligne. {{phystool}} est aussi capable de le compiler indépendamment en
créant un fichier temporaire dont le contenu est:

```{code-block} latex
    :linenos:
    :caption: /tmp/physauto-9d1f2b06-fc3a-4eb4-8f7e-dadc8f0f0888.tex
    :name: physauto-temporary-file

    \documentclass{physauto}
    \PdbSetDBPath{~/tuto_db}
    \begin{document}
        \PdbPrint{9d1f2b06-fc3a-4eb4-8f7e-dadc8f0f0888}
    \end{document}

```

## En détail

Les {{pdbfile}} qui sont marqués `standalone=false` (par défaut), ne peuvent pas être
compilé directement et doivent donc être inclus avant compilation dans un fichier
temporaire. Ce [fichier temporaire](#physauto-temporary-file) est automatiquement crée
par {{phystool}} et possède toujours la même structure . Par contre, les fichiers
marqués `standalone=true`, peuvent être compilé tel quel et ne nécessitent donc pas de
fichier temporaire. 

```{important}
Pour que {{phystool}} puisse compiler les fichiers {{pdbfile}}, il doit avoir accès aux
classes et éventuels paquets personnels utilisés. C'est pour ces raisons que tous ces
fichiers doivent être placé dans le répertoire `phystex`.

Le bénéfice additionnel à cette centralisation est de faciliter le partage de documents.
```

```{important}
Afin de permettre à {{phystool}} de parser correctement les logs {{latex}}, il
faut légèrement modifier la configuration du compilateur afin que les logs
affichent des lignes plus longues. Pour cela, il suffit de modifier/rajouter la
ligne suivante au fichier `texmf.cnf`:

    max_print_line=1000
```

``` {note}
Lorsqu'un fichier est compilé avec {{phystool}}, les fichiers auxiliaires sont tous
placés dans des sous-répertoire de `~/.phystool/texaux/` reflétant le chemin du fichier
de base. Par exemple, les fichiers auxiliaires produit durant la compilation de
`~/travail/serie-exercies.tex` seront placés dans `~/.phystool/texaux/travail/`.
``` 

### Classe `auto_latex`

La classe `auto_latex` est la classe centrale sur laquelle repose la compilation de tous
les {{pdbfile}} non `standalone`. Le [fichier temporaire](#physauto-temporary-file) fait
appel à deux commandes qui doivent être définies dans cette classe:

`\PdbSetDBPath`
: Prend, comme argument obligatoire, le chemin absolu de la base de donnée afin de
l'assigner à une variable réutilisée lors de chaque inclusion. Un exemple d'une telle
commande peut être:

  ```{code} latex
    \NewDocumentCommand{\PdbSetDBPath}{m}{
	    \tl_gset:Nn \c_pdb_path_tl {#1}
    }
  ```

`\PdbInclude`
: Prend, comme argument obligatoire, le {{uuid}} du {{pdbfile}} afin d'inclure son
contenu {{tex}} dans le fichier parent. Cette commande peut s'écrire:

  ```{code} latex
    \NewDocumentCommand{\PdbInclude}{m}{
	    \group_begin:
		    \file_input:n {\c_pdb_path_tl #1.tex}
	    \group_end:
    }
  ```

```{important}
Comme le fichier temporaire crée lors de la compilation n'est pas modifiable par
l'utilisateur, il faut que la classe `auto_latex` contienne toutes les définitions,
commandes et environnement nécessaires. Dans l'exemple donnée, l'environnemnt `exercise`
doit aussi être définit.
```

### Classes personnelles

Dans l'exemple de [série d'exercices](#exercise-sheet), la classe `physperso`  prend
comme option le chemin de la base de donnée et définit la commande `\PdbExercise`. Cette
commande est similaire à la commande  `\PdbInclude` de `physauto` mais peut être
spécialisée pour l'inclusion d'exercices. Il suffit pour cela de définir un autre
comportement pour l'environnement `exercise`.

```{note}
En définissant habilement les classes {{latex}}, il est possible d'obtenir différents
rendus pour un même {{pdbfile}}. Par exemple, le rendu de l'environnement 'exercise'
peut être différent dans une série d'exercice, dans un test ou dans un polycopié.
Voici ma [configuration](https://bitbucket.org/jdufour/phystex/src/main/) en exemple.
```