hello,
i'm using asciidoctor at the moment to write "lab instructions" type documents. it all works well enough.
i'm interested in improving the quality of these instructions by producing documentation that's not necessarily static, not for print. i'm specifically looking for features such as these:
* the ability to show two (or more) alternative sets of instructions by using a tab widget. here's a simple example of what i mean, taken from the spring.io projects, where they display both maven and gradle dependency information, and an end-user can simply pick the one that is applicable to their situation:
http://projects.spring.io/spring-boot/#quick-starti'm not particular about how things render. i think a simple tab view would do just fine. other than a renderer, this would necessitate the ability to annotate a paragraph or section of a document as an "alternative."
* the ability to expose a clipboard "copy" button to make it easy for students to grab a link or a piece of information, like
https://clipboardjs.com/ or what we see on github when you want to clone a repository.
here also i suspect there would have to be a way to annotate a piece of text that an author would be interested in exposing for copy-to-clipboard consumption.
* expandable/collapsible sections, that makes it easy for a reader to focus on one section of a potentially lengthy listing.
i.e. i want to produce web-based/online instructions that are not necessarily designed to be printed, but rather interacted with.
[a] does any tooling exists either within or outside the realm of asciidoc that might lend itself to this use case?
[b] do you have any suggestions on how i might go about producing such an end result?
thanks!
/ eitan