Closed klauer closed 2 years ago
Despite the above, I'm going to redo this entirely working with docutils.nodes
and sphinx
addnodes
(removing Jinja from the equation). It's a more standard way of doing things, though I'm not finding much documentation on how those nodes should be structured, so it may take a bit.
There's still a lot left to do here, but the structure is OK enough as-is to merge for now.
There will be follow-ups down the line at some point. One day entire PLC projects' API will be easily documentable in sphinx, but today is not that day...
Changes in no particular order
Meta
instances are transferred over fromlark
toblark
; add explicit dataclass attributes for themblark parse
CLIblark.transform
(never 100% happy of course)Documentation?
So far, just function blocks + methods:
Generated by way of pointing to the project in Sphinx
conf.py
:sphinx
ordocutils
a required runtime dependency to blarkThings which I don't have a clue how to approach just yet: