... | @@ -152,7 +152,7 @@ Astuce : le site [**pandoc**](https://pandoc.org/try/) pour convertir d'une synt |
... | @@ -152,7 +152,7 @@ Astuce : le site [**pandoc**](https://pandoc.org/try/) pour convertir d'une synt |
|
|
|
|
|
a) exemple simple (markdown seul)
|
|
a) exemple simple (markdown seul)
|
|
|
|
|
|
### *V* = *K*<sub>*s*</sub>.*R*<sub>*h*</sub><sup>(2/3)</sup>.*i* <sup>(1/2)</sup>
|
|
*V* = *K*<sub>*s*</sub>.*R*<sub>*h*</sub><sup>(2/3)</sup>.*i* <sup>(1/2)</sup>
|
|
{: .alert .alert-info .text-center}
|
|
{: .alert .alert-info .text-center}
|
|
|
|
|
|
où:
|
|
où:
|
... | @@ -207,13 +207,13 @@ Certaines emoji **parlent d'elles-mêmes** et servent à attirer l'attention : |
... | @@ -207,13 +207,13 @@ Certaines emoji **parlent d'elles-mêmes** et servent à attirer l'attention : |
|
|
|
|
|
Si vous voulez en faire un usage plus large, prenez la peine de les expliquer : par exemple j'utilise :snake: et :chart_with_upwards_trend: pour distinguer dans mon Atelier Python ce qui relève de Python en général ( :snake:) et ce qui est spécifique à matplotlib (:chart_with_upwards_trend:). Sans explication, ça n'est pas évident, mais ensuite cela aide à se repérer.
|
|
Si vous voulez en faire un usage plus large, prenez la peine de les expliquer : par exemple j'utilise :snake: et :chart_with_upwards_trend: pour distinguer dans mon Atelier Python ce qui relève de Python en général ( :snake:) et ce qui est spécifique à matplotlib (:chart_with_upwards_trend:). Sans explication, ça n'est pas évident, mais ensuite cela aide à se repérer.
|
|
|
|
|
|
#### Structurer le wiki
|
|
### Structurer le wiki
|
|
Certains auteurs recommandent de tout mettre dans une page, ce qui facilite l'édition d'une table des matières et la conversion en PDF.
|
|
Certains auteurs recommandent de tout mettre dans une page, ce qui facilite l'édition d'une table des matières et la conversion en PDF.
|
|
La plupart utilisent une structuration en plusieurs pages, avec une navigation facilitée par la "sidebar". Pour le rédacteur, c'est une solution plus facile également.
|
|
La plupart utilisent une structuration en plusieurs pages, avec une navigation facilitée par la "sidebar". Pour le rédacteur, c'est une solution plus facile également.
|
|
Chaque page peut être structurée en sections, qui peuvent être rappelées dans une table des matières.
|
|
Chaque page peut être structurée en sections, qui peuvent être rappelées dans une table des matières.
|
|
Enfin, il est possible d'alléger le texte présent à l'écran en reportant des informations "optionnelles", pour éviter de noyer les informations principales et trop fatiguer la molette !
|
|
Enfin, il est possible d'alléger le texte présent à l'écran en reportant des informations "optionnelles", pour éviter de noyer les informations principales et trop fatiguer la molette !
|
|
|
|
|
|
##### Alléger le texte
|
|
#### Alléger le texte
|
|
Le rédacteur doit souvent arbitrer entre "être complet" ou "être digeste", ce qui est un problème épineux car selon le lecteur la bonne réponse n'est pas la même.
|
|
Le rédacteur doit souvent arbitrer entre "être complet" ou "être digeste", ce qui est un problème épineux car selon le lecteur la bonne réponse n'est pas la même.
|
|
Il est possible d'alléger le texte présent à l'écran en reportant des informations "optionnelles" (par exemple un "rappel "qui ne sera pas utile pour tous ou une informatio complémentaire "pour en savoir plus") :
|
|
Il est possible d'alléger le texte présent à l'écran en reportant des informations "optionnelles" (par exemple un "rappel "qui ne sera pas utile pour tous ou une informatio complémentaire "pour en savoir plus") :
|
|
- dans une **"collapsible section"** (mais sans mise en forme) ;
|
|
- dans une **"collapsible section"** (mais sans mise en forme) ;
|
... | @@ -223,7 +223,7 @@ Il est possible d'alléger le texte présent à l'écran en reportant des inform |
... | @@ -223,7 +223,7 @@ Il est possible d'alléger le texte présent à l'écran en reportant des inform |
|
|
|
|
|
[^footnote-1] : on peut insérer le texte du pied de page n'importe où dans la page , avec `[^footnote-1] `
|
|
[^footnote-1] : on peut insérer le texte du pied de page n'importe où dans la page , avec `[^footnote-1] `
|
|
|
|
|
|
##### Structurer en pages et en sections
|
|
#### Structurer en pages et en sections
|
|
PAGES > SECTIONS (Header)
|
|
PAGES > SECTIONS (Header)
|
|
Liste des pages : **sidebar** (à droite)
|
|
Liste des pages : **sidebar** (à droite)
|
|
Dans une page : liste des sections = Table of Content
|
|
Dans une page : liste des sections = Table of Content
|
... | | ... | |