... | @@ -4,8 +4,11 @@ Auteur : C. Poulard, 2022 |
... | @@ -4,8 +4,11 @@ Auteur : C. Poulard, 2022 |
|
|
|
|
|
## Objectif :
|
|
## Objectif :
|
|
GitLab offre la possibilité de rédiger des pages en markdown pour accompagner le code. C'est une fonctionnalité intéressante, mais le format Markdown utilisé est spécifique. On parlera donc de "GitLab Flavored Markdown", qui est différent du "GitHub Flavored Markdown" et du Markdown Standard.
|
|
GitLab offre la possibilité de rédiger des pages en markdown pour accompagner le code. C'est une fonctionnalité intéressante, mais le format Markdown utilisé est spécifique. On parlera donc de "GitLab Flavored Markdown", qui est différent du "GitHub Flavored Markdown" et du Markdown Standard.
|
|
|
|
|
|
L'objectif est de regrouper ici toutes les infos glanées en rédigeant des **readme.md** et des **wiki**, en insistant sur celles qui sont difficiles à trouver.
|
|
L'objectif est de regrouper ici toutes les infos glanées en rédigeant des **readme.md** et des **wiki**, en insistant sur celles qui sont difficiles à trouver.
|
|
|
|
|
|
Difficulté : les fonctions évoluent ! !
|
|
Difficulté : les fonctions évoluent ! !
|
|
|
|
|
|
Le lecteur peut rechercher ce qui l'intéresse dans le texte. L'idéal serait qu'il puisse accéder au fichier markdown ; c'est le cas pour le read.me, qui est téléchargeable.
|
|
Le lecteur peut rechercher ce qui l'intéresse dans le texte. L'idéal serait qu'il puisse accéder au fichier markdown ; c'est le cas pour le read.me, qui est téléchargeable.
|
|
:warning: vérifier si c'est le cas pour le wiki !!
|
|
:warning: vérifier si c'est le cas pour le wiki !!
|
|
|
|
|
... | @@ -45,6 +48,23 @@ Les fonctions courantes seront très faciles à trouver via un tuto et via la ba |
... | @@ -45,6 +48,23 @@ Les fonctions courantes seront très faciles à trouver via un tuto et via la ba |
|
|
|
|
|
- [ ] on ne peut pas mettre une case à cocher n'importe où [ ] [X]
|
|
- [ ] on ne peut pas mettre une case à cocher n'importe où [ ] [X]
|
|
|
|
|
|
|
|
Même si vous insérez des retours chariot et qu'en éditant le texte vous avez l'impression d'avoir des **paragraphes séparés, dans la fenêtre d'édition**, vous pouvez avoir la **désagréable surprise** de constater que vos paragraphes sont en fait mis bout à bout. Ici par exemple j'ai inséré _un retour chariot_.
|
|
|
|
Au lieu d'un joli **texte aéré** vous trouvez en fait un **magma plus compliqué à lire**.
|
|
|
|
Les idées n'apparaissent pas aussi distinctement.
|
|
|
|
|
|
|
|
Les solutions [sur la doc de gitlab](https://about.gitlab.com/handbook/markdown-guide/#paragraphs-breaks-and-horizontal-lines)
|
|
|
|
- insérez une ligne blanche manuellement (deux retours chariot)
|
|
|
|
- commande html `<br/>` qui ajoute une ligne au-dessus et une en dessous (différent du md classique ??)
|
|
|
|
|
|
|
|
|
|
|
|
```html
|
|
|
|
Text A
|
|
|
|
<!-- blank line -->
|
|
|
|
<br>
|
|
|
|
<!-- blank line -->
|
|
|
|
Text B
|
|
|
|
```
|
|
|
|
A noter que [le site w3c school](https://www.w3schools.io/file/markdown-line-break/) indique d'autres possibilités, qui ne sont pas forcément disponibles dans GitLab.
|
|
|
|
|
|
|
|
|
|
## Mise en forme "niveau intermédiaire"
|
|
## Mise en forme "niveau intermédiaire"
|
... | | ... | |