I would vote against:
- github: font size too small
- riak : example code does not stand out enough (white background like the
rest of the text)
The others are looking good enough, the default being my favorite.
Regards,
Benoît
On Fri, 15 Apr 2016 at 20:52 Garrett D'Amore <garrett@xxxxxxxxxx> wrote:
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
