Sith/doc/SYNTAX.md
Skia 0d5595c683 core: add test for Markdown syntax
Signed-off-by: Skia <skia@libskia.so>
2017-08-24 16:30:46 +02:00

5.2 KiB

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.
Les plus aventureux pourront aller lire ses tests 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__***~~

  • Mettre du texte en exposant : <sup>texte</sup>

  • Mettre du texte 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

  • 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

  • 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
  2. élément
  3. é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
  2. élément
  3. é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

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%
Image à 50% de la largeur de la page.

image de 350 pixels de large
Image de 350 pixels de large.

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 ça1:

é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

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))


  1. 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!
    
    
    ↩︎