Introduction

Dans le cadre de cette documentation, PDBfile (Physics Data Base Files) se réfère aux documents gérés par phystool. Il existe cinq types de PDBfile:

• Exercise: contient la donnée et la solution d’un exercice

• Theory: contient des éléments théorique

• QCM: contient une question à choix multiple

• TP: contient la notice de laboratoire ainsi que d’éventuelles informations complémentaires

• Figure: contient une figure \(\text{Ti}k{Z}\) standalone

Chaque PDBfile possède un uuid unique qui définit le nom des fichiers stockés sur le disque:

• .tex: source contenant le code \(\LaTeX\) crée par l’utilisateur

• .json: métadonnée contenant diverses informations dont les Tags permettant une recherche efficace

• .pdf: automatiquement compilé lorsque le PDBfile est sélectionné dans l’interface graphique

• .pty: automatiquement crée par certains PDBfile lors de la compilation avec les classes fournies dans phystex qui permettent l’exécution de code python depuis \(\LaTeX\)

Note

En pratique, ces fichiers ne devraient jamais être manipulé manuellement. C’est justement pour faciliter leur manipulation que phystool a été développé.

Comme chaque PDBfile géré par phystool est la source d’un fichier .pdf facilement accessible dans l’interface graphique, il est nécessaire de les rendre compilable par \(\LaTeX\). Or, à l’exception des Figure, les différents PDBfile n’héritent pas de \documentclass{standalone} et ne sont donc pas directement compilable. Pour contourner le problème et rendre la compilation des .pdf visibles dans l’interface graphique transparente pour l’utilisateur, phystool crée, lors de la compilation, un fichier temporaire qui inclut le fichier .tex du PDBfile.