Demo using AsciiDoc and Asciidoctor to build rich technical documentation. Includes:
- Setting up Ruby, Asciidoctor, Graphviz and Pandoc
- Using AsciiDoc and PlantUML to create technical documents
- Exporting documentation to HTML, PDF, Word, and Markdown format
- Upload Markdown files to GitHub Wiki
Some manual steps, not covered by workflow, are required to provision and upload content to GitHub Wiki.
Before running workflow:
-
Make sure Wiki is enabled in your repository, by going to repository settings.
-
Create a single page on repository Wiki. You do not need to add any content. This will trigger creation of Wiki Git repository, to which workflow will commit changes.