Programming

21526 readers

547 users here now

Welcome to the main community in programming.dev! Feel free to post anything relating to programming here!

Cross posting is strongly encouraged in the instance. If you feel your post or another person's post makes sense in another community cross post into it.

Hope you enjoy the instance!

Rules

Follow the programming.dev instance rules
Keep content related to programming in some way
If you're posting long videos try to add in some form of tldr for those who don't want to watch videos

Wormhole

Follow the wormhole through a path of communities [email protected]

founded 2 years ago

MODERATORS

[email protected]

Entangled: Literate Programming in Markdown (entangled.github.io)

submitted 3 weeks ago by [email protected] to c/[email protected]

1 comments fedilink hide all child comments

Perhaps the most powerful and widely used tool for literate programming ist Emacs org-mode with the babel extension. I have used it, and it is good!

However, org-mode puts a hurdle to novice users - to practice literate programming, they need to learn a bit of Emacs, which is a task in itself.

I linked the above project because it has two interesting properties:

One can write the literate document in Markdown. This is not as powerful as org-mode, which is tailored to larger documents, but very accessible.
One can modify the generated source files directly, and they are automatically read back into the literate document. This makes it much easier to work with existing tools that modify source code.

top 1 comments

sorted by: hot top controversial new old

[–] [email protected] 4 points 3 weeks ago

I've used rmarkdown back when i was in academia, having dabbled in jupyter years before. I think the main issue with literate programming is knowing your target audience. people differ wildly in their tech skills, and i guess that those people who use literate programming to its potential are the same who are happy to use org-mode.

others just copy paste their analysis scripts they cobbled together into whatever interface and copy the result into word and start formatting.

just a thought