티스토리 수익 글 보기
-
Star
(108)
You must be signed in to star a gist -
Fork
(8)
You must be signed in to fork a gist
-
-
Save briandominick/e5754cc8438dd9503d936ef65fffbb2d to your computer and use it in GitHub Desktop.
There are 28 static site generators that support AsciiDoc sourcing.
| Application | AsciiDoc Support | Source | Templates | Web | Notes |
|---|---|---|---|---|---|
11ty |
plugin |
Node.js |
Liquid, Nunjucks, Handlebars, Mustache, EJS, Haml, Pug |
|
|
Antora |
native |
Node.js |
Handlebars |
|
|
AsciiBinder |
native |
Ruby |
Tilt, ERB |
|
|
asciidoc-site-generator |
native |
Node.js |
Handlebars |
|
|
Astro |
plugin |
JavaScript |
Astro (JSX-like) |
|
|
AweStruct |
native |
Ruby |
Haml |
|
|
Cryogen |
native |
Clojure |
Selmer |
|
|
Dev-Mind Website |
native |
NodeJS |
Handlebars, Gulp |
|
|
DocPad |
plugin |
Coffeescript |
Eco, Jade, Haml |
|
|
Docsify |
plugin |
JavaScript |
Markdown |
|
|
Grain |
native |
Groovy |
Groovy |
|
|
Gatsby |
plugin |
React JS |
JSX |
|
|
Gollum Wiki |
native |
Ruby |
Mustache |
|
|
Hexo |
plugin |
NodeJS |
Swig, EJS, Haml, Jade, Pug |
|
|
Hugo |
native |
Go |
Go |
|
|
JBake |
native |
Java |
Freemarker, Groovy, Thymeleaf, Jade, Pebble |
|
|
Jekyll |
plugin |
Ruby |
Liquid |
|
|
Metalsmith |
plugin |
JavaScript |
Handlebars |
|
|
Middleman |
native |
Ruby |
ERB, Haml |
|
|
Nanoc |
native |
Ruby |
ERB |
|
|
Nikola |
plugin |
Python |
Mako, Jinja2 |
|
|
Nuxt |
plugin |
Vue.js |
Vue |
|
|
Orchid |
plugin |
Java |
Pebble |
|
|
Pelican |
native |
Python |
Jinja2 |
|
|
PzdcDoc |
native |
Java |
Jinja2 |
|
|
Shitty SSG |
native |
Go |
Go |
|
|
Spring REST Docs |
native |
Gradle |
Mustache |
|
|
SvelteKit |
plugin |
JavaScript |
Svelte |
|
I am working on a way to source this in YAML and convert with AsciiDoc. The tooling is not quite ready, but I found some new SSGs and wanted to get them added before Write the Docs Portland, so we can show off the growth and reach of AsciiDoc! So I used the tool to generate this and will eventually automate publishing this Gist on update. I’ll be releasing it all shortly.
I just added GitBook but immediately removed it when someone noted that the currently supported version does not support AsciiDoc. Bummer.
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
- it is not native, it uses asciidoctor or other generators with asciidoc support
- srcLang is java to me since it uses jbake, perhaps there are bash / powershell scripts around that ..
- Template Lang is defined by jbake
➕
| 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
Thank you for the update.
I found one more, Orchid supports AsciiDoc.