... | @@ -303,6 +303,27 @@ Dans une page : liste des sections = Table of Content |
... | @@ -303,6 +303,27 @@ Dans une page : liste des sections = Table of Content |
|
|
|
|
|
Les **hyperliens** permettent de naviguer entre les pages et entre les headers si on leur a ajouté des signets (="anchor"), non testé
|
|
Les **hyperliens** permettent de naviguer entre les pages et entre les headers si on leur a ajouté des signets (="anchor"), non testé
|
|
|
|
|
|
|
|
#### Personnaliser la barre latérale, ou sidebar
|
|
|
|
La barre latérale est bien pratique pour naviguer dans le site, mais la barre par défaut liste simplement les pages disponibles par ordre alphabétique.
|
|
|
|
Il est possible de créer une barre personnalisée, en markdown avec des titres et des séparateurs, en plaçant les pages dans l'ordre que l'on souhaite, avec des liens.
|
|
|
|
Cette manip impose des contraintes sur le nom des pages, et demande un peu de prudence.
|
|
|
|
En effet, une fois la sidebar créée en appuyant sur <kbd>Edit sidebar</kbd>, on n'a plus accès qu'aux pages correctement référencées. En particulier, il faut que la side-bar elle-même soit référencée pour y accéder facilement, sinon il faut se souvenir qu'on y accède via (`_sidebar.md`).
|
|
|
|
Les consignes sont donc rappelées ci-dessous, ainsi que les deux moyens de récupérer l'accès à toutes les pages en cas de fausse manip.
|
|
|
|
|
|
|
|
##### s'assurer que les noms de pages seront bien compris
|
|
|
|
Comme mentionné plus haut, une page non ou mal référencée dans la sidebar n'est plus accessible facilement. Pour éviter de "perdre" une page, il faut respecter deux bonnes pratiques :
|
|
|
|
- les noms de page ne peuvent contenir certains caractères, comme ":" et les délimiteurs qui pourraient interférer avec ceux des liens, comme "(" ;
|
|
|
|
- la création d'une nouvelle page doit d'abord passer par l'ajout de sa référence dans la sidebar, `[description](titre_de_page)` ; il suffit ensuite de cliquer sur le lien ou de taper le nom sous forme d'URL pour y accéder et commencer à la rédiger.
|
|
|
|
|
|
|
|
##### savoir récupérer une page "perdue"
|
|
|
|
Une page non référencée peut rester accessible :
|
|
|
|
- si on se souvient de son nom, on peut essayer de reconstituer l'URL ;
|
|
|
|
- en clonant le dépôt du wiki on récupère en bloc toutes les pages ;
|
|
|
|
- il suffit d'effacer la sidebar customisée ($`\textcolor{red}{Delete page}`$, si possible après avoir copié son contenu[^1] pour récupérer ce qui peut l'être, pour qu'une sidebar par défaut se recrée, avec l'ensemble des références vers toutes les pages, même celles dont le nom posait problème à la sidebar customisée.
|
|
|
|
|
|
|
|
[^1] on peut copier le contenu dans un fichier en local ou dans une page dont le nom commence par _sidebar et dont on se souviendra, comme _sidebar_copie.md par exemple.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### liens hypertexte
|
|
### liens hypertexte
|
|
- Liens externes
|
|
- Liens externes
|
... | | ... | |