mirror of
https://github.com/ae-utbm/sith3.git
synced 2024-09-08 12:08:09 +00:00
224 lines
5.2 KiB
Markdown
224 lines
5.2 KiB
Markdown
Cette page vise à documenter la syntaxe *Markdown* utilisée sur le site.
|
|
|
|
# Markdown-AE Documentation
|
|
|
|
Le Markdown le plus standard se trouve documenté ici:
|
|
https://daringfireball.net/projects/markdown/syntax .
|
|
Si cette page n'est pas exhaustive vis à vis de la syntaxe du site AE,
|
|
elle a au moins le mérite de bien documenter le Markdown original.
|
|
|
|
Le réel parseur du site AE est une version tunée de [mistune](https://github.com/lepture/mistune).
|
|
Les plus aventureux pourront aller lire ses [tests](https://github.com/lepture/mistune/blob/master/tests/fixtures)
|
|
afin d'en connaître la syntaxe le plus finement possible.
|
|
En pratique, cette page devrait déjà résumer une bonne partie.
|
|
|
|
## Basique
|
|
|
|
* Mettre le texte en **gras** : `**texte**`
|
|
|
|
* Mettre le texte en *italique* : `*texte*`
|
|
|
|
* __Souligner__ le texte : `__texte__`
|
|
|
|
* ~~Barrer du texte~~ : `~~texte~~`
|
|
|
|
* On peut bien sûr tout ~~***__combiner__***~~ : `~~***__texte__***~~`
|
|
|
|
* <sup>Mettre du texte</sup> en exposant : `<sup>texte</sup>`
|
|
|
|
* <sub>Mettre du texte</sub> en indice : `<sub>texte</sub>`
|
|
|
|
|
|
## Liens
|
|
|
|
* Les liens simples sont détectés automatiquement : `http://www.site.com`
|
|
|
|
http://www.site.com
|
|
|
|
* Il est possible de nommer son lien : `[nom du lien](http://www.site.com)`
|
|
|
|
[nom du lien](http://www.site.com)
|
|
|
|
* Les liens peuvent être internes au site de l'AE, on peut dès lors éviter d'entrer
|
|
l'adresse complète d'une page : `[nom du lien](page://nomDeLaPage)`
|
|
|
|
[nom du lien](page://nomDeLaPage)
|
|
|
|
* On peut également utiliser une image pour les liens :
|
|
`[nom du lien]![images/imageDuSiteAE.png](/chemin/vers/image.png titre optionnel)(options)`
|
|
|
|
[nom du lien]![images/imageDuSiteAE.png](/chemin/vers/image.png titre optionnel)(options)
|
|
|
|
|
|
|
|
## Titres
|
|
|
|
* Plusieurs niveaux de titres sont possibles
|
|
|
|
```
|
|
# Titre de niveau 1
|
|
## Titre de niveau 2
|
|
### Titre de niveau 3
|
|
etc...
|
|
```
|
|
# Titre de niveau 1
|
|
## Titre de niveau 2
|
|
### Titre de niveau 3
|
|
|
|
Si le titre de votre section commence par un tilde (~) alors le texte sous la section est
|
|
affiché par défaut caché et il est consultable grace à un bouton +/-
|
|
|
|
## ~Test
|
|
|
|
## Paragraphes et sauts de ligne
|
|
|
|
Un nouveau paragraphe se fait avec deux retours à la ligne.
|
|
|
|
Un saut de ligne se force avec au moins deux espaces en fin de ligne.
|
|
|
|
|
|
## Listes
|
|
|
|
Il est possible de créer des listes :
|
|
|
|
* ordonnées :
|
|
|
|
```
|
|
1. élément
|
|
2. élément
|
|
3. élément
|
|
```
|
|
1. élément
|
|
1. élément
|
|
1. élément
|
|
|
|
Vous pouvez marquer plus simplement comme suit, les numéros se faisant tout seuls:
|
|
```
|
|
1. élément
|
|
1. élément
|
|
1. élément
|
|
```
|
|
|
|
1. élément
|
|
1. élément
|
|
1. élément
|
|
|
|
|
|
* non ordonnées :
|
|
|
|
```
|
|
* élément
|
|
* élément
|
|
* élément
|
|
```
|
|
* élément
|
|
* élément
|
|
* élément
|
|
|
|
|
|
## Tableaux
|
|
|
|
Un tableau est obtenu en respectant la syntaxe suivante :
|
|
|
|
```
|
|
| Titre | Titre2 | Titre3 |
|
|
|-------|--------|--------|
|
|
| test | test | test |
|
|
| test | test | test |
|
|
```
|
|
| Titre | Titre2 | Titre3 |
|
|
|-------|--------|--------|
|
|
| test | test | test |
|
|
| test | test | test |
|
|
|
|
L'alignement dans les cellules est géré comme suit, avec les ':' sur la ligne en dessous du titre:
|
|
|
|
```
|
|
| Titre | Titre2 | Titre3 |
|
|
|:-------|:------:|-------:|
|
|
| gauche | centre | droite |
|
|
```
|
|
| Titre | Titre2 | Titre3 |
|
|
|:-------|:------:|-------:|
|
|
| gauche | centre | droite |
|
|
|
|
|
|
## Images et contenus
|
|
|
|
Une image est insérée ainsi : `![texte alternatif](/chemin/vers/image.png "titre optionnel")`
|
|
![texte alternatif](/static/core/img/logo.png "titre optionnel")
|
|
|
|
On peut lui spécifier ses dimensions de plusieurs manières:
|
|
|
|
```
|
|
![image à 50%](/static/core/img/logo.png?50% "Image à 50%")
|
|
![image de 350 pixels de large](/static/core/img/logo.png?350 "Image de 350 pixels")
|
|
![image de 350x100 pixels](/static/core/img/logo.png?350x100 "Image de 350x100 pixels")
|
|
```
|
|
|
|
|
|
![image à 50%](/static/core/img/logo.png?50% "Image à 50%")
|
|
Image à 50% de la largeur de la page.
|
|
|
|
![image de 350 pixels de large](/static/core/img/logo.png?350 "Image de 350 pixels")
|
|
Image de 350 pixels de large.
|
|
|
|
![image de 350x100 pixels](/static/core/img/logo.png?350x100 "Image de 350x100 pixels")
|
|
Image de 350x100 pixels.
|
|
|
|
( devrait pouvoir détecter si vidéo ou non )
|
|
|
|
## Blocs de citations
|
|
|
|
Un bloc de citation se crée ainsi :
|
|
```
|
|
> Ceci est
|
|
> un bloc de
|
|
> citation
|
|
```
|
|
|
|
> Ceci est
|
|
> un bloc de
|
|
> citation
|
|
|
|
Il est possible d'intégrer de la syntaxe Markdown-AE dans un tel bloc.
|
|
|
|
## Note de bas de page
|
|
|
|
On les créer comme ça[^key]:
|
|
|
|
[^key]: ceci est le contenu de ma clef
|
|
```
|
|
Je fais une note[^clef].
|
|
|
|
[^clef]: je note ensuite ou je veux le contenu de ma clef qui apparaîtra quand même en bas
|
|
```
|
|
Vous pouvez utiliser des numéros pour nommer vos clef si vous avez la flemme.
|
|
|
|
```
|
|
Note plus complexe[^1]
|
|
|
|
[^1]:
|
|
je peux même faire des blocks
|
|
sur plusieurs lignes, comme d'habitude!
|
|
|
|
```
|
|
|
|
## échapper des caractères
|
|
|
|
* Il est possible d'ignorer un caractère spécial en l'échappant à l'aide d'un \
|
|
* L'échappement de blocs de codes complet se fera à l'aide de balises <nosyntax></nosyntax>
|
|
|
|
|
|
|
|
## Autres ( hérité de l'ancien wiki )
|
|
|
|
* Une ligne peut être crée avec une ligne contenant 4 tirets ( - ).
|
|
* Une barre de progression est crée ainsi :
|
|
> [[[70]]]
|
|
* Notes en pied de page :
|
|
> ((note))
|
|
|
|
|
|
|