|
|
|
Toutes les contributions sont les bienvenues !
|
|
|
|
## 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).
|
|
|
|
N'hésitez surtout pas à faire remonter vos remarques et même proposer des pages.
|
|
|
|
|
|
|
|
## 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.
|
|
|
|
Quelques infos sur le **format markdown** et sur la **gestion des images insérées**. On verra que le wiki est lui-même un dépôt gitlab ; un indice est l'indication d'un 'commit' quand on enregistre les modifs. Utiliser cette propriété doit faciliter le travail à plusieurs (pour éviter d'intervenir en même temps...) et la gestion des images.
|
|
|
|
|
|
|
|
## 1. Le format markdown et les deux éditeurs disponibles sur le gitlab
|
|
|
|
|
|
|
|
Markown 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 récentes.
|
|
|
|
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"
|
| ... | ... | @@ -24,8 +27,24 @@ les cellules sont définies par des séparateurs "pipe" (|), cela n'est pas touj |
|
|
|
|
|
|
|
### 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,
|
|
|
|
Un éditeur plus performant est apparu fin 2021, et une bascule est maintenant proposé par le texte cliquable "Edit rich text".
|
|
|
|
Il facilite l'édition des tableaux (on "voit" ce qu'on fait !) et surtout l'import d'images.
|
|
|
|
|
|
|
|
Attention cependant, il m'est arrivé d'activer l'éditeur rich text et de le voir "pédaler dans le vide" (donc : :warning: toujours sauvegarder avant de basculer vers l'autre éditeur...) et également de constater la disparition de code Python (il ne reste que les balises). Un effet de bord temporaire ??
|
|
|
|
D'où l'intérêt de garder des traces du travail effectué, en travaillant sur le dépôt gitlab du wiki.
|
|
|
|
|
|
|
|
|
|
|
|
Sites de ressource
|
|
|
|
https://gitlab.irstea.fr/help/user/markdown#wiki-specific-markdown
|
|
|
|
https://gitlab.com/francoisjacquet/rosariosis/-/wikis/Markdown-Cheatsheet
|
|
|
|
|
|
|
|
|
|
|
|
## 2. Le wiki est un dépôt gitlab...
|
|
|
|
|
|
|
|
Cela paraît évident pour un informaticien (je suppose) mais j'ai mis du temps à comprendre... Le texte cliquable "Clone repository" en haut à droite vous permet de récupérer tous les fichiers du wiki, répertoire d'images compris ("Uploads").
|
|
|
|
Ainsi, vous pouvez :
|
|
|
|
- **travailler en local** et mettre à jour par des commit et push classiques
|
|
|
|
- gérer les fichiers d'image du répertoire uploads
|
|
|
|
- récupérer plus facilement les modifs perdues...
|
|
|
|
|
|
|
|
https://gitlab.com/francoisjacquet/rosariosis/-/wikis/Markdown-Cheatsheet |
|
|
\ No newline at end of file |
|
|
|
(à compléter) |
|
|
\ No newline at end of file |
