[nanomsg] asciidoctor formatted pages… samples posted

  • From: "Garrett D'Amore" <garrett@xxxxxxxxxx>
  • To: "nanomsg@xxxxxxxxxxxxx" <nanomsg@xxxxxxxxxxxxx>
  • Date: Fri, 15 Apr 2016 11:51:50 -0700

I’ve a plan to switch out asciidoc + xsltproc + xmlto to a single
asciidoctor based formatter.  This is because there were bugs in the old
tool chain that I couldn’t easily resolve, and I hate toolchain debugging.
asciidoctor is a superset of asciidoc, and installs with a simple gem
install asciidoctor

So I’ve posted sample output of asciidoctor formatted man pages - there are
multiple theme options included — I prefer the “colony” theme so that’s
what’s in my PR.

That said, I can easily change the theme (a .css file) out.  Here are the
samples (I recommend looking at the nn_get_statistics() page since that
demos the admonition callout too:

Test... formatted pages can be found at

coloy: http://nanomsg.org/asciidoctor/colony/nanomsg.7.html  ;(this is what
I have used for default now, and reflects my first choice)

asciidoctor: http://nanomsg.org/asciidoctor/default/nanomsg.7.html
github: http://nanomsg.org/asciidoctor/github/nanomsg.7.html
golo: http://nanomsg.org/asciidoctor/golo/nanomsg.7.html
maker: http://nanomsg.org/asciidoctor/maker/nanomsg.7.html
readthedocs: http://nanomsg.org/asciidoctor/readthedocs/nanomsg.7.html
riak: http://nanomsg.org/asciidoctor/riak/nanomsg.7.html
rubygems: http://nanomsg.org/asciidoctor/rubygems/nanomsg.7.html

Let me know what you think. :-)  Hopefully these should be mobile device
friendly too…

 - Garrett

Other related posts: