Synthèses de l'EPL

Documentation	PDF	Chat	Forum	Git

Les documents présents sur ce repository sont des documents mis à disposition pour les étudiants de l'EPL.

Visualisation des synthèses et correctifs

Les .pdf des synthèses et correctifs dans leur dernière version sont disponibles ici.

Documentation

Ce README donne quelques premières indications quant à l'utilisation de ce repository. Pour de plus amples informations, voir le document How_to_Contribute ou le wiki.

Comment contribuer

La façon la plus simple de contribuer est de suggérer des améliorations en soumettant une issue sur le bug tracker. Même pour une simple faute d'orthographe, ça vaut la peine de le signaler.

Vous pouvez aussi directement modifier le code et nous le soumettre en utilisant git, voir le document How_to_Contribute.pdf pour une explication rapide. Pour une explication plus détaillée, lisez la partie Utilisation linéaire de Git de ce tutoriel écrit par Benoît Legat. Voir aussi le wiki à ce sujet.

Nous vous recommandons d'utiliser le système des branches de Git, qui permettent d'avoir en parallèle des changements différents sur des documents différents (par exemple, un changement sur la synthèse de physique 1 et un ajout d'examen en algèbre), avec la possibilité de facilement passer d'un groupe de changements à l'autre, et d'ainsi ouvrir plusieurs pull requests, une par groupe de changements/thématique. Cela vous permettra aussi de garder une branche master propre et qui peut facilement être mise à jour avec ce repository (fast-forward).

Vous pouvez visualiser le statut des différentes synthèses ici. N'hésitez pas à en rajouter dans la liste :)

Compiler automatiquement les documents en PDF

Vous pouvez compiler automatiquement tous les documents dans leur destination (le dossier où se trouve le fichier .tex) en tapant en ligne de commande à la racine du repository (dossier Syntheses):

make pdf pour supprimer les fichiers de compilation
make pour laisser les fichiers de compilation
make release pour compiler et copier les documents automatiquement dans un dossier de destination à part, que vous aurez préalablement choisi en inscrivant le chemin absolu du dossier dans le fichier compilation.yml (copier et renommer compilation.example.yml en compilation.yml)

License

Sauf mention expresse, vous licensiez sous license CC-BY-SA 4.0 tout le contenu que vous soumettez pour inclusion dans ce dépot.

Si cette license vous pose problème, venez en discuter en ouvrant une issue.

pgonzalezalv/Syntheses