Re: Building websites with Asciidoctor
Posted by
mojavelinux on
Oct 09, 2018; 11:47pm
URL: https://discuss.asciidoctor.org/Building-websites-with-Asciidoctor-tp6461p6506.html
Excellent summary Abel! Thanks for putting that together.
-Dan
On Fri, Sep 7, 2018, 11:16 abelsromero [via Asciidoctor :: Discussion] <
[hidden email]> wrote:
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!