My apologies for the late reply; the flu can really knock you out!
Have you looked at LaTeX (https://www.tug.org/) and
plastex(https://github.com/tiarno/plastex)? It might do what you want.
For what it's worth, I've been using LaTeX for a couple of decades now, and
been very, very happy with it. I have not used plastex, but have heard good
things about it. YMMV.
Thanks,
Cem Karan
-----Original Message-----
From: nanomsg-bounce@xxxxxxxxxxxxx [mailto:nanomsg-bounce@xxxxxxxxxxxxx] On ;
Behalf Of Garrett D'Amore
Sent: Thursday, March 8, 2018 3:50 PM
To: nanomsg@xxxxxxxxxxxxx
Subject: [nanomsg] Re: [nanomsg] Re: [nanomsg] Re: [nanomsg] Re: [nanomsg] RE:
[Non-DoD Source] [nanomsg] Would you buy a “printed” (or ebook) form of the NNG
Reference Manual?
All active links contained in this email were disabled. Please verify the
identity of the sender, and confirm the authenticity of all links contained
within the message prior to copying and pasting the address to a Web browser.
________________________________
Thanks Laurent. I intend to begin authoring a User’s Guide like that soon.
The reality is that this will take some time — books don’t write themselves
(neither does software), and I have to balance this against all the other
things I’m trying to get done.
Getting the reference manual out there lets me work through the process of
publication, using content that I’ve already written (I am the author of all
those manual pages), etc. There is of course no obligation to buy the ebook,
and I’m not suppressing content from you. :-)
In the future I might add supplementary content to the “purchased” reference
manual, perhaps additional examples or back history, I’m not sure — I’m still
thinking about that. My intent is not that you have to purchase the book to
understand how to use nng.
One other thing I’ve learned is that I need to invest a bit more time in making
the ebook / epub toolchain suck less. asciidoctor makes beautiful PDFs
(although even it has glitches and annoyances — it’s handling of footnotes is
utterly broken and its pretty inflexible about some details in the front matter
handling), but the epub backend is pretty raw, and does horrible things to
layout. I spent a lot of time on that portion already, and I’m considering
deep diving into the source for the epub backend myself to see if I can make
other larger changes to fix it — of course I really don’t want to write a bunch
of software just so I can write about writing software.…
(Nits in Asciidoctor: definition lists need horizonal style support (both PDF &
epub), the admonition blocks need to layout using a horizontal table for their
icon (epub), and for whatever reason I can’t make pygments source code
highlighting work (epub). I also want more control over front matter and ToC
placement.)
- Garrett
On Thu, Mar 8, 2018 at 12:23 PM Laurent Alebarde <l.alebarde@xxxxxxx <
Caution-mailto:l.alebarde@xxxxxxx ;> > wrote:
Le 27/02/2018 à 03:18, SGSeven Algebraf a écrit :
I’m also contemplating writing a real “User’s Guide” — more
like a traditional tech book with tutorial and recipes, sort of like “NNG for
Dummies” (perhaps titled “Building Distributed Applications with Scalability
Protocols” — which could cover nng, mangos, and even legacy nanomsg.
I would definitely buy the “User’s Guide” - for almost any
price :)
So am I !
A User's Manual would be far more usefull than the reference manual
which is up-to-date online.
ePub is a must for e-readers, pdf sucks on these devices, and e-reader
is better than PC for this kind of book.
For a complete user's guide with concepts, simple and complexe use
cases, rationals, and understanding (not stupid receipts), links to download
the examples, I would pay $50 for nan ebook, and zero for a paper one. Paper is
useless because we all use e-searching and we want to save trees.
Cheers,
Laurent