Hello, what packages would you all recommend for literate programming, particularly with org-mode. I am interested in using it alongside org-roam and eventually exporting some things to latex/pdf.
Been trying literate programming recently, but haven’t been able to get into a flow with it, mainly due to not being able to see the REPL (not sure why the connected REPL doesn’t show error messages or print statements), and also from not being able to use paredit/lispy inside the code block.
Any online guide would also be very welcome.
I’m not really into Org-roam, but I’ve used Org-mode quite a bit for literate programming. I’ve never felt the need for external packages beyond the ox-* ones for authoring, to be honest.
What has worked well for me is maintaining a file that handles all the auxiliary tasks, such as publishing, styling, and similar setup work. It can also be made fairly general, which makes it easier to start new literate programming documents.
You can take a look at https://github.com/dnv-opensource/reagent-flow for an example of how I usually organize things.
You mentioned that Paredit and similar tools don’t work properly. Are you trying to use them in the Org-mode context or within the Org source blocks? Getting comfortable with narrowing and widening in source buffers is really helpful, in my experience.
Thanks. Yes I was on the org-mode context and didn’t yet know how to narrow to the code code blocks. I’ve still been having trouble with how to enable lsp-org (getting this error funcall-interactively: Wrong type argument: integer-or-marker-p, nil). Any suggestion?
A breath of fresh air in this space is Clay: https://github.com/scicloj/clay ... it somewhat inverts the 'traditional' literate programming setup (in clay, the code is code and the prose is comments), and I've been delighted with it recently.
Been trying literate programming recently, but haven’t been able to get into a flow with itIMO that's almost impossible with literate programming. Half your tools and navigation break . I think it's very very frustrating to work this way, and I tried really hard to make it convenient when I was doing my MSc.
Thanks @hhausman, this looks wonderful. To be fair, it only covers part of my needs, but the fact that it’s jusrt clojure and tooling will still work (as fara as I can tell) is really nice.
For my needs org would be ideal were it not for LSP and other tools not working as I am used to. Apparently lsp-org should provide that but so far i have not be able to make it run.
One of the importat things I wanted was to show/hide text, which I intended to do with org headlines, but it seems like the hs emacs package can get me very close to that when using Clay. So thanks again @hhausman.