Documentation | Chat | Forum | Git | |
---|---|---|---|---|
Les documents présents sur ce repository sont des documents mis à disposition pour les étudiants de l'EPL.
Les .pdf
des synthèses et correctifs dans leur dernière version sont disponibles
ici.
Ce README donne quelques premières indications quant à l'utilisation de ce repository. Pour de plus amples informations, voir le guide pour les nouveaux contributeurs ou le wiki.
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
; le guide pour les nouveaux contributeurs
donne une explication rapide de comment faire cela.
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 :)
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 compilationmake
pour laisser les fichiers de compilationmake 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 fichiercompilation.yml
(copier et renommercompilation.example.yml
encompilation.yml
)
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.