www.digitalmars.com         C & C++   DMDScript  

digitalmars.D.announce - "Programming in D" book, draft of the first print edition and eBook

reply =?UTF-8?B?QWxpIMOHZWhyZWxp?= <acehreli yahoo.com> writes:
Main page:

   http://ddili.org/ders/d.en/


1) For the first time, there are eBook formats:

   http://ddili.org/ders/d.en/Programming_in_D_Ali_Cehreli.ALPHA.epub

   http://ddili.org/ders/d.en/Programming_in_D_Ali_Cehreli.ALPHA.mobi

I used 'calibre' to generate those "alpha" quality books. I chose epub 
and mobi just because I thought that they are the most common formats. 
Just let me know if you need another format or simply use 'calibre' or 
another tool yourself. :)


2) There has been a lot of work to make the book ready for its first 
print edition. (I will spare you the details of countless hours of extra 
work that went into this "eternal final step".)

The PDF version finally looks a lot like a real book:

* There is a Table of Contents section

* There is an Index section

* The internal links work


3) There are two new chapters:

* Lvalues and Rvalues

* Nested Functions, Structs, and Classes


4) There are the following notable additions to existing chapters:

* 'pragma' is added to the Templates chapter

* Special keywords are added to the Templates chapter (__FILE__, 
__LINE__, etc.)

* Contract inheritance is added to the 'Contract Programming for Structs 
and Classes' chapter

* The .offsetof property and the 'align' atribute are added to the 
'Memory Management' chapter


5) I am grateful to Andrej Mitrović, Steven Schveighoffer, and Luís 
Marques, who accepted to edit the book. However, they are through only 
less than 10% of the book so far. As always, current or future mistakes 
are mine. :)

Ali
Nov 26 2014
next sibling parent "Ondra" <pokorny.ondrej gmail.com> writes:
Awesome!
Nov 26 2014
prev sibling next sibling parent "Gary Willoughby" <dev nomad.so> writes:
Fantastic work.
Nov 26 2014
prev sibling next sibling parent reply "Anonymous" <anonymous nowhere.pl> writes:
Thx, your book's just helped me last night (opSlice template not 
well explained in the official html). Two questions:
- do you know that your website has serious design issue ?
- does "paper version" mean "no more free" pdf/ebook ?
Nov 26 2014
parent reply =?UTF-8?B?QWxpIMOHZWhyZWxp?= <acehreli yahoo.com> writes:
On 11/26/2014 03:42 AM, Anonymous wrote:


 - do you know that your website has serious design issue ?


Of course. :(


 - does "paper version" mean "no more free" pdf/ebook ?


My current thinking is that all of the ebook formats should be free but 
also purchasable.

A distributor like Smashwords would reach more readers. However, a 
person who is interested in D would find the book on my site anyway. (I 
wonder whether Smashwords would allow me to also provide the book for 
free on my site?)

For the print version, I am thinking about Amazon's CreateSpace mainly 
because unlike Lulu and many other self-publishing houses they accept 
more than 440 pages.

Ali
Nov 26 2014
parent reply =?UTF-8?B?QWxpIMOHZWhyZWxp?= <acehreli yahoo.com> writes:
On 11/26/2014 11:35 AM, Ali Çehreli wrote:


 I wonder whether Smashwords would allow me to also provide the book 


for free

 on my site?


Found the answer to that question:

"6c. Free Copies. As administrator of your work, Author may use the 
Smashwords platform to distribute complimentary copies of the work, or 
personally email free files to people, even when you are generally 
charging a fee. However, Smashwords files cannot be mass-distributed via 
download at blogs, websites or other retailers outside the Smashwords 
network."

   https://www.smashwords.com/about/tos

Ali
Nov 26 2014
parent reply "Joakim" <dlang joakim.fea.st> writes:
On Wednesday, 26 November 2014 at 23:16:11 UTC, Ali Çehreli wrote:

 On 11/26/2014 11:35 AM, Ali Çehreli wrote:


 I wonder whether Smashwords would allow me to also provide


 the book for free

 on my site?


 Found the answer to that question:

 "6c. Free Copies. As administrator of your work, Author may use 
 the Smashwords platform to distribute complimentary copies of 
 the work, or personally email free files to people, even when 
 you are generally charging a fee. However, Smashwords files 
 cannot be mass-distributed via download at blogs, websites or 
 other retailers outside the Smashwords network."

   https://www.smashwords.com/about/tos


I think you are misinterpreting that clause.  I had never heard 
of Smashwords before, so I just looked at their site and their 
TOS.  What they do is take your book in doc format and generate 
ebook formats that can be sold online and to other book 
retailers, as detailed in clause 5 of their TOS:

"5. Formats of Digital Conversions. Author shall submit their 
Work as a Microsoft Word .doc file. Smashwords shall utilize its 
proprietary Meatgrinder technology to convert the book into 
multiple ebook formats, and publish the work for use in sampling, 
distributing and selling the work. The author/publisher is not 
authorized to independently sell or distribute 
Smashwords-generated file conversions outside of the Smashwords 
site or Smashwords distribution network without first receiving 
written permission from Smashwords (in other words, you cannot 
use Smashwords as a free file conversion service so you can sell 
the files elsewhere). You acknowledge that if you violate this 
requirement, you may forfeit any accrued earnings at Smashwords, 
and your account may be deleted without notification."

I believe both clauses simply says you cannot distribute their 
converted ebook files: note that 6c says you cannot mass 
distribute "Smashwords files", not "the Work," which is how they 
refer to your book itself.  They also say on their site that you 
are free to use other distributors and retain copyright over your 
work.

Few would fault you for not wanting to give away free copies if 
you're selling the book, but I don't think Smashwords has a say 
in the matter.
Nov 26 2014
parent =?UTF-8?B?QWxpIMOHZWhyZWxp?= <acehreli yahoo.com> writes:
On 11/26/2014 09:19 PM, Joakim wrote:


 Few would fault you for not wanting to give away free copies if you're
 selling the book, but I don't think Smashwords has a say in the matter.


That's my understanding as well. Thank you for checking.

Ali
Nov 27 2014
prev sibling next sibling parent =?UTF-8?B?TWFydGluIERyYcWhYXI=?= via Digitalmars-d-announce writes:
This is HUGE!

I've gone through many of your chapters, but it was just now, after
seeing it as a one >700 pages long book, that I truly realized how much
of a work this must have been.

Thank you. Can't wait to have it on the shelf...

Martin
Nov 26 2014
prev sibling next sibling parent reply "Dejan Lekic" <dejan.lekic gmail.com> writes:
On Wednesday, 26 November 2014 at 10:34:24 UTC, Ali Çehreli wrote:

 Main page:

   http://ddili.org/ders/d.en/


 1) For the first time, there are eBook formats:

   
 http://ddili.org/ders/d.en/Programming_in_D_Ali_Cehreli.ALPHA.epub

   
 http://ddili.org/ders/d.en/Programming_in_D_Ali_Cehreli.ALPHA.mobi

 I used 'calibre' to generate those "alpha" quality books. I 
 chose epub and mobi just because I thought that they are the 
 most common formats. Just let me know if you need another 
 format or simply use 'calibre' or another tool yourself. :)


 2) There has been a lot of work to make the book ready for its 
 first print edition. (I will spare you the details of countless 
 hours of extra work that went into this "eternal final step".)

 The PDF version finally looks a lot like a real book:

 * There is a Table of Contents section

 * There is an Index section

 * The internal links work


 3) There are two new chapters:

 * Lvalues and Rvalues

 * Nested Functions, Structs, and Classes


 4) There are the following notable additions to existing 
 chapters:

 * 'pragma' is added to the Templates chapter

 * Special keywords are added to the Templates chapter 
 (__FILE__, __LINE__, etc.)

 * Contract inheritance is added to the 'Contract Programming 
 for Structs and Classes' chapter

 * The .offsetof property and the 'align' atribute are added to 
 the 'Memory Management' chapter


 5) I am grateful to Andrej Mitrović, Steven Schveighoffer, and 
 Luís Marques, who accepted to edit the book. However, they are 
 through only less than 10% of the book so far. As always, 
 current or future mistakes are mine. :)

 Ali


Well done, Ali - I will buy the ePub once the book is done.

One suggestion: if you can, do what Ivan Ristic does with his 
SSL/TLS books (https://www.feistyduck.com). Basically, people who 
buy his books have unlimited access to book updates. Ivan is 
sending information about book updates whenever there is 
something new, so we readers can go back to the website and grab 
the latest version of the book.

I think this is a much better approach than book editions, as 
they may appear years after each other... Sure, it is more 
complicated, but I think it pays off, and I do not mind book 
being little bit more expensive if I can access updated version 
of it.

Cheers!
Nov 26 2014
parent reply "Dejan Lekic" <dejan.lekic gmail.com> writes:
One more thing - if you have the book in some "wiki form", it may 
be a good idea to transform it into AsciiDoc as it has really 
nice ePub/PDF/HTML output.
Nov 26 2014
parent =?UTF-8?B?QWxpIMOHZWhyZWxp?= <acehreli yahoo.com> writes:
On 11/26/2014 06:27 AM, Dejan Lekic wrote:


 whenever there is something new, so we readers can go back to the website
 and grab the latest version of the book.


That has always been the case with Programming in D. Although there has 
been a hiatus of about two months this last time, Luís Marques' edits 
from this morning have already made it to the site as we speak. ;)


 I think this is a much better approach than book editions, as they may
 appear years after each other... Sure, it is more complicated, but I
 think it pays off


It is not complicated at all. I type 'make', copy the generated .zip 
file to the hosting site, unzip, and the edits are live! :) (Although, 
the .epub and .mobi formats are not integrated to the Makefile yet.)

On 11/26/2014 08:55 AM, Dejan Lekic wrote:


 One more thing - if you have the book in some "wiki form", it may be a
 good idea to transform it into AsciiDoc as it has really nice
 ePub/PDF/HTML output.


For historical reasons I started with Ddoc. I can investigate converting 
it to AsciiDoc but honestly I am not motivated much to do that. :)

Currently, Ddoc is first converted to HTML and I use the HTML to 
generate different final formats.

Ali
Nov 26 2014
prev sibling next sibling parent reply Andrei Alexandrescu <SeeWebsiteForEmail erdani.org> writes:
On 11/26/14 2:34 AM, Ali Çehreli wrote:

 Main page:

    http://ddili.org/ders/d.en/


 1) For the first time, there are eBook formats:

    http://ddili.org/ders/d.en/Programming_in_D_Ali_Cehreli.ALPHA.epub

    http://ddili.org/ders/d.en/Programming_in_D_Ali_Cehreli.ALPHA.mobi


Fantastic! I wanted to mention this on reddit but noticed that (a) 
http://ddili.org/ders/d.en/ has the left menu in Turkish, and (b) there 
are no links to the ebooks from that page.

Could you please fix that?


Thanks,

Andrei
Nov 26 2014
parent reply =?UTF-8?B?QWxpIMOHZWhyZWxp?= <acehreli yahoo.com> writes:
On 11/26/2014 09:24 AM, Andrei Alexandrescu wrote:


 I wanted to mention this on reddit


That site is fine.


 but noticed that (a) http://ddili.org/ders/d.en/ has the left menu in
 Turkish


That site sucks! :)


 and (b) there are no links to the ebooks from that page.


I intentionally did not link the alpha-quality stuff. Pictures are 
missing, chapter numbers vary between -1 and 2, etc. :p Let me deal with 
it after I eat some Thanksgiving turkey tomorrow.

Speaking of which, thank you everybody! :)

Ali
Nov 26 2014
parent "Dejan Lekic" <dejan.lekic gmail.com> writes:
No, *thank you*! - For the great work you've done! :)
Nov 27 2014
prev sibling next sibling parent "weaselcat" <weasel gmail.com> writes:
Congrats on (nearly) finishing your book. It's one of the best D
resources available and very high quality.
Nov 26 2014
prev sibling next sibling parent reply "Meta" <jared771 gmail.com> writes:
On Wednesday, 26 November 2014 at 10:34:24 UTC, Ali Çehreli wrote:

 Main page:

   http://ddili.org/ders/d.en/


 1) For the first time, there are eBook formats:

   
 http://ddili.org/ders/d.en/Programming_in_D_Ali_Cehreli.ALPHA.epub

   
 http://ddili.org/ders/d.en/Programming_in_D_Ali_Cehreli.ALPHA.mobi

 I used 'calibre' to generate those "alpha" quality books. I 
 chose epub and mobi just because I thought that they are the 
 most common formats. Just let me know if you need another 
 format or simply use 'calibre' or another tool yourself. :)


 2) There has been a lot of work to make the book ready for its 
 first print edition. (I will spare you the details of countless 
 hours of extra work that went into this "eternal final step".)

 The PDF version finally looks a lot like a real book:

 * There is a Table of Contents section

 * There is an Index section

 * The internal links work


 3) There are two new chapters:

 * Lvalues and Rvalues

 * Nested Functions, Structs, and Classes


 4) There are the following notable additions to existing 
 chapters:

 * 'pragma' is added to the Templates chapter

 * Special keywords are added to the Templates chapter 
 (__FILE__, __LINE__, etc.)

 * Contract inheritance is added to the 'Contract Programming 
 for Structs and Classes' chapter

 * The .offsetof property and the 'align' atribute are added to 
 the 'Memory Management' chapter


 5) I am grateful to Andrej Mitrović, Steven Schveighoffer, and 
 Luís Marques, who accepted to edit the book. However, they are 
 through only less than 10% of the book so far. As always, 
 current or future mistakes are mine. :)

 Ali


This is great news. I'm excited to have more than TDPL sitting on 
my shelf.
Nov 26 2014
parent "Piotrek" <no_data no_data.pl> writes:
On Wednesday, 26 November 2014 at 21:36:03 UTC, Meta wrote:

 This is great news. I'm excited to have more than TDPL sitting 
 on my shelf.


Me too. I also plan to get the D Cookbook, but I'm looking for a 
chance to get it easly in Poland.

Piotrek
Nov 28 2014
prev sibling next sibling parent "Nick " <nickbakkegaard gmail.com> writes:
On Wednesday, 26 November 2014 at 10:34:24 UTC, Ali Çehreli wrote:

 Main page:

   http://ddili.org/ders/d.en/


 1) For the first time, there are eBook formats:

   
 http://ddili.org/ders/d.en/Programming_in_D_Ali_Cehreli.ALPHA.epub

   
 http://ddili.org/ders/d.en/Programming_in_D_Ali_Cehreli.ALPHA.mobi

 I used 'calibre' to generate those "alpha" quality books. I 
 chose epub and mobi just because I thought that they are the 
 most common formats. Just let me know if you need another 
 format or simply use 'calibre' or another tool yourself. :)


 2) There has been a lot of work to make the book ready for its 
 first print edition. (I will spare you the details of countless 
 hours of extra work that went into this "eternal final step".)

 The PDF version finally looks a lot like a real book:

 * There is a Table of Contents section

 * There is an Index section

 * The internal links work


 3) There are two new chapters:

 * Lvalues and Rvalues

 * Nested Functions, Structs, and Classes


 4) There are the following notable additions to existing 
 chapters:

 * 'pragma' is added to the Templates chapter

 * Special keywords are added to the Templates chapter 
 (__FILE__, __LINE__, etc.)

 * Contract inheritance is added to the 'Contract Programming 
 for Structs and Classes' chapter

 * The .offsetof property and the 'align' atribute are added to 
 the 'Memory Management' chapter


 5) I am grateful to Andrej Mitrović, Steven Schveighoffer, and 
 Luís Marques, who accepted to edit the book. However, they are 
 through only less than 10% of the book so far. As always, 
 current or future mistakes are mine. :)

 Ali


I can't seem to get the .mobi and .epub files to work. I have
tried both with Googles play book and aldiko. I'm on a Nexus 9.
Thanks for the book.

/Nick
Nov 28 2014
prev sibling parent "John" <john.joyus gmail.com> writes:
Cool!
Nov 30 2014