Doc: Add FAQ (#151)

* doc: Add FAQ

* Review fixes

* Ook

Co-authored-by: Fabien Cazenave <[email protected]>

* Une vraie page d’aide comme il faut

* Cartographie des dispositions clavier

* Review fixes

* Move help page to root

* Améliorations diverses

---------

Co-authored-by: Fabien Cazenave <[email protected]>
Co-authored-by: Léo Cazenave <[email protected]>

www/assets/css/theme.css

@@ -140,6 +140,11 @@ ol, ul {
   margin-left: 0;
 }
 
+.dialog > ul {
+  list-style-type: "— ";
+  padding-left: 2ch;
+}
+
 dd {
   margin-left: var(--list-indent);
   padding-left: 0;

www/content/faq.md

@@ -0,0 +1,70 @@
++++
+title = "Foire aux questions"
++++
+
+**🚧 En construction 🚧**
+
+<style>
+h4 {
+    font-size: 1.1rem;
+}
+</style>
+
+Cette page apporte des réponses aux questions les plus fréquentes. N’hésitez pas
+à nous rejoindre sur [le serveur Discord Ergo‑L](https://discord.gg/5xR5K3nAFX)
+pour en savoir davantage !
+
+
+Projet et site web
+--------------------------------------------------------------------------------
+
+#### Que veut dire \[…\] ?
+
+Certains termes sont spécifiques à la création de dispositions clavier ou à la
+typographie. Notre [glossaire] permet d’y voir plus clair.
+
+
+#### D’où vient le nom « Ergo‑L » ?
+
+Ergo‑L signifie « **Ergo**nomic **L**afayette », le projet ayant démarré comme
+un fork de [QWERTY-Lafayette] visant à lui apporter une optimisation de type
+Colemak/Workman. Il se prononce « ergol », comme le nom générique des carburants
+de moteurs-fusées.
+
+#### Pourquoi tous ces 🦆 ?
+
+::: {.dialog}
+- Coin coin ?
+- Ook, ook. Ook !
+:::
+
+Pilotes
+--------------------------------------------------------------------------------
+
+### Linux
+
+#### Ma disposition clavier ne fonctionne plus. Que faire ?
+
+Cela peut arriver après une mise à jour. Il vous suffit de la réinstaller avec
+[XKalamine]. Notez qu’il existe d’[autres méthodes][xkb-custom] plus robustes.
+
+#### Pourquoi la touche [★]{.odk} fonctionne-t-elle en la maintenant pressée, alors que c’est une [touche morte] ?
+
+Bien que la touche [★]{.odk} soit qualifiée de [touche morte], elle est
+implémentée en utilisant un modificateur dit « _latch_ », qui s’utilise de deux
+façons :
+
+- soit en _relachant_ [★]{.odk} avant de taper la touche correspondant au
+  caractère composé ;
+- soit en _maintenant_ [★]{.odk} enfoncée en tapant cette touche.
+
+Exemple pour Ergo‑L :
+
+- [★]{.kbd} [A]{.kbd} → `à`
+- [★]{.kbd} (maintien) [A]{.kbd} [★]{.kbd} (relâche) → `à`
+
+[glossaire]:        /glossaire
+[touche morte]:     /glossaire#touche-morte-def
+[QWERTY-Lafayette]: /lafayette/#qwerty-lafayette
+[XKalamine]:        https://github.com/OneDeadKey/kalamine#xkalamine
+[xkb-custom]:       https://github.com/OneDeadKey/kalamine#linux-root-xkb_symbols

www/content/ressources.md

@@ -0,0 +1,48 @@
++++
+title = "Ressources"
++++
+
+Perdu·e dans la galaxie des dispositions clavier ?<br>
+Une panne dans la propulsion ?
+
+:::{.highlight}
+Cartographie des dispositions clavier
+
+: Notre constellation : **[Ergo‑L](/presentation)**, [Erglace](/erglace), [QWERTY-Lafayette](/lafayette)
+
+: Une planète de pionniers : [Bépo](/bepo)
+
+: Préparer votre voyage avec le **[comparatif](/alternatives#tableau-comparatif)**
+
+[Glossaire](/glossaire)
+
+: Ne naviguez pas à vue, utilisez le radar des **définitions** des termes difficiles
+
+[Foire aux questions](/faq)
+
+: Accédez à toute la sagesse des Ergonautes avec les réponses aux **questions
+fréquentes**
+
+[Serveur Discord](https://discord.gg/5xR5K3nAFX)
+
+: Pour **dialoguer** directement avec la communauté : entraide, technique et fun !
+
+Les outils
+
+: [DuckTypist](/dactylo) : pour **apprendre** à votre rythme nos dispositions
+clavier
+
+: [Kalamine] : pour **personaliser** facilement votre disposition clavier
+
+Un bug à signaler, une amélioration à proposer ?
+
+: Les questions liées aux **pilotes** et au **site web** sont à formuler sur le
+[dépôt de code Ergo‑L](https://github.com/Nuclear-Squid/ErgoL) — en français ou
+en anglais, à votre convenance.
+
+: Les questions liées aux **outils**, en particulier [Kalamine], sont à formuler
+sur les [dépôts de code OneDeadKey](https://github.com/OneDeadKey) — de préférence
+en anglais. 
+:::
+
+[Kalamine]: https://github.com/OneDeadKey/kalamine

www/hugo.toml

@@ -90,10 +90,18 @@ author = "authors"
         name    = "Analyseur"
         pageRef = "/stats"
         weight  = 4
+    [[menus.main]]
+        name    = "FAQ / Ressources"
+        pageRef = "/ressources"
+        weight  = 5
+    [[menus.main]]
+        name    = "FAQ"
+        pageRef = "/faq"
+        parent  = "FAQ / Ressources"
     [[menus.main]]
         name    = "Glossaire"
         pageRef = "/glossaire"
-        weight  = 5
+        parent  = "FAQ / Ressources"
     [[menus.main]]
         name    = "Apprendre"
         pageRef = "/dactylo"