Posted by markb on Oct 12, 2018; 5:39am
URL: https://discuss.asciidoctor.org/Example-online-help-created-with-AsciiDoctor-and-Jekyll-tp6514.html

I've started using AsciiDoctor with Jekyll to build online help for my tech writing clients.  I do use Markdown too sometimes, but when I need to reuse content across multiple books I turn to AsciiDoctor for its includes and variables.  I thought you might be interested to see a screenshot of the result.



Here's the URL: https://www.scitechcontentservices.com/images/portfolio/original-size/adocjekmodel1.png

To protect client confidentiality, I've replaced the text and branding with generic content.

As I don't have an IT background, it hasn't been easy to work out some of the technical setup, but I'm happy with where I've been able to take it.  I love AsciiDoctor. I just wish the process of installing it on Windows and setting up a useful publishing toolchain was better documented for non-technical mortals. That's not a criticism -- I just think there's an opportunity to help even more people get to know the technology.

Thanks to everyone who has contributed to this awesome product!

Mark