summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBenjamin Chausse <benjamin@chausse.xyz>2022-01-28 12:04:02 -0500
committerBenjamin Chausse <benjamin@chausse.xyz>2022-01-28 12:04:02 -0500
commit949e8cdd1aaecf32a4424f12f7f8cc1575fd8899 (patch)
tree015013165491815ceee75a42806e9e3ae235adfa
parenta003bb491b8897e85844eb17aea1f6a948fbf978 (diff)
Extensible README structure
-rw-r--r--README.md34
1 files changed, 25 insertions, 9 deletions
diff --git a/README.md b/README.md
index 0da32cf..c9995ec 100644
--- a/README.md
+++ b/README.md
@@ -10,21 +10,37 @@ d'interlignes, etc...). Il importe aussi une multitudes de packages utiles en
génie (par exemple: `siunitx` rend facile le formattage d'unités
internationales).
-La branche `master` est encombrante à utiliser puisqu'elle contient de
-`README`, un exemple de pdf précompilé, ainsi que le pdf des réglementations au
-sujet des normes de formattage de documents en génie. De ce fait, je recommande
-d'utiliser la branche `template` pour initialiser vos projets:
+Comment utiliser ce gabarit:
+----------------------------
+
+La branche `master` est encombrante à utiliser puisqu'elle contient de `README`
+et d'autres fichiers qui n'ont pas besoin d'être copié dans un nouveau projet.
+De ce fait, je recommande d'utiliser la branche `template` pour initialiser vos
+projets. Elle ne contient que l'essentiel:
```
git clone -b template https://git.chausse.xyz/sherbrooke-tex now-de-votre-projet
```
-Il peut aussi être utile de garder de repo hors ligne pour faciliter son
+Il peut aussi être utile de garder le repo hors ligne pour faciliter son
utilisation comme gabarit. Ainsi, je recommande le prodédé suivant:
-```
-# Création du gabarit hors-ligne dans un dossier nommé gabarit:
-git clone https://git.chausse.xyz/sherbrooke-tex ~/gabarit
+```sh
+# Choisissez l'emplacement et le nom du dossier pour le gabarit ici:
+path="~/gabarit"
+
+# Création du gabarit hors-ligne dans le dossier choisi:
+git clone https://git.chausse.xyz/sherbrooke-tex $path
+
# Copie du gabarit lors de la création d'un nouveau projet:
-git clone -b template ~/gabarit
+git clone -b template $path
```
+
+Autres informations utiles
+--------------------------
+
+Le gabarit est basé sur les information contenues dans le protocole de
+rédaction aux études supérieures de la faculté. Afin d'en rendre son accès
+facile, je l'ai inclus dans le repo (`Protocole_Redaction_ESup.pdf`). S.V.P.
+faites une PR si je m'avère à être dans le tort dans ce gabarit. PAS DE ISSUES!
+S'il y a un problème, ayez une solution avant de m'en parler.