I began to write my Learn Node.js
book last month. It is a self-published book project about full-stack JavaScript. The aim of the book is to help developers, switching to javascript and node.js, to hit the ground running by building and uploading a functional project. By going through the book you will be able to build features that modern javascript applications require.
My current plan is to self publish and I will be doing that using gumroad; then I will upload a copy on iBooks store; and checkout amazon's self publishing via kindle. In all three scenarios, a pdf output of the book is perfect. So, the final version of my book will be available for purchase in at least the pdf format. Asciidoc documents are perfectly converted to pdf format using asciidoctor-pdf.
I began writing my book using iBooks Author authoring tool with the intention of publishing the book on the iBooks store. However, as I progressed in my writing process, I realized that my book contained quite a bit of code blocks. I wrote about this earlier but I ended up fully re-doing my work and switching away from iBooks Author authoring tool.
Quite honestly, lack of beautiful code blocks (once converted to pdf) is why I switched my writing into asciidoc format. For images, so far I have been fortunate to use a combination of screenshots and adobe photoshop software.
For more involved diagrams, I opted out to use plantuml for diagram creation. It works pretty good and allows you to maintain your images in plain text format for backups or quick adjustments.
I spent a few hours killing time by working on the book cover marketing material. I found https://www.freepik.com/ to have many wonderful book cover mockups for free. There are also paid alternatives. Point is... finding a beautiful cover may take some time =)
To summarize:
write using asciidoc using vs code or asciidocfx
convert asciidoc to pdf using something like asciidoctor-pdf or asciidocfx
To publish the pdf book on gumroad one just needs to make an account.
To publish the pdf book to iBooks, one needs to connect your iCloud, in iTunes Connect, to Apple Books like so. And then you need to download iTunes Producer to upload your book to their store
To publish the pdf book to Amazon, one needs an amazon account and then head over to the kindle direct publishing
To publish the pdf book on leanpub one just needs an account
Happy writing!
I actually published my book on both gumroad and leanpub. Here are the differences in the presentation for the same content on two platforms: https://gumroad.com/l/javascript/launch and https://leanpub.com/learnnodejs . What is great about these is that I can upload a new version of the book as soon as I am done with it and the reader gets a new copy of the book. So far, gumroad has been the easiest to use and setup.
gumroad links are no longer to my product
Self-publishing a technical book as well. It's a lot more time consuming than I thought. The code blocks bug me too, I was half-tempted to color code them all myself word by word but that's time consuming. Your approach though is interesting.
P.S - We're hacking away on Mavenseed (https://mavenseed.com), would love for you to consider the platform for selling your book vs Gumroad. I use Mavenseed myself to sell my eBook (s). Happy to answer any questions.
Hey! Yeah that's what I did at first with iBooks Author and it is time consuming. However, the output in the authoring tool... is acceptable. It is however, when I converted it to pdf that the output looked bad. I talked about it and the issues I had with the process in one of my previous blog posts https://getaclue.me/asciidoc-vs-ibooks-author Cheers