PoetGrant's Press

Inside the Mind of PoetGrant

Prepping for Publication

May 08, 2019 — Grant Ford

I am about 40,000 words into Part 1 of The Art of Gods and I have been thinking about how to style the book, how to publish it, how to manage it, how to update it, and so on. People tell me not to think about publication until the rough draft is finished, however I realized about 10,000 words in that I need to think about styling and how the manuscript is composed way ahead of time in order to save time later. So I started reading around the web and found ASCIIDoc.


I tried going the LibreOffice way and writing everything there, but when I exported to EPUB it really didn't fit my workflow. I got to thinking that I really wanted to just pop open a terminal and nano into a file and start writing. I haven't set my Slackware system to `startx` on boot, so perhaps I don't want to boot into the graphical desktop and I just want to type in `nano manuscript.txt` then start writing. So I needed a way to style everything for EPUB format. Markdown would have been fine, but I wanted to make sure I wasn't missing anything. Thus I found ASCIIDoc in its own little corner of the interwebs! ASCIIDoc allows a person to do all sorts of awesome things like automatically setting up a table of contents, linking that table to each chapter of a book, creating a dedication that is a separate object from the title and contents, and tons of other little tweaks to the document. ASCIIDoc really got me excited about writing again. I can style as I go, then run the file through ASCIIDoctor and it can output an EPUB for me, no hassle. Then I just setup my style sheet for the document and bada bing bada bang, I have an EPUB of my manuscript!

So as I go forward, I will be styling the document using ASCIIDoc, so that nearer to the end of this year when I should have the first rough draft done, I can see what it will look like in full published form. ASCIIDoc has made something mysterious and fantastical (e.g. self publishing) seem so much easier and understandable.

If you haven't heard of ASCIIDoc, I recommend you going and taking a look. There are a ton more use-cases for the technology than just publishing a book. You'll have to read through their site to learn more.

Cheers!