LaTeX-ENSPS/README.md

# Paquet LaTeX de l'École normale supérieure Paris-Saclay



<div align="center">
  <img title="Logo du paquet ensps.sty" alt= "Logo du paquet LaTeX ensps.sty" src="eps/ensps_sty_logo.png">
</div>

-----------------

## Installation

### Pour utiliser le rapport et le paquet

Télécharger le dossier, le placer dans le sous-dossier de votre choix et modifier uniquement le fichier ```rapport.tex```. Vous pouvez retirer le fichier ```README.md``` et le fichier de licence.

### Pour un petit compte rendu

Idem, mais utilisé ```rapport_lite.tex```, qui ne contient pas d'abstract.

### Pour utiliser seulement le paquet

Copier le fichier ```ensps.sty``` dans le répertoire de votre propre rapport et utiliser le dans le code de votre fichier ```tex``` avec la commande suivante, à insérer dans le préambule :
```latex
\usepackage{ensps}
```

## Commandes utiles

### Actions basiques

- Pour insérer une image : utiliser la commande fournie en exemple dans le rapport, modifier la taille de l'image avec *width = ...* soit par exemple *width=1\textwidth*
```latex
\begin{figure}[ht!]
    \centering
    \includegraphics[width=1\textwidth]{example-image-a}
    \caption{Insérer ici le sous-titre.}
    \label{fig:id-de-la-figure}
\end{figure}
```


- Pour faire référence à une figure : utiliser ```\reff{fig:id-de-la-figure}```

- Pour faire référence à une référence bibliographique ```\citee{fig:id-de-la-ref}```

- Pour taper bêtement un nombre : vous pouvez le faire normalement comme 123, ou utiliser la commande ```\num{nombre}``` comme ```\num{2e-6}```

- Pour taper des quantités physiques : utiliser la commande ```\SI{nombre}{unités}```, par exemple comme ```e = \SI{1e-2}{m.kg^2/s}```

- Pour mettre en evidence un résultat : utilise l'environement ```cadregris```
```tex/tips-topten
\begin{cadregris}

RESULTAT

\end{cadregris}
```

### Insertion de code

- Pour insérer du code : soit avec ```listing``` soit avec ```minted```. Attention : pour utiliser ```minted``` il vous faudra soit utiliser *Overleaf* (qui est très permissif niveau compilation), soit compiler ```pdflatex``` avec l'option ```--shell-escape```. Reportez-vous à la doc de votre éditeur LaTeX pour plus d'informations ;

- Pour ```minted```, on a le choix entre mettre le contenu directement dans le ```.tex``` ou dans un fichier à part :
    - avec le code dans le ```.tex``` , on utilise l'environement de base de ```minted``` ,

    - Ou bien on utilise la commande ``` \inputminted```, 

``` tex
\begin{minted}[linenos, breaklines]{python}
print("hello word")
\end{minted}
\captionof {listing}{Code python basique \label{lst:HW}}
```
    
``` tex
\inputminted[linenos, breaklines]{python}{hello_world.py}
\captionof {listing}{Code python basique \label{lst:HW}}
```

- On n'utilise pas l'environement ```listings``` classqieu, car si le code est trop long, il ne peut pas s'etendre sur plusieur pages. Grace à ```\captionof```, les extrait de code seront tout de même bien numérotés.

### Macros

- ```\subt{texte en dessous}``` permet d'écrire proprement un indice de notation (donc pas une variable). Par exemple T_c signifie << température chaude >>, c n'est pas une variable mais bien l'abréviation de chaud. Il faut donc noter ```T\sub{c}```

- ```\supt{texte au dessus}``` permet d'écrire de la même façon un indice supérieur : filtre non-causal ```W\sub{nc}```

- ```\ud``` permet d'écrire proprement une différentielle (avec une espace avant le d), par exemple dans une intégrale : ```\int f(x) \ud x```

- ```\derd{f}{x}``` permet de taper la dérivée droite de la fonction ```f``` par rapport à ```x```

- ```\derp{f}{x}``` permet de taper la dérivée partielle de la fonction ```f``` par rapport à ```x```

- les opérateurs différentiels tels que rot ou div sont disponibles. Notez que ces commandes sont compatibles avec le paquet ```physics```.

- 
## Ressources utiles (et pour aller plus loin)

- un peu de typographie française ;
- 10 règles fondamentales en LaTeX disponible [ici](https://faculty.math.illinois.edu/~hildebr/tex/tips-topten.html) ;
- La [charte graphique de l'ENS](http://intranet.ens-paris-saclay.fr/servlet/com.univ.collaboratif.utils.LectureFichiergw?CODE_FICHIER=1513867394649&ID_FICHE=176742)

## Comment contribuer ?

- contactez-moi pour devenir un collaborateur du projet;
- ou aller travailler sur le [projet initial](https://github.com/XeBasTeX/LaTeX-ECL).

## Crédits

Je tiens à remercier en particulier, par ordre chornologique de contributions dans le projet :
- Nicolas Gameiro dont la première feuille de style a fourni une excellente base pour la suite ;
- Gauthier Fanucci dont le rapport de PAr a permis de tirer quelques *features* intéressantes ;
- l'équipe de la PAO mandat 2019 - 2020 et plus spécialement Yann Zerrouk, Olivia Jeanne et Blaise (chais-pas-ton-nom déso) pour leurs chtites contributions ;
- les bêta-testeurs du code, à savoir personne.

## À propos de l'auteur

Bastien Laville dit le Makzer (ancien président de la PAO mandat 2018 - 2019) en 3A à l'ECL.

Léopold Clément, adaptation à l'ENS du plateau de Saclay

## Distribution et licence

Licence [MIT](https://choosealicense.com/licenses/mit/) - Bastien @ PAO