Markdown et Pelican
Je me retrouve souvent à aller relire mes anciens articles pour me rappeler comment on souligne quelque chose, comment on intègre une image ou comment on fait un lien en Markdown. Et comme j'ai une mauvaise mémoire et que je n'écris pas assez souvent ici, je perds vite du temps... Voici donc un petit article de rappel sur les possibilités du langage de formatage Markdown.
Liens utiles :
Pelican / Wiki / Markdown Syntax
Titres :
On peut faire plusieurs niveaux de titres :
Titre de niveau 1
Titre de niveau 2
Titre de niveau 3
Titre de niveau 4
Titre de niveau 5
#Titre de niveau 1
##Titre de niveau 2
###Titre de niveau 3
####Titre de niveau 4
#####Titre de niveau 5
Je viens de remarquer que les titres de niveaux 1 et 2 s'affichent de la même manière malgré leur différenciation dans le code ( <h1> et <h2> dans le code source de la page ). Il faut que je regarde au niveau du CSS du plugin de style.
Table des matières :
Si j'installais le plugin qui-va-bien, je n'aurais qu'à taper [TOC] pour faire apparaitre une table des matières. TO DO donc.
Formatage :
Mettre en italique, en gras ou les deux en même temps :
Texte en *italique* et en _italique_.
Texte en **gras** et en __gras__.
Texte en ***italique et gras*** et en ___italique et gras___.
Pour barrer du texte, il faut utiliser la balise <s> de l'html :
Voilà du <s>texte barré</s>.
Pour souligner, on fait appel à la balise <u> de l'html :
Voilà du <u>texte souligné</u>.
Pour faire une barre horizontale :
***
---
Liens :
<http://blog.simonlefort.be>
[Blog de Simon Lefort](http://blog.simonlefort.be)
[Blog de Simon Lefort](http://blog.simonlefort.be "mon blog")
On peut aussi utiliser des liens de référence et placer le lien sous le paragraphe.
On peut aussi utiliser des [liens de référence][1] et placer le lien sous le paragraphe.
[1]: http://blog.simonlefort.be "mon blog"
Images :
Listes :
On peut utiliser *, + ou - pour des éléments non-numérotés et il faut commencer une liste numérotée par un chiffre. Pour descendre d'un niveau dans la liste, on met 4 espaces.
- premier élément
- second élément
- sous-élément
Liste numérotée :
- premier élément
- second élément
- troisième élément
- sous-élément
- sous-élément
- quatrième élément
- sous-élément numéroté
- sous-élément numéroté
1. premier élément
* second élément
* troisième élément
* sous-élément
* sous-élément
* quatrième élément
1. sous-élément numéroté
* sous-élément numéroté
Tableaux :
| Nom colonne | Nom autre colonne |
|---|---|
| contenu1 | contenu2 |
| contenu3 | contenu4 |
| le contenu5 est le plus long | |
| contenu7 | contenu8 |
Nom colonne | Nom autre colonne
------------|------------------
contenu1 | contenu2
contenu3 | contenu4
le contenu5 est le plus long
contenu7 | contenu8
Oui, il n'y a pas de contenu6, ce n'est pas obligé.
Insérer du code :
Python:
print("test Python")
print("Autre test Python")
:::python
print("test Python")
```python
print("Autre test Python")
```
Bash:
#!/bin/sh
### BEGIN INIT INFO
# Provides: ...
# Required-Start: $local_fs $remote_fs
# ...
### END INIT INFO
syncthing_USERS="simon" #blabla
DAEMON=/.../syncthing #blabla
startd() {
..
done
}
pi@raspberrypi ~ $ lsblk
NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT
sda 8:0 1 15G 0 disk
└─sda1 8:1 1 15G 0 part /media/usb-pi
mmcblk0 179:0 0 7,4G 0 disk
├─mmcblk0p1 179:1 0 56M 0 part /boot
└─mmcblk0p2 179:2 0 7,3G 0 part /
:::bash
code bash
```bash
code bash
```
Autres :
On peut mettre pas mal de langages différents. J'ai aussi essayé xml et markdown. La liste complète des langages supportés par Pygments est ici. Il y en a un paquet !
Citation :
Texte cité niveau 2 Texte cité niveau 1
>> Texte cité niveau 2
> Texte cité niveau 1
J'ai noté ici tout ce qui me semblait important de retenir. Si vous avez besoin d'autre chose, n'hésitez pas à regarder les liens que j'ai mis en début d'article. Ils sont plus complets.
~~~