Posted by abelsromero on Sep 07, 2018; 5:16pm
URL: https://discuss.asciidoctor.org/Building-websites-with-Asciidoctor-tp6461p6464.html

Welcome!

Keep in mind asciidoctor ecosystem is build on layers. Asciidoctor itself is focused on single-document rendering and leaves to other the fancy stuff like: index generation, multiple file conversion, HTML embedding, styling, etc.

* If you want a quick way to build a documentation repository, Antora is the way to go. Not only does the job mentioned above but enforces some really good practices in how to organise your docs and resources.

* If you want to build a customized static site, you can check how the asciidoctor and antora's sites are build:
- https://github.com/asciidoctor/asciidoctor.org
- https://gitlab.com/antora/antora.org
This will require some HTML/CSS work, but is not hard. I myself use this for my current project site :) Just used the antora site as a template, changed the CSS and reorganised a few things in a few days.

* If you are thinking about a blogging platform, you can check things like jbake, jekyll or https://github.com/HubPress/hubpress.io.

Also, i found some old posts in the forum, maybe they help: http://discuss.asciidoctor.org/Use-AsciiDoctor-only-for-a-simple-website-td3681.html.
btw, this is not a RTFM :)  I am aware the forum is not easy to search.

have fun!