Login  Register

Re: Example online help created with AsciiDoctor and Jekyll

Posted by mojavelinux on Nov 26, 2018; 8:20am
URL: https://discuss.asciidoctor.org/Example-online-help-created-with-AsciiDoctor-and-Jekyll-tp6514p6615.html

Thanks for sharing and for the words of encouragment, Mark!

I do agree better installation instructions for Windows is needed. That's one of the goals of migrating the docs to Antora and a new information architecture.

Cheers,

-Dan

On Thu, Oct 11, 2018 at 11:39 PM markb [via Asciidoctor :: Discussion] <[hidden email]> wrote:
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


If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Example-online-help-created-with-AsciiDoctor-and-Jekyll-tp6514.html
To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML


--
Dan Allen | @mojavelinux | https://twitter.com/mojavelinux