Skip to content

Commit c041a4f

Browse files
wismillfabi1cazenaveNuclear-Squid
authored
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]>
1 parent 1d58092 commit c041a4f

File tree

4 files changed

+132
-1
lines changed

4 files changed

+132
-1
lines changed

‎www/assets/css/theme.css

+5
Original file line numberDiff line numberDiff line change
@@ -140,6 +140,11 @@ ol, ul {
140140
margin-left: 0;
141141
}
142142

143+
.dialog > ul {
144+
list-style-type: "— ";
145+
padding-left: 2ch;
146+
}
147+
143148
dd {
144149
margin-left: var(--list-indent);
145150
padding-left: 0;

‎www/content/faq.md

+70
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,70 @@
1+
+++
2+
title = "Foire aux questions"
3+
+++
4+
5+
**🚧 En construction 🚧**
6+
7+
<style>
8+
h4 {
9+
font-size: 1.1rem;
10+
}
11+
</style>
12+
13+
Cette page apporte des réponses aux questions les plus fréquentes. N’hésitez pas
14+
à nous rejoindre sur [le serveur Discord Ergo‑L](https://discord.gg/5xR5K3nAFX)
15+
pour en savoir davantage !
16+
17+
18+
Projet et site web
19+
--------------------------------------------------------------------------------
20+
21+
#### Que veut dire \[…\] ?
22+
23+
Certains termes sont spécifiques à la création de dispositions clavier ou à la
24+
typographie. Notre [glossaire] permet d’y voir plus clair.
25+
26+
27+
#### D’où vient le nom « Ergo‑L » ?
28+
29+
Ergo‑L signifie « **Ergo**nomic **L**afayette », le projet ayant démarré comme
30+
un fork de [QWERTY-Lafayette] visant à lui apporter une optimisation de type
31+
Colemak/Workman. Il se prononce « ergol », comme le nom générique des carburants
32+
de moteurs-fusées.
33+
34+
#### Pourquoi tous ces 🦆 ?
35+
36+
::: {.dialog}
37+
- Coin coin ?
38+
- Ook, ook. Ook !
39+
:::
40+
41+
Pilotes
42+
--------------------------------------------------------------------------------
43+
44+
### Linux
45+
46+
#### Ma disposition clavier ne fonctionne plus. Que faire ?
47+
48+
Cela peut arriver après une mise à jour. Il vous suffit de la réinstaller avec
49+
[XKalamine]. Notez qu’il existe d’[autres méthodes][xkb-custom] plus robustes.
50+
51+
#### Pourquoi la touche [★]{.odk} fonctionne-t-elle en la maintenant pressée, alors que c’est une [touche morte] ?
52+
53+
Bien que la touche [★]{.odk} soit qualifiée de [touche morte], elle est
54+
implémentée en utilisant un modificateur dit « _latch_ », qui s’utilise de deux
55+
façons :
56+
57+
- soit en _relachant_ [★]{.odk} avant de taper la touche correspondant au
58+
caractère composé ;
59+
- soit en _maintenant_ [★]{.odk} enfoncée en tapant cette touche.
60+
61+
Exemple pour Ergo‑L :
62+
63+
- [★]{.kbd} [A]{.kbd} → `à`
64+
- [★]{.kbd} (maintien) [A]{.kbd} [★]{.kbd} (relâche) → `à`
65+
66+
[glossaire]: /glossaire
67+
[touche morte]: /glossaire#touche-morte-def
68+
[QWERTY-Lafayette]: /lafayette/#qwerty-lafayette
69+
[XKalamine]: https://github.com/OneDeadKey/kalamine#xkalamine
70+
[xkb-custom]: https://github.com/OneDeadKey/kalamine#linux-root-xkb_symbols

‎www/content/ressources.md

+48
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
+++
2+
title = "Ressources"
3+
+++
4+
5+
Perdu·e dans la galaxie des dispositions clavier ?<br>
6+
Une panne dans la propulsion ?
7+
8+
:::{.highlight}
9+
Cartographie des dispositions clavier
10+
11+
: Notre constellation : **[Ergo‑L](/presentation)**, [Erglace](/erglace), [QWERTY-Lafayette](/lafayette)
12+
13+
: Une planète de pionniers : [Bépo](/bepo)
14+
15+
: Préparer votre voyage avec le **[comparatif](/alternatives#tableau-comparatif)**
16+
17+
[Glossaire](/glossaire)
18+
19+
: Ne naviguez pas à vue, utilisez le radar des **définitions** des termes difficiles
20+
21+
[Foire aux questions](/faq)
22+
23+
: Accédez à toute la sagesse des Ergonautes avec les réponses aux **questions
24+
fréquentes**
25+
26+
[Serveur Discord](https://discord.gg/5xR5K3nAFX)
27+
28+
: Pour **dialoguer** directement avec la communauté : entraide, technique et fun !
29+
30+
Les outils
31+
32+
: [DuckTypist](/dactylo) : pour **apprendre** à votre rythme nos dispositions
33+
clavier
34+
35+
: [Kalamine] : pour **personaliser** facilement votre disposition clavier
36+
37+
Un bug à signaler, une amélioration à proposer ?
38+
39+
: Les questions liées aux **pilotes** et au **site web** sont à formuler sur le
40+
[dépôt de code Ergo‑L](https://github.com/Nuclear-Squid/ErgoL) — en français ou
41+
en anglais, à votre convenance.
42+
43+
: Les questions liées aux **outils**, en particulier [Kalamine], sont à formuler
44+
sur les [dépôts de code OneDeadKey](https://github.com/OneDeadKey) — de préférence
45+
en anglais.
46+
:::
47+
48+
[Kalamine]: https://github.com/OneDeadKey/kalamine

‎www/hugo.toml

+9-1
Original file line numberDiff line numberDiff line change
@@ -90,10 +90,18 @@ author = "authors"
9090
name = "Analyseur"
9191
pageRef = "/stats"
9292
weight = 4
93+
[[menus.main]]
94+
name = "FAQ / Ressources"
95+
pageRef = "/ressources"
96+
weight = 5
97+
[[menus.main]]
98+
name = "FAQ"
99+
pageRef = "/faq"
100+
parent = "FAQ / Ressources"
93101
[[menus.main]]
94102
name = "Glossaire"
95103
pageRef = "/glossaire"
96-
weight = 5
104+
parent = "FAQ / Ressources"
97105
[[menus.main]]
98106
name = "Apprendre"
99107
pageRef = "/dactylo"

0 commit comments

Comments
 (0)