I've been fascinated by Literate Programming forever.
I have two utterly divergent takes on this.
See https://github.com/slott56/PyLit-3 for one.
See https://github.com/slott56/py-web-tool for another.
And yet, I've still done a really bad design job. Before we get to the design, a little bit …
more ...Today's Example of Starting Badly: Building HTML.
The code has a super-simple email message with f"<html><body><p>stuff {data}</p></body></html>". It was jammed into an email object along with the text version. All very nice. For a moment, I considered suggesting that f-string substitution wasn't a …
more ...Let's talk small. When writing API's, it sometimes helps to have a small demo web site to show the API in a context that's easy to visualize. API's are sometimes abstract, and without an application to provide some context, it can be unclear why the path looks like that or …
more ...Check this out: "Stupid Template Languages".
Love this:
"The biggest annoyance I have with smart template languages (Mako, Genshi, Jinja2, PHP, Perl, ColdFusion, etc) is that you have the capability to mix core business logic with your end views, hence violating the rules of Model-View-Controller architecture."
Yes, too much power …
more ...For a while, I generated documentation with Cheetah. I wrote bodies as a fragment of HTML and used Cheetah to wrap those bodies in standard templates with navigation and branding. To write my books, I learned DocBook markup and used DocBook XSL tools to create HTML and PDF versions of …
more ...