... | ... | @@ -9,7 +9,18 @@ Quelques infos sur le **format markdown** et sur la **gestion des images insér |
|
|
- [ ] Il n'y a pas de "protocole" pour harmoniser les contributions
|
|
|
- [ ] ni de règles pour baliser le travail collaboratif (gitlab et branches...)
|
|
|
|
|
|
## 1. Le format markdown et les deux éditeurs disponibles sur le gitlab
|
|
|
## 1. Structure et nom des pages (important !)
|
|
|
|
|
|
Ce wiki a débuté petit, sans souci donc de structuration, mais il a grossi...
|
|
|
Il est donc temps de le restructurer :
|
|
|
- découpler Python seul et matplotlib
|
|
|
- favoriser la navigation entre les pages : liens, sidebar.
|
|
|
|
|
|
Pour la création de liens dans les pages et dans la side bar, mais aussi pour le clonage du repo (voir partie 3), il est important de respecter des règles de nommage : le **nom des pages ne doit pas contenir certains caractères spéciaux**, comme "**:**".
|
|
|
Des modifs sont en cours, du coup les liens seront cassés... Remettre tout cela d'équerre sera sans doute plus facile en locale, avec l'aide 'un IDE.
|
|
|
|
|
|
|
|
|
## 2. 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. Pour éditer une page, si vous avez les droits vous verrez une icône "crayon" en haut à droite, pour passer **en mode édition**. 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.
|
|
|
|
... | ... | @@ -71,7 +82,7 @@ Il existe une autre syntaxe pour préciser le titre, la hauteur et la largeur. P |
|
|
|
|
|
<https://gitlab.com/francoisjacquet/rosariosis/-/wikis/Markdown-Cheatsheet>
|
|
|
|
|
|
## 2. Le wiki est un dépôt gitlab...
|
|
|
## 3. 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 :
|
|
|
|
... | ... | @@ -79,7 +90,8 @@ Cela paraît évident pour un informaticien (je suppose) mais j'ai mis du temps |
|
|
- gérer les fichiers d'image du répertoire uploads
|
|
|
- récupérer plus facilement les modifs perdues...
|
|
|
|
|
|
Il faut installer un éditeur de wiki ; si vous cliquez sur"Clone repository" vous aurez les instructions pour installer l'éditeur wiki **Gollum** ; c'est en fait un outil **LINUX** !
|
|
|
Il faut installer un éditeur de wiki ; si vous cliquez sur"Clone repository" vous aurez les instructions pour installer l'éditeur wiki **Gollum**, un outil **LINUX** !
|
|
|
Sous Windows, vous pouvez utiliser un IDE qui gère le markdown, comme PyCharm ou VSCode ; attention toutefois aux différences markdown "standard" et "gitlab flavored.
|
|
|
|
|
|
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).
|
|
|
|
... | ... | |