Je ne sais jamais comment on fait pour mettre un code dans une puce ou dans une citation en Markdown et j'ai bien galéré sur mon dernier journal avec ça.
Dans une vie antérieure, j'ai conçu une syntaxe dans laquelle ça se passe comme ça :
- La version avec `echo` :
[code=bash <<<
echo "toto"
>>>]
- La version avec `printf` :
[code=bash <<<
printf "toto\n"
>>>]
Ou, si on veut être plus explicite :
- La version avec `echo` : [
[code=bash <<<
echo "toto"
>>>]
]
- La version avec `printf` : [
[code=bash <<<
printf "toto\n"
>>>]
]
Pour une citation :
Voici ce que cette page disait :
[quote
Ce code ne fonctionne pas toujours comme attendu :
[code=bash <<<
echo "$message"
>>>]
]
Pour les titres, pas de caractères bizarres : un = au début de la ligne donne un titre de premier niveau, deux = donnent un titre de deuxième niveau et il est également possible d'utiliser une notation sous forme de sections du genre :
[ = Titre 1
Cette section présente tartempion, un dessert peu connu.
[ = Titre 1.1
Lorem ipsum...
]
]
Et c'est d'ailleurs transformé en sections HTML. Les espaces de début de lignes dans les blocs de code sont détectés et supprimés, en conservant malgré tout l'indentation du code. Le code du document lui-même peut en conséquence être indenté.
On sort de l'esprit Markdown qui est censé être lisible tel quel, mais finalement ici on ne voit jamais que le résultat HTML et je préfère que ce soit facile à écrire et à comprendre plutôt que « plus ou moins naturel » à lire.
Je n'aime pas du tout Markdown non plus, et faire des contorsions pour écrire ce que je dois écrire. Je préfèrerais pouvoir rédiger dans un langage style (X)HTML (il n'est pas vraiment question d'utiliser autre chose y compris la syntaxe que j'ai mentionnée plus haut, elle aurait probablement les mêmes problèmes que je trouve à Markdown pour d'autres gens de toute façon). Les règles sont extrêmement claires et simples et il n'y a pas d'histoire de « Oh, la liste n'est pas reconnue comme une liste parce qu'elle n'est pas entourée de lignes vides », ou « Ah, j'ai trop indenté les tirets de cette liste, du coup elle est reconnue comme un bloc de code ». Ou « J'ai mis une nouvelle ligne entre deux items de la liste, donc c'est reconnu comme deux listes ». Tu veux écrire une citation ? Alors tu la mets entre <citation> et </citation>. Aucun mystère ou comportement étrange pour quelqu'un qui n'a pas l'habitude.
[^] # Re: Correction
Posté par raphj (site web personnel) . En réponse au journal Remonter l'historique du noyau avec git depuis le début. Évalué à 1.
Je ne sais jamais comment on fait pour mettre un code dans une puce ou dans une citation en Markdown et j'ai bien galéré sur mon dernier journal avec ça.
Dans une vie antérieure, j'ai conçu une syntaxe dans laquelle ça se passe comme ça :
Ou, si on veut être plus explicite :
Pour une citation :
Pour les titres, pas de caractères bizarres : un
=au début de la ligne donne un titre de premier niveau, deux=donnent un titre de deuxième niveau et il est également possible d'utiliser une notation sous forme de sections du genre :Et c'est d'ailleurs transformé en sections HTML. Les espaces de début de lignes dans les blocs de code sont détectés et supprimés, en conservant malgré tout l'indentation du code. Le code du document lui-même peut en conséquence être indenté.
On sort de l'esprit Markdown qui est censé être lisible tel quel, mais finalement ici on ne voit jamais que le résultat HTML et je préfère que ce soit facile à écrire et à comprendre plutôt que « plus ou moins naturel » à lire.
Je n'aime pas du tout Markdown non plus, et faire des contorsions pour écrire ce que je dois écrire. Je préfèrerais pouvoir rédiger dans un langage style (X)HTML (il n'est pas vraiment question d'utiliser autre chose y compris la syntaxe que j'ai mentionnée plus haut, elle aurait probablement les mêmes problèmes que je trouve à Markdown pour d'autres gens de toute façon). Les règles sont extrêmement claires et simples et il n'y a pas d'histoire de « Oh, la liste n'est pas reconnue comme une liste parce qu'elle n'est pas entourée de lignes vides », ou « Ah, j'ai trop indenté les tirets de cette liste, du coup elle est reconnue comme un bloc de code ». Ou « J'ai mis une nouvelle ligne entre deux items de la liste, donc c'est reconnu comme deux listes ». Tu veux écrire une citation ? Alors tu la mets entre
<citation>et</citation>. Aucun mystère ou comportement étrange pour quelqu'un qui n'a pas l'habitude.