swyddfa / awdur

An experiment in literate programming with docutils
0 stars 1 forks source link

hi! come join py-web-lp😃 #20

Open goyalyashpal opened 5 months ago

goyalyashpal commented 5 months ago

hi there!

would u like to try slott56/py-web-tool which is a literate programming tool written in python based on jinja & outputs primarily in rst?

alcarney commented 5 months ago

That certainly looks interesting!

At least for now though, I'd like to try a few things out in this repo and see how it goes, if it makes sense in the future we can always try to take the ideas from here over to py-web-tool (if there are any worth having of course! :sweat_smile: )

Thanks for pointing the project out!

goyalyashpal commented 5 months ago

yeah, i have been searching for a language agnostic literate programming tool, but most failed me one way or other (dont work with space sensitive language, dont provide some feature, not easily installable in windows, etc...)

this above one - i started using roughly around this pr: https://github.com/slott56/py-web-tool/pull/17 which aims to make it installable via the awesome pipx. it is such a wonderful blessing for me, as i was feeling helpless in coding without any literate tool. Donald Knuth is a genius really to ~think~, no, implement too of such a phenomenal approach.

this one is written in python, which makes it easy to tinker with - no complex build tools etc required to run it even for developing it. its quick and easy to use. it works with outputting python code too. it has got a few hitches which i am thinking on resolving gradually.

it outputs the weave in a restructured text, which is well, modern-ish markup language i guess?! 😅 . though I cant get the restructured text preview, neither in browser, nor in in vscodium to work

(read here for more info: https://github.com/swyddfa/esbonio/pull/749#issuecomment-1980314738)