asciiwriter
v0.0.4
Published
Asciidoctor.js and Gulp based static site generator
Maintainers
Readme
Asciiwriter
AsciiWriter is not a full-fledged static site generator, it's a set of npm, JS, Gulpjs scripts that get you started with your own Asciidoctorjs based website using Handlebars templates. There are plenty of static site generators, most of them are using Markdown (simple rules to format text files). But there is a wide variety of simple markup languages that can do the most common tasks and range from BBcode to Org-mode. It seems difficult to strike correct balance of usability, features and remain human readable. One such text markup language stands out as being consistent and also easy to use. This is of course Asciidoc! Originally developed in Python, it has been rediscovered by Ruby community and gained a lot of traction in its Asciidoctor reimplementation, Asciidoctorjs is a JS transpiled version of it. AsciiWriter is a simplifiied fork of "Dev-Mind website" scaffold, it uses Node.js, Asciidoctorjs, Gulp and Handlebars templating engine. You can write pages with plain text using Asciidoc markup language, specifically Asciidoctor implementation. AsciiDoc is very similar to Markdown in spirit although it is not written in the same manner, the difference is that you don't have to implement special helping functions to get important features. That makes AsciiDoc text much more usable.
Main pages are generated with Articles slug and with minimal editing you should be able to adapt it to for your own purpose.
To get familiar with Asciidoc, check out Asciidoc syntax
