• [^] # Re: Format source de la doc en reStructuredText :-/

    Posté par . En réponse à la dépêche Première version stable pour WeasyPrint. Évalué à 3. Dernière modification le 26 novembre 2018 à 17:32.

    Quelque chose contre la philosophie du "eat your own dogfood" ?

    Pas vraiment. Mon but n'est pas de pousser le monde entier à écrire du HTML à la main !

    L'avantage de HTML est justement qu'il existe des tonnes de façons d'en générer. Qu'on soit fan de langages de templating, de PHP, de langages légers comme ReST ou Markdown, peu importe : on arrive souvent à sortir du HTML.

    En particulier, pour des longs documents textuels où la mise en page est répétitive (comme la documentation), autant utiliser un langage de balisage léger. En plus, Sphinx (très largement utilisé pour la documentation des modules Python et sur ReadTheDocs en général) propose ReST par défaut.

    Dans tous les cas, l'important est d'avoir du HTML en sortie :).