Our great sponsors
-
pp
PP - Generic preprocessor (with pandoc in mind) - macros, literate programming, diagrams, scripts... (by CDSoft)
-
InfluxDB
Power Real-Time Data Analytics at Scale. Get real-time insights from all types of time series data with InfluxDB. Ingest, query, and analyze billions of data points in real-time with unbounded cardinality.
I've used a similar pipeline to create "books for code and infrastructure". A/k/a coding in a somewhat literate programming style. Similar to what is described here:
gemini://gemini.robrohan.com/2022-04-23-narrative-programming.md
With output that looks similar to this: https://github.com/robrohan/wefx/blob/main/docs/manual.pdf
Using a github action like this: https://github.com/robrohan/wefx/blob/main/.github/workflows...
(most of the code borrowed from those projects)
You can do it with just plain markdown files and use directories for chapters / organization if you're just going for prose.
I've thought about using the process to try to make open textbooks where you can mix and match chapters, but I don't have any experience in that field.
Anyway, can confirm, it's an incredibly useful process.
I wrote a tool that can process a number of MarkDown files with fragments of C code and put all those fragments in the right order to produce a file that can be compiled. It is grammar based and works with manipulating Abstract Syntax Trees, so I guess, it could be adapted for different programming languages. See: https://github.com/FransFaase/IParse#markdownc