Closed kalekundert closed 3 years ago
I would probably keep something like Step
, which is designed for the common case of having a single paragraph followed by an unordered list. But it would be composed of these primitives.
I'd want the list classes to have an option for whether the list items should be separated with blank lines or not.
It'd also be nice to have a wrap
object that would basically look for list and paragraphs in a monolithic string, and wrap them properly. This might mean pulling in some sort of markdown parser.
The ol
and ul
objects should support an option to specify if list items should be separated by blank lines.
Right now,
Step
andFootnote
are the only classes to help with formatting steps in python code. I think it might be useful to have broader set of such classes:paragraphs
,body
,para
,p
: wrapped textverbatim
,verb
,v
,pre
: unwrapped textul
: unordered listol
: ordered listI like the idea of kinda using the names of the corresponding HTML tags. The one unfortunate thing is that I widely use
p
as the variable name for the protocol, but I'm sure I can figure something out with that.I'll have to think a bit more about when to treat strings as verbatim.