DEV Community

Cover image for Self-publishing a technical book
Alex Kluew
Alex Kluew

Posted on • Updated on • Originally published at getaclue.me

Self-publishing a technical book

I began to write my Learn Node.js (working title) book last month. It is a self-published book project. 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

Oh yes, leanpub is another option if you would like to stick to markdown and not interested in learning the power of asciidoc.

Happy writing!

Discussion (14)

Collapse
jvarness profile image
Jake Varness

What would you say your biggest hurdle in writing a book has been so far? The motivation, the confidence, the subject matter, all the toilet paper in the whole world is gone?

I have considered writing a book but I have doubts about what kind of audience I'd really be targeting and if they would be receptive.

Collapse
getaclue profile image
Alex Kluew Author • Edited on

Thanks for the question Jake. The impostor syndrome is definitely there but the biggest hurdle is knowing when to stop writing and when to expand. Keeping the target audience in mind helps but I definitely see where an editor is needed =)

Collapse
cescquintero profile image
Francisco Quintero 🇨🇴 • Edited on

Hi Alex!

It's great you are writing your own book. I wanted to ask about Leanpub but saw the last line :)

I wanted to ask about it because that's the service I used to publish a handbook I wrote and published between 2018-2019. Know that you have a great service there in case you'd need it.

Besides, I sent my book to Publish Drive which is a service that helps you distributing your book to several book platforms like Play Books or Scribd. I also used Pandoc to generate some PDFs of the handbook. It's really powerful.

Going to take a look to Gumroad. Knew the service before but never taught about to publish a book 🤔

Wish success with your book 😁

Collapse
getaclue profile image
Alex Kluew Author

Thanks for the kind words and experience feedback! Yeah gumroad is neat - they even stamp the pdf file with the person who purchased it for you for free - help.gumroad.com/article/130-pdf-s...

Collapse
kris profile image
kris

Hi Alex

I currently writing books too and saw your book is high quality
why not submit to one of the big publications? I'm sure the editor will love you so much
and came across your blog what program your use for write Asciidoc?

I already know markdown it's give me enjoy writing experience but will do some serious project like the book it's taking me to hurt a lot also when over hundred-page markdown will cut image because they no provide a page break

my book currently over two hundred pages live Google docs, fortunately, someone builds an extension for handle syntax highlight

and for marketing part is long run we need to handle full-stack
I thought the book is part of the big picture for making a six-figure income
when a visitor comes to our site generate money instantly from some PPV ads next will chance to make a sale on affiliate or buy book subscribe to saas as long as our site has growth also will increase the authority we can sell guest post or backlink
six

also, thank again for introducing to Asciidoc

Collapse
getaclue profile image
Alex Kluew Author

Good question Kris,

I guess I never thought about approaching a publication but that may be in the cards for the future. I am glad that you are a fan of Asciidoc, it really is a nice tool. Congratulations on your book as well!

I write my book using VS Code and, from time to time, asciidocfx.com/. I use antora.org/ to generate a static book website and asciidoctor.org/docs/asciidoctor-pdf/ to generate the pdf. asciidocfx.com/ is used to generate the epub version.

Good luck on finishing and publishing the book!
If you have any other questions or concerns please do let me know.

Thanks,
Alex

Collapse
manishfoodtechs profile image
manish srivastava

Nice Alex... good article

Collapse
getaclue profile image
Alex Kluew Author

Thank you Manish

Collapse
chrisrhymes profile image
C.S. Rhymes

Great looking book! How do you find gumroad? I’ve published my book on there (also pdf generated from asciidoc) but I’m not getting much visibility. I need to put more effort into marketing. Any tips where to start?

Collapse
getaclue profile image
Alex Kluew Author

Good day C.S.,
Unfortunately I have the same experience as you. If you are looking towards moving serious volumes, you will need to invest into marketing. I believe this holds true regardless of your audience size. At the moment, for 2020, I would suggest finding the best reddit area for you to advertise in. Alternatively, use your social media networking resources. Heck, dev has its own listing area on the front page -- list it there (I did). Beyond this, I would recommend finding an area where your audience hangs out and participate there. Or... you could write your book or an outline or a project proposal and work with a publisher.
Hope it helps.
Cheers,
Alex

Collapse
rimutaka profile image
Max

Alex, what do you use for spelling/grammar/style checking?

Collapse
getaclue profile image
Alex Kluew Author

Hey Max,
I kind of just write everything out that is in my head that I want to get out. I don't worry about anything at this stage, just getting the content out of my head. I then proceed to move things around based on themes or topics. This is where having an outline really helps. Prior to writing the book, I wrote out the rough outline that I wanted to cover in the book. The content just kind of flows following the outline.
For styling, I try to keep my sentences simple and that makes editing easier. If I have long sentences, I tend to split them up into simpler ones. Sometimes, I cannot do that but that is ok. From time to time I use the hemingwayapp.com/ app.
As for spelling and grammar, I rely on the built-in dictionary and spelling features of the editor.
At the end of the day, you, alone, can only do so much and this is where editors/readers provide the best feedback. Just get the text out of the door and in the hands of your customers, and make it easy for yourself to edit the book as feedback comes.
Hope this helps a bit.
Alex

Collapse
tomavanc profile image
Tomas Vancoillie

Hi Alex, great article. I really like the book cover! I'm definitely interested in reading the e-book, when will it be ready?

Collapse
getaclue profile image
Alex Kluew Author

Thanks for asking Tomas. The book plus source code is already available in its current state via gumroad.com/l/RtFXDH =) It is a work in open project, so while I'm writing it I could incorporate requests or clarifications from readers. As a buyer, you will have update notifications when I upload a new version. Having said that, I think I have quite a bit of meat already in there to get you going: user accounts, seo, authorization and authentication, secure forms, good defaults, maps, search, and pagination.

Thank you to those who have purchased if you read this here =)