... | @@ -373,7 +373,20 @@ Les Header ID sont générés automatiquement à partir de texte de titre: |
... | @@ -373,7 +373,20 @@ Les Header ID sont générés automatiquement à partir de texte de titre: |
|
Une solution parfois proposée sur les forums est de passer par l'**inspecteur** et de rechercher la définition des sections voulues dans la page html, mais c'est plus complexe !
|
|
Une solution parfois proposée sur les forums est de passer par l'**inspecteur** et de rechercher la définition des sections voulues dans la page html, mais c'est plus complexe !
|
|
|
|
|
|
### Diagrammes
|
|
### Diagrammes
|
|
Voir [page dédiée](diagrammes_mermaid)
|
|
Il est possible de définir des graphiques à l'aide d'une syntaxe `mermaid`compatible xml. La doc est très bien faite, et bien illustrée.
|
|
|
|
|
|
|
|
C'est rapide et propre, par exemple `A[départ] --> |on suit ce chemin| B(avec une halte) -.-> C[/ouf, on y est\]` donne :
|
|
|
|
```mermaid
|
|
|
|
graph LR
|
|
|
|
A[départ] --> |on suit ce chemin| B(avec une halte) -.-> C[/ouf, on y est\]
|
|
|
|
```
|
|
|
|
|
|
|
|
Le prix à payer pour la simplicité est que l'on ne peut pas arranger facilement les objets (je voudrais celui-ci plus à droite, et intervertir ceux-là...).
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Voir [page dédiée](diagrammes_mermaid).
|
|
```mermaid
|
|
```mermaid
|
|
graph TD
|
|
graph TD
|
|
A[Estimation et analyse fréquentielle des DEBITS ]:::blue-->|scénario probabilisé, alias crue de projet| B[Calcul des surfaces inondées par scénario]:::brass;
|
|
A[Estimation et analyse fréquentielle des DEBITS ]:::blue-->|scénario probabilisé, alias crue de projet| B[Calcul des surfaces inondées par scénario]:::brass;
|
... | @@ -388,15 +401,19 @@ classDef Ao_green fill:#080; |
... | @@ -388,15 +401,19 @@ classDef Ao_green fill:#080; |
|
classDef gold fill:#fa0;
|
|
classDef gold fill:#fa0;
|
|
|
|
|
|
```
|
|
```
|
|
|
|
## tirer parti de la nature de "dépôt git" du wiki
|
|
|
|
Le wiki est lui-même un **dépôt git" (repository), comme le sont les codes dans la partie "Repository". Il est donc possible de le **cloner**, en récupérant les infos via une icône en haut à droite.
|
|
|
|
Gitlab vous propose une liste d'instructions qui n'est valable que sous Linux, mais on peut également cloner et travailler en local sous windows.
|
|
|
|
Le principe est le même dans les 2 OS:
|
|
|
|
- cloner avec **git clone**
|
|
|
|
- vérifier que l'on a récupéré les fichiers et les répertoires (dont `Images`, qui contient les images insérées)
|
|
|
|
- effectuer en local des modifications, si possible avec un "bon" éditeur, qui permette la visualisation du résultat et la répercussion de la modification de noms de pages ou de sous-section ("refactoring"). Sous Windows : PyCharm et VScode permettent d'éditer le mardown.
|
|
|
|
- comme pour un script, une fois les modifications faites il faut puis **"commiter"** et **"pusher"** les modifications sur le dépôt, le wiki se mettra à jour.
|
|
|
|
|
|
## Usage avancé
|
|
|
|
Le wiki est un repo clonable.
|
|
|
|
Gitlab vous propose une liste d'instructions qui n'est valable que sous Linux, mais on peut également cloner et pusher les modifs sous Windows :
|
|
|
|
- cloner avec **git clode**
|
|
|
|
- vérifier que l'on a récupéré les fichiers et les répertoires (dont celui qui contient les images insérées)
|
|
|
|
- effectuer en local des modifications, si possible avec le "bon" éditeur, avec visualisation
|
|
|
|
- puis **"commiter"** et **"pusher"** les modifications sur le repo.
|
|
|
|
|
|
|
|
|
|
A noter que, de la même manière que gitlab permet de régler les droits sur le dépôt du projet, il permet de régler également les droits de lecture et de modification du wiki, indépendamment de ceux du projet.
|
|
|
|
|
|
|
|
|
|
> C:\WorkSpace\2022-AtelierPython\wiki_atelier_python>git clone https://gitlab.irstea.fr/christine.poulard/Atelier_Inkscape.wiki.git
|
|
> C:\WorkSpace\2022-AtelierPython\wiki_atelier_python>git clone https://gitlab.irstea.fr/christine.poulard/Atelier_Inkscape.wiki.git
|
|
> Cloning into 'Atelier_Inkscape.wiki'...
|
|
> Cloning into 'Atelier_Inkscape.wiki'...
|
|
>C:\WorkSpace\2022-AtelierPython\wiki_atelier_python>cd Atelier_Inkscape.wiki
|
|
>C:\WorkSpace\2022-AtelierPython\wiki_atelier_python>cd Atelier_Inkscape.wiki
|
... | | ... | |