... | ... | @@ -15,24 +15,21 @@ L'éditeur qui s"ouvre quand vous demandez à modifier un texte vous montre le c |
|
|
<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>Dès que vous tapez ":" suivis d'une lettre l'éditeur vous propose des icônes (et c'est parfois envahissant quand on ne veut pas insérer de petits dessins....). Si on sélectionne un petit nombre d'icônes associés clairement chacune à une signification, cela peut être une aide à la lecture.
|
|
|
</details>Dès que vous tapez ":" suivis d'une lettre l'éditeur vous propose des icônes (et c'est parfois envahissant quand on ne veut pas insérer de petits dessins....). Si on sélectionne un petit nombre d'icônes associés clairement chacune à une signification, cela peut être une aide à la lecture.
|
|
|
|
|
|
Par exemple : :cactus: pour un point épineux ! :books: pour des références
|
|
|
Par exemple : :cactus: pour un point épineux ! :books: pour des références
|
|
|
|
|
|
#### Fonctions plus "techniques" : tableaux et insertion d'images
|
|
|
|
|
|
####
|
|
|
|
|
|
|
|
|
|
|
|
| les tableaux| les images|
|
|
|
| ------ | ------ |
|
|
|
| les cellules sont définies par des séparateurs "pipe" (|), cela n'est pas toujours facile à lire | cell |
|
|
|
| cell | cell |
|
|
|
| les tableaux | les images |
|
|
|
|--------------|------------|
|
|
|
| les cellules sont définies par des séparateurs "pipe" (barre verticale) et tirets (horizontales) | il est **possible** d'insérer des images, la preuve, mais il faut d'abord comprendre comment ça marche ! ! Le plus simple : utiliser l'éditeur **rich text**, puis éventuellement ajuster sous l'éditeur de base |
|
|
|
| dans l'éditeur basique, les tableaux ne sont pas toujours facile à lire | ![Wiki_rep_Uploads](uploads/c7f14cd40c039a70d756b55ab9686aa4/Wiki_rep_Uploads.JPG) |
|
|
|
|
|
|
_ceci est un titre défini indépendamment du tableau...__
|
|
|
|
|
|
: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.
|
|
|
: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 "uploads" 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" du gitlab : une solution et quelques problèmes
|
|
|
|
... | ... | @@ -42,9 +39,29 @@ Quand on passe de l'un à l'autre il faut ajuster ses réflexes... dans "rich te |
|
|
|
|
|
Attention cependant, il m'est arrivé (début 2022) 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.
|
|
|
|
|
|
:books: Sites de ressource
|
|
|
Une fois que l'on a réussi à importer une image, on remarque que la syntaxe est la suivante :
|
|
|
|
|
|
```
|
|
|
![texte cliquable](url)
|
|
|
```
|
|
|
|
|
|
La différence entre un lien et une image intégrée est le signe "!".
|
|
|
|
|
|
Dans un tableau, la taille de l'image s'ajuste automatiquement.
|
|
|
|
|
|
Il est possible d'ajouter un titre entre guillemets, dans la parenthèse
|
|
|
|
|
|
`![texte cliquable](`<span dir="">`image`</span>` url `<span dir="">`"image Title"`</span>`)`
|
|
|
|
|
|
Il existe une autre syntaxe pour préciser le titre, la hauteur et la largeur. Par contre, en alternant entre les éditeurs il est possible que le type de syntaxe soit rebasculé vers la première version (avec le "!"), ou que la taille revienne à la largeur de la page. Espérons que ce soient des effets de bord transitoires liés à la mise en production du nouvel éditeur.
|
|
|
|
|
|
```
|
|
|
<img src="image url" alt="texte cliquable" title="image Title" height="150"/>
|
|
|
```
|
|
|
|
|
|
:books: Sites de ressource
|
|
|
|
|
|
[https://gitlab.irstea.fr/help/user/markdown#wiki-specific-markdown ](https://gitlab.irstea.fr/help/user/markdown#wiki-specific-markdown)
|
|
|
<https://gitlab.irstea.fr/help/user/markdown#wiki-specific-markdown>
|
|
|
|
|
|
<https://gitlab.com/francoisjacquet/rosariosis/-/wikis/Markdown-Cheatsheet>
|
|
|
|
... | ... | @@ -60,7 +77,7 @@ Il faut installer un éditeur de wiki ; si vous cliquez sur"Clone repository" vo |
|
|
|
|
|
La copie d'écran ci-dessous montre l'arborescence des fichiers quand on a récupéré le dépôt (\*.wiki) et dézippé (merci à Sylvain Coulibaly de l'équipe d'Hydraulique des Rivières).
|
|
|
|
|
|
Chaque page est un fichier markdown, c'est logique. On **voit enfin le répertoire uploads** ! !
|
|
|
Chaque page est un fichier markdown, c'est logique. On **voit enfin le répertoire uploads** ! !
|
|
|
|
|
|
Dans le répertoire, on trouve une liste de répertoires avec des noms "de code"... typiquement des identifiants générés automatiquement. Dans chaque répertoire se trouve un unique fichier image (png, svg...) qui a en revanche conservé son nom "de baptême", plus explicite pour un humain.
|
|
|
|
... | ... | |