3 ms·
I do something like this with Asciidoc's include directive, but including to a tagged region in the source, with the tags in a block comment. The include lives
by MilStdJunkie 4y ago
I do something like this with Asciidoc's include directive, but including to a tagged region in the source, with the tags in a block comment. The include lives in a code block, so it gets formatted right.
- rupertdenton 4y agoThat's really interesting. How do you find using that process? I haven't seen it in action.
- MilStdJunkie 4y agoSorry for the delay! I made up an example in Python. See also https://docs.asciidoctor.org/asciidoc/latest/directives/include-tagged-regions/ https://docs.asciidoctor.org/asciidoc/latest/directives/incl... Asciidoc document: // Asciidoc begins = Test include to code Here's a paragraph. Let's take a look at a code block plus an include [source, python] ---- include::loops.py[tag=count] ---- Python code filename loops.py # Python begins # // tag::count[] count = 0 # // end::count[] while count < 5: print(count) count += 1 # This is the same as count = count + 1 Output (text) - this is formatted in HTML or PDF as title, para, then a code block Test include to code Here’s a paragraph. Let’s take a look at a code block plus an include count = 0