Chastity's Chess Challenge

Tag: publishing

  • Technical Writer

    After publishing my first Chess book, Chastity’s Chess Chapters, I have come to realize that what I was accidentally doing is the start of Technical Writing. When I think about the majority of what I have been reading in my lifetime, I discovered it was not story novels. I am much more likely to be reading a book or a PDF manual written for Open Source Software.

    In the process of writing my Chess book, I depended greatly on the Technical Writing of other people. For example

    These three people were extremely influential to what I needed to learn. The Markdown Guide provided me with the knowledge to separate chapters from paragraphs and link to images which I needed to include in my book. It also pointed me to Gabriel’s blog post about using only open source tools to publish a book. His blog post introduced me to Pandoc, which is a perfect complement to using Markdown as described in the Markdown Guide. These 3 unrelated authors of Technical Writing about how to use these Open Source tools all accidentally worked together in helping me include the images in my own book.

    The end result is that my book, Chastity’s Chess Chapters, is a Technical Writing book about how to play the game of Chess, what software and websites can help, and also some about the process of how the book was made. There were a few Pandoc commands included in the book to remind myself how I did the process of making my book files, but also for the purpose of sharing the information to help other authors write whatever books they want and get them published.

    After speaking with Career Coaches Susan Smey and Mary Helen Norris, I am starting to see that a Technical Writer is what I am becoming without even trying. The kind of things that I have been reading and writing have a name. Once you know a name of something, it can be Google searched, and then opportunities are available! I am very excited for what career I may have because of my Full Sail University education and my self taught computer skills.

  • Chapter 10: The Making of the Ebook

    In the ebook edition of this book, a few things were modified. First, the links in the table of contents were changed to internal links for easier navigation in the ebook. They no longer point to the blog posts because the idea is that the ebook can be downloaded and read without requiring an internet connection once downloaded.

    In the paperback, the links cannot be clicked because the book is literal paper and ink instead of a computer. However, they are exceptionally helpful to me as the author because it means I can quickly go to the post for that chapter and check to see if there are any new comments! However, I did not want the links to remain the same for the ebook because it is meant to help you jump to the chapter on whatever device you are reading it on.

    Once I read the Pandoc documentation on the rules for linking to existing headings within a document, I used this command to test it as HTML in a web browser.

    pandoc ChastityChessChapters-ebook.md -o ebook.html

    Once I confirmed that the links worked correctly, I then converted to an epub file.

    pandoc ChastityChessChapters-ebook.md -o ebook.epub -s --metadata title="Chastity's Chess Chapters" --metadata subtitle="Chess is not as hard to learn as you have been told!" --metadata author="Chastity White Rose"

    Then I tested the epub by opening it in Calibre to see how it looked. To my surprise, the conversion worked very well.

    These technical details about software and formatting may not mean much to you as the reader, but this is useful information worth sharing for other authors who may have the desire to write a publish a book. They may already even have a manuscript typed up but don’t know how to get it published as a paperback (the original and true form of a book) or an ebook (the modern convenience of reading a book on your phone, iPad, Kindle, Nook, Kobo, etc).

    The process of publishing my first Chess book has taught me more than I would have ever thought was possible. I hope reading my book has helped you understand why I love Chess. If you are an author who wants some help publishing your book, I can also probably guide you with a few tools and tricks I have learned.

    My number one tip I would like to give authors right now is to publish an ebook through Draft2Digital. If you can write a book and produce a high quality epub file, you can expect that it will look pretty much the same when you publish it through Draft2Digital. This book you are reading is available on the Apple Books store, the Kobo Books store, Barnes and Noble, and some lesser known online book stores that I hadn’t heard about before joining Draft2Digital. This service is the fastest way I know of to get an ebook available in as many places as possible.

    However, the best part of this is that the books you publish through Draft2Digital are also available on Smashwords. Smashwords is particularly good because if you buy a book there, you can download the epub and then load it into whichever ebook reading application you like. This way you are not locked into only one vendor and can freely read the same book if you change from using Kindle to Kobo, Nook, or Apple Books.

    For example, this ebook is available on Smashwords in both English and Spanish.

    My Chess Books on Smashwords

    Chastity’s Chess Chapters

    Capítulos de ajedrez de Chastity

    My final statement on this matter is that I still think original paperback books are superior to electronic books, but my goal is to make my books available to people who also prefer reading ebooks. It is also possible to update ebooks faster than paperbacks because there is no printing cost. Therefore the ebook may have the latest changes and corrections before the paperback does.

    Please do contact me with any questions, comments, corrections, or Chess Challenges! My email address and website are below.

    chastitywhiterose@gmail.com

    https://chastitychesschallenge.com

    Where to buy the paperback and ebook edition of Chastity’s Chess Chapters

  • Chapter 9: The Making of the Paperback

    Because this Chess book was originally written in Markdown and posted as a series of chapters to my WordPress blog, it did not have any concept of pages or margins because this is not needed to view it on the web. Making a paper book, on the other hand, is different because a physical book is a real physical object of a certain width and height. Some adjustments were needed to submit it to Kindle Direct Publishing.

    Therefore, I came up with a process to convert the text into a form that Amazon would accept for an 8.5-inch by 11-inch size book. The following are the exact steps I used with a combination of Pandoc and LibreOffice

    1. I created the default odt file that Pandoc uses for style reference. This command came straight from the Pandoc documentation.

    pandoc -o custom-reference.odt --print-default-data-file reference.odt

    1. I opened the custom-reference.odt file in LibreOffice and modified the left and right page margins to 0.5 for left and right. The images are exactly 7.5 inches wide, so this makes them perfectly centered to fit within the width margins of a page that is 8.5×11 inches. The top and bottom margins are not quite as important, but I set them to 0.5 for consistency.

    2. I also changed the style of “Heading 1” to automatically include a page break before the heading so that each chapter would start on a new page.

    3. Finally, I used the reference doc after modification as an input when making a new odt conversion of the book.

    pandoc ChastityChessChapters.md -o book.odt --reference-doc custom-reference.odt

    This file should look good enough to export directly as a PDF in LibreOffice. Although this may seem overly complicated, this process is more useful than you might expect. For one, it bypasses the use of “Industry Standard” tools like Microsoft Word that most writers think they need. Pandoc and LibreOffice are the only two software programs you need to create good-looking documents from Markdown files.

    However, this process is unnecessary for most books that contain only text. It was precisely because my Chess book had a lot of pictures that I used Markdown. I used this method because it allowed better control of the images than I could do in LibreOffice alone.

    I would also like to mention that several note-taking apps were useful to me as I was writing the book. Below are my top 3 favorite programs out of the many I installed and tried out.

    All 3 of those apps are useful for their ability to preview the output of what the source Markdown code will look like. For Mobile devices, Joplin and Simplenote are the best. For a PC with Windows, Mac, or Linux, ghostwriter is especially helpful because it works directly with plain text files on your system just like Notepad does, but it also allows a preview just like Joplin and Simplenote do. Testing the images was essential for making sure my pictures were linked correctly!

    In case you were wondering, all of the artwork was made using the program Inkscape. The Chess, Shogi, and Xiangqi pieces are either under a GPL or Public Domain license and came from open-source projects like lichess, lishogi and pychess.

    More copies of this book in paperback form can be purchased here on Amazon.

    https://www.amazon.com/dp/B0F44DG4XD

    You can buy the paperback edition of Chastity’s Chess Chapters or you can continue reading it for free on this blog.

    Chapter 10: The Making of the Ebook