These static site generators either natively support source files in AsciiDoc format or can be readily extended by an existing plugin. Not all generators have been evaluated; this is just a list of claims.
Application |
Adoc Support |
Source Lang |
Web Resources |
Jekyll |
plugin |
Ruby |
|
Hugo |
plugin |
Go |
|
AweStruct |
native |
Ruby |
|
Antora |
native |
Node.js |
|
Middleman |
native* |
Ruby |
|
Grain |
native |
Java/Groovy |
|
Nanoc |
native |
Ruby |
Awestruct is now defunct (despite the fact that it's still used for asciidoctor.org).
The Middleman plugin is also maintained by Asciidoctor atm.
There's also https://github.com/cryogen-project/cryogen
Very cool @bbatsov -- I've added it. First Clojure and Selmer entries!
Are any of these good for blogs other than cryogen?
pzdcdoc.org - it is not exactly site, but more documentation book. Extended AsciiDoctor, written on Java.
Awesome list, thanks Brian
Grain seems to be stale if not defunct, groovy no more
https://github.com/sysgears/grain/issues
https://github.com/sysgears/grain/graphs/code-frequency
https://github.com/gollum/gollum#markups is a wiki with optional asciidoc support
This is a good one https://github.com/Dev-Mind/devmind-website
actually one of the best static site generators with asciidoc support (Asciidoctor.js) I found yet, the author is very humble and states "it is a Node module for Asciidoctor.js and Handlebars using Gulp". In my opinion it deserves to be a full fledged SSG with themes, plugins and everything.
came across Hexo while checking the https://gitlab.com/pages SSGs
"....Hexo support posts written in any format, so long the corresponding renderer plugin is installed. It can be in markdown, ejs, swig, nunjucks, pug, asciidoc, etc. Regardless of the format used, those three code block syntax will always be available."
https://hexo.io/docs/syntax-highlight#How-to-use-code-block-in-posts
Awesome!
For Pelican plugin, by default, it supports legacy asciidoc and asciidoctor.
It would use asciidoc if it is installed.
If you want to use asciidoctor then just uninstall asciidoc and then install asciidoctor only.
https://github.com/getpelican/pelican-plugins/blob/master/asciidoc_reader/asciidoc_reader.py#L44
Is there a mistake on Antora? Should the source language be JavaScript (based on https://jamstack.org/generators/antora/)?
Very helpful. Thanks!
JBake supports also pebble now https://jbake.org/docs/latest/#templates_directory
➕
| Application | AsciiDoc Support | Source Lang | Template Lang |
|---|---|---|---|
| docToolChain | native | Groovy | arc42 |
is wrong in my eyes since
➕
| Application | AsciiDoc Support | Source Lang | Template Lang |
|---|---|---|---|
| Hugo | plugin |
I don't see that there is an optional plugin but you have to just install the asciidoc command, then the converter can be called for .adoc ?! can't it?
^^ what is the definition of "native" and "plugin" here?
Nice list, I would like to ask whether this app can be part of this list.
| Application | AsciiDoc Support | Source Lang | Template Lang | Web Resources | Notes |
|---|---|---|---|---|---|
| asciidoc-site-generator | native (asciidoctor) | JavaScript (Node.js) | Handlebars | Source GitHub | A website generator with very small footprint. |
The links for Shitty SSG seem broken to me. The new link might be https://codeberg.org/ewintr/shitty-ssg
The links for Shitty SSG seem broken to me. The new link might be https://codeberg.org/ewintr/shitty-ssg
That link is broken too. I found this one: https://ewintr.nl/shitty-ssg/
Thank you! This is really helpful
I have just posted a major update to this matrix. I removed a couple of tools and added several. I also made lots of corrections to the info and formatting, as well as adding FOSS licenses for each. I intend to release the source code for the YAML I use to maintain all of this data, as well as the template I use to parse it into AsciIDoc, as soon as I can get the rest of its parent repo ready for public release. Happy to take comments, suggestions, additions, etc.
NOTE: I removed LiquiDoc and docToolChain because I believe they are more like frameworks than SSGs themselves. I am going to create/add a file for frameworks and other integrations at some point.
Next step (and a very important one) would be Astro
Next step (and a very important one) would be Astro
I second this proposal
Next step (and a very important one) would be Astro
+1
Added Astro, by sudden popular demand.
Added Astro, by sudden popular demand.
💯
Added Astro, by sudden popular demand.
Astro plugin does not work for the latest major version of Astro (v5)
Please add this: https://github.com/gabevenberg/ASCIISite
There is yupiik-minisite that is focused on asciidoc only and we also provided the asciidoc-java and ascii2svg modules.
Hello!
I have updated dependencies for https://github.com/Dev-Mind/devmind-website/releases/tag/1.0.0
it's a fairly simple Gulp based static site generator based on Asciidoctor.js
I have no uses for it currently, so I'm planning to archive it since I'm not a JS programmer.
https://github.com/AsciiWriter/asciiwriter
It's meant as a base to make something that suits your own site.
I just added GitBook but immediately removed it when someone noted that the currently supported version does not support AsciiDoc. Bummer.