|
|
|
Toutes les contributions sont les bienvenues !
|
|
|
|
|
|
|
|
Quelques infos sur le **format markdown** et sur la **gestion des images insérées** (où l'on verra que le wiki est lui-même un dépôt gitlab).
|
|
|
|
|
|
|
|
## 1. Le format markdown
|
|
|
|
|
|
|
|
C'est un langage à balises, très classique. Vous trouverez facilement des infos sur la syntaxe, sachant que la version 'gitlab' offre moins de possibilités que les versions plus modernes, étoffées.
|
|
|
|
Dans la version de février 2022, vous avez le choix entre 2 éditeurs, le "standard" au format texte brut, et une version "rich text" qui vous permet de voir la mise en forme même pendant l'édition, et offre quelques facilités supplémentaires.
|
|
|
|
|
|
|
|
### Editeur "standard"
|
|
|
|
L'éditeur qui s"ouvre quand vous demandez à modifier un texte vous montre le code "brut", avec les balises.
|
|
|
|
Vous voyez que pour **mettre en gras** il faut écrire `**mettre en gras**`
|
|
|
|
En haut de la fenêtre d'édition vous verrez des icônes pour vous aider à écrire en gras, en italique, insérer du code, des numéros...
|
|
|
|
La fonction "add a collapsible section" est pratique pour intégrer des infos complémentaires sans alourdir le texte.
|
|
|
|
<details><summary>cliquez pour voir le paragraphe supplémentaire</summary>
|
|
|
|
ici vous mettez un exemple, des explications, des références ou un "spoiler".
|
|
|
|
Par contre, on ne peut pas vraiment mettre en forme ce texte.
|
|
|
|
</details>
|
|
|
|
Plus "technique" :
|
|
|
|
### les tableaux
|
|
|
|
les cellules sont définies par des séparateurs "pipe" (|), cela n'est pas toujours facile à lire
|
|
|
|
### les images
|
|
|
|
:cactus: Soyons francs, j'ai attendu la version de l'éditeur 'rich text' pour réussir à ajouter des images. J'ai vraiment eu du mal à comprendre les posts qui me parlaient d'un répertoire "upload" que je ne voyais nulle part, alors que dans le Readme.md du dépôt on crée un répertoire illustrations (par exemple) auquel on a accès et on fait référence explicitement... Finalement, le malentendu vient du fait que la nature du wiki est... un dépôt git, qu'il faut récupérer ("pull" ) pour pouvoir travailler dessus... Voir la partie correspondante.
|
|
|
|
|
|
|
|
### Editeur "rich text" : une solution et quelques problèmes
|
|
|
|
|
|
|
|
m'a posé beaucoup de problèmes, et j'ai finalement attendu ajouter du texte. Cependant,
|
|
|
|
|
|
|
|
Sites de ressource
|
|
|
|
|
|
|
|
https://gitlab.com/francoisjacquet/rosariosis/-/wikis/Markdown-Cheatsheet |
|
|
\ No newline at end of file |
