2015-02-20

Linus Torvalds`use asciidoc

2.19: web.adda/markup/Linus Torvalds`use asciidoc:
summary:
. my programming language, adda,
includes a markup language
so that simple ascii documentation
can be converted to html with advanced features
like hyperlinks, and formatting .
. xml and html code is written in ascii
but it's not as readable by humans
since it's designed primarily for machines .
. Linus Torvalds was famous for
condemning xml and supporting asciidoc
so I became interested in studying asciidoc
and incorporating parts of that into adda markup .
. there is an asciidoc renderer for Chrome OS .

Linus Torvalds Mar 6, 2014:
"... no, XML isn't even good for document markup.
Use 'asciidoc' for document markup. Really.
[ see asciidoc.org's user guide ]
It's actually readable by humans,
and easier to parse and way more flexible than XML.
...
XML is nasty to parse for humans,
and it's a disaster to parse even for computers.
...
As to JSON, it's certainly a better format than XML
both for humans and computers,
but it ends up sharing a lot of the same issues in the end:
putting everything in one file is just not a good idea.
There's a reason people end up using
simple databases for a lot of things.
... .
. Torvalds was chief architect of the Linux kernel;
and, Chrome OS, the most secure consumer computer,
is based on the Linux kernel .
. there is an asciidoc renderer for Chrome OS .

Asciidoctor.js Live Preview:
. Render AsciiDoc (.ad, .adoc, .asc, .asciidoc)
as HTML inside Chrome!
This project, at github,
uses Asciidoctor.js to render AsciiDoc as HTML.
1. in order to render local files,
in chrome://extensions,
Check Allow access to file URLs
2. Open .ad, .adoc, .asc, .asciidoc file in Chrome

asciidoctor.js:
. uses the Opal Ruby-to-JavaScript cross compiler
to generate a direct JavaScript port of Asciidoctor,
a Ruby implementation of AsciiDoc.
The result is AsciiDoc rendering in the browser!
. instructions .
The Asciidoctor project:
. an effort to bring a comprehensive and accessible
AsciiDoc publishing toolchain,
to a growing range of ecosystems,
including Ruby, JavaScript and the JVM.
In addition to an AsciiDoc processor
and a collection of stylesheets,
It also pushes AsciiDoc to evolve by
introducing new ideas and innovation
and helps promote AsciiDoc through education and advocacy.