Example online help created with AsciiDoctor and Jekyll

classic Classic list List threaded Threaded
1 message Options
Reply | Threaded
Open this post in threaded view
|

Example online help created with AsciiDoctor and Jekyll

markb
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