[nanomsg] Re: Blog post

  • From: luca barbato <luca.barbato@xxxxxxxxxxx>
  • To: nanomsg@xxxxxxxxxxxxx
  • Date: Sun, 22 Sep 2013 14:53:09 +0200

On Thu, Sep 19, 2013 at 11:59 AM, Dirkjan Ochtman <dirkjan@xxxxxxxxxx> wrote:
> On Thu, Sep 19, 2013 at 11:07 AM, Martin Sustrik <sustrik@xxxxxxxxxx> wrote:
>>> Personally, I like Sphinx quite a bit. How about setting up a Sphinx
>>> project that has both the reference docs and more guide- or
>>> tutorial-like documentation?
>>
>> Any specific reason for using Sphinx over Asciidoc (given that Asciidoc
>> toolchain is already part of the build process)?
>
> I don't have a lot of experience with Asciidoc, but the web output
> seems fairly plain. I think Sphinx has better-looking and more
> functional web output as well as man page output, latex and PDF output
> options. reST also is easy to write and more of a standard, I think,
> than whatever is used for asciidoc?

Both can be made nice with theming, Sphinx default theme is a bit nice IMHO.

(reST and Asciidoc aren't much different btw)

lu

Other related posts: