[nanomsg] RE: [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?

  • From: "Karan, Cem F CIV USARMY RDECOM ARL (US)" <cem.f.karan.civ@xxxxxxxx>
  • To: "nanomsg@xxxxxxxxxxxxx" <nanomsg@xxxxxxxxxxxxx>
  • Date: Fri, 16 Mar 2018 12:58:32 +0000

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

Other related posts:

  • » [nanomsg] RE: [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? - Karan, Cem F CIV USARMY RDECOM ARL (US)