Follow

Are there people interrested in a tool for automating generation of PDF file from markdown here? Because we're developing one with @greenman to process our document base. It's called `pandoc-compose`[1]. For now, it's a thin wrapper around Pandoc but we have a lot of cool features in mind for near-future.

[1]: git.feneas.org/christophehenry

@AugierLe42e @greenman

Yes.
I wonder if this markdown to pdf was not existing already though.

@tuxicoman Well, there is Pandoc[1], which is the tool pandoc-compose wraps. But the idea is to automate a few things. Notably extracting infos from git. There are a few things to make from here. For instance, generate both HTML and PDF from Markdown (using Jekyll, too, maybe?), plug a Netlify instance to manage documentation, or possibly a Nextcloud.
@greenman

[1]: pandoc.org/

@AugierLe42e @moulinux @greenman

Pour moi le soucis, c'est la mise en page.

Comment spécifier qu'un titre doit être sur la même page que le paragraphe qui le suit?

Que les images peuvent être réduites de ~20% si ça permet de les faire rentrer dans la page plutôt que laisser un blanc.

J'adorerais avoir un outil qui permette de mettre en page automatiquement un document structuré de manière simple (markdown est un exemple)

@tuxicoman

Ce sont de très intéressantes remarques, je me garde ça dans un coin de la tête :)

@AugierLe42e @moulinux

@greenman @tuxicoman Je suis pas sûr, mais il doit être possible d'insérer du LaTeX directement dans le MD. Possiblement avec une extension Pandoc.

Mais ce qui me préoccupe fortement dans ce cas, c'est l'UX du truc. MD, passe encore. Mais LaTeX, jamais tu mets ça dans les mains d'un•e non-initiée. Tu fais fuir tout le monde direct 😕
@moulinux

@greenman @AugierLe42e @moulinux

Et faire un convertisseur MD -> PDF avec reportlab?

Le latex c'est trop complexe pour quelqu'un qui veut se focaliser sur le contenu.

Le CSS passe encore. Mais je ne sais pas si c'est suffisant pour faire de la mise en page. (Cf les sauts de pages flexibles et tailles variables pour eviter les sauts de pages)

@tuxicoman

- Encore un nouveau langage de markup à apprendre
- XML (donc difficile à lire et apprendre)
- Pas complètement libre
- Réinvention de la roue.

@greenman @moulinux

@AugierLe42e @greenman @moulinux

Je parlais d'utiliser reportlab a la place de pandoc pour la conversion. L'utilisateur reste avec le markdown.

Je ne sais pas ce que pandoc utilise en interne pour la conversion.

Un autre technique est d'utiliser un moteur de rendu html. Puis imprimer en pdf. Mais la question de la gestion des sauts de pages reste a faire.

@tuxicoman Nan mais Pandoc traduit en LaTeX pour compiler en PDF. Mais c'est procedural. Ça peut pas planter. Pandoc, c'est juste un outil CLI en Haskell. C'est facile à installer et à utiliser. C'est aussi pour ça qu'on l'a choisi pour en faire une surcouche.
@greenman @moulinux

@tuxicoman En vrai, tous les outils existent déjà. Y'a même une biblio Python pour manipuler Pandoc. Moi, je me contente d'assembler ça et de le lier pour compiler une basse de document complète avec un peu de possibilité de configuration en YAML. Dans l'idée, c'est un peu comme docker-comopose avec Docker.
@greenman @moulinux

@AugierLe42e @greenman How will it be different to a batch pandoc run or sphinx doc?

@blub For now, the possibility to mutualise Pandoc metadata variables. Later, we also want to plug that to git to also extract authors and revision messages to produce document revision.
@greenman

Sign in to participate in the conversation
Diaspodon

Diaspodon.fr est une instance majoritairement francophone et généraliste. Aucun contenu du fédiverse n'est filtré par une décision d'administrateur ou de modérateur.