Does anyone know of tooling like this but not for only making websites?
I have an asciidoc based chain that mostly works for generating both PDF manuals and standalone html docs but it's a bit of a faff to install and set up especially for non-technical users.
My dream is something like pandoc but with one or more diagram libraries integrated, native PDF output and all wrapped up in a single binary, maybe with a nice web UI/editor built into the binary. Oh, and if it could manage multiple documents and versioning that would be great too. Looking for a Fossil SCM kind of feel?
Closest thing I've used would probably be LyX but that's almost too capable!
I do appreciate this is a really hard thing to do and I'm wondering what toolchains other people are using?
Emacs org-mode with babel for executing code blocks to generate the diagrams prior to exporting to html/pdf is my flow for this. It still has a steeper learning curve for non-technical users, but if you use post-commit hooks you can have people just make changes that way and let the scripts do the work.
A few folks recommended Quarto to me when I asked about current recommendations recently. My main goal is physical books and that doesn't seem to be a first class citizen anywhere. Looking through Quarto, I can't find reference to markdown syntax for index entries (which indicates that they don't support it.)
Also, I'm heavily biased, but based on my experience I will need to hack whatever tool and I'm not really interested in hacking JS/TS. (My whole reason for getting rid of my rst based tooling is to simplify and sticking in Python simplifies my life, coding in JS/TS not so much.)
I'm also very interested in physical books. Can you point me to anything that supports index entries well, regardless of the language they are written in?
I certainly agree about expecting to need to hack, whatever the tool.
I got kinda intimidated with the Asciidoc toolchain that I instead just wrote a bit of Clojure to call the Java AsciidocJ API. A tiny script that did what I want (make Reveal slides) and it's simple/straightforward and I guess crossplatform :)
There is also Orgmode and Texmacs - but I don't really like that the markup is kinda "locked" to an editor. For instance I've done stuff with Orgmode for ages, but it breaks between Emacs major versions and you can't really export it without having Emacs. I also feel like I'm in effect locked into the platform
Texmacs actually looks fantastic, but I'm nervous putting all my beans in that basket
I've created a VS Code extension that provides a live Pandoc preview with scroll sync and support for executing code: https://marketplace.visualstudio.com/items?itemName=gpoore.c.... Adding support for diagrams would just be a matter of creating a config file specifying the diagram executable and command-line options.
Last week I ported my static physical book building tooling from rst-based [0] to markdown (pandoc filter) based.
I've used my rst tooling to publish many books (like Effective Pandas) and am wanting to drop rst in an effort to simplify my life. My pandoc toolchain is not in github yet, but preliminary exploration validates that I can publish my next physical book with it (with things like front matter, indices, etc).
In the process I messed around with MyST and mistletoe. I dropped MyST because it was evident I would need to mess around with Sphinx again. Been there done that. Too much abstraction.
Mistletoe would have worked too (I need to create custom fences/markup for a few features) but I wanted to see if I could do it with Pandoc.
The Pandoc distinction between Blocks and Inlines is annoying as is the requirement to handle everything at once. With Pandoc, you only get notified at the start of an element, not the end which probably complicates it a bit more than Mistletoe would have.
(I still need to port my slide generation tooling and will probably use mistletoe for that. For epub generation I think I will stick with Pandoc.)
I have an asciidoc based chain that mostly works for generating both PDF manuals and standalone html docs but it's a bit of a faff to install and set up especially for non-technical users.
My dream is something like pandoc but with one or more diagram libraries integrated, native PDF output and all wrapped up in a single binary, maybe with a nice web UI/editor built into the binary. Oh, and if it could manage multiple documents and versioning that would be great too. Looking for a Fossil SCM kind of feel?
Closest thing I've used would probably be LyX but that's almost too capable!
I do appreciate this is a really hard thing to do and I'm wondering what toolchains other people are using?