DocOps / liquidoc-gem

The canonical gem source for LiquiDoc, a ruby-based documentation parsing and rendering utility enabling advanced builds with Asciidoctor, Jekyll, Liquid, and semi-structured data files.
https://docs.docops.org/liquidoc-user-manual.html
MIT License
12 stars 5 forks source link

Make Asciidoctor interface more directly/fully manageable #20

Open briandominick opened 6 years ago

briandominick commented 6 years ago

There are already several shortcomings to the Asciidoctor gem call in LiquiDoc's render operation. Make sure user's don't lose any of the power over Asciidoctor by sending their build orders through LiquiDoc. We're trying to make it way easier to do some things than it is now, and even if other aspects need alteration (like attributes handling), we certainly should not be sacrificing any Asciidoctor functionality. This will have include invoking extensions, as well. No major tradeoffs.

briandominick commented 5 years ago

Render stages should accept a list of required extensions.

  builds:
    - output: _build/user-guide.pdf
      doctype: book
      attributes:
        sample_attr: test value
      extensions:
        - git-metadata-preprocessor
        - shell-session-treeprocessor