7/27/2023 0 Comments Textmate python 3![]() ![]() The idea would be to edit a single file, mark the sections that are code, mark an output area for each code block. I want a tool that lets me write prose and code in the same file, then extract the code for use separately, but also run the code and re-process the input file. So my cycle goes: read docs, write code, write description (pasting in code and examples), change code, fix pasted code and examples, repeat until done.Ī quick Google search turned up a few tools I need to look into, but I’m not sure what I envision is literate programming as originally defined. The way I blog now means that I have to make sure I regenerate all examples before posting, in case I’ve edited any source files along the way. I’m specifically thinking of this for working on my Python Module of the Week series, but it could be useful in other areas as well. I’ve been doing a lot of writing about code lately, so I want to see if I can improve my tools. On the other hand, if what you’re doing is writing about code, then it seems like a great idea. ![]() Unless you’re writing libraries to be shared by other developers there’s just not a need for so much documentation. I never really bought into that idea it seemed like a lot of extra overhead. The benefits are supposed to be exceptionally well documented code, since you’re essentially writing the documentation first and code later. My understanding of the gist of the idea is that you write prose and code together in a file, then use a set of tools to split them apart as part of a build process. I’ve seen discussions in the past of something called “literate programming”. Failing that, maybe someone looking for a project to start will like this idea. I’m hoping someone out there had the same idea already and written something that works sort of like what I want. It’s one of those things I just can’t seem to let go of, but I don’t really have time to build it right now. I’ve had an idea kicking around in my head for a couple of days. ![]()
0 Comments
Leave a Reply. |
AuthorWrite something about yourself. No need to be fancy, just an overview. ArchivesCategories |