Create our Example Book
First create the contents of our Example book:
bundle exec rake skel
Now create the actual books:
bundle exec rake all[Example]
Open the “Books” directory to see the results.
Start a New Book
Use Rake to create a new book. It creates everything needed and puts it in the right places so that you can just write.
Run the command bundle exec rake build
and enter the title of your book when prompted.
Write Your Manuscript
Paste your manuscript in Source/_includes/$BOOK-TITLE/chapters.md
Update Your MetaData
The beginning of your Source/_includes/$BOOK-TITLE/chapters.md
contains “YAML Front Matter” and is used to define metadata about your book that we use in various places for various templates. Anything with an asterisk is optional.
---
title: Title of your book
subtitle*: Optional subtitle
author: Author Name
website: Author Website
type: Genre of your book
lang: A string value in BCP 47 format: http://tools.ietf.org/html/bcp47 (example: en-US)
date: YYYY-MM-DD
year: YYYY
cover-image: Source/images/YOUR-IMAGE.jpg
publisher: Publisher of your book
rights: A single sentence regarding the licensing of your book
isbn*: Optional ISBN of your print book
isbn-13*: Optional 13 digit ISBN of your print book
epub-isbn*: Optional ISBN of your epub
dedication: Optional dedication.
identifier:
- scheme: UUID
text: A unique UUID for your ebook.
contributors*:
- designer*: Who designed your book/cover
artist*: Who created the art of your book cover
editor*: Who edited your book
book1*:
- title*: Optional books to include on the title page
link*: If you include Amazon links here, they'll get linked in the Amazon version
book2*:
- title*: Add a second book
link*: http://www.amazon.com/dp/B0090NFRY2
book3*:
- title*: This handles up to 5 books
link*: http://www.amazon.com/dp/B00HE5I1BE
review*:
- amazon*: https://www.amazon.com/review/create-review?asin=B007UIYEAW | Optional Amazon url to review your book.
magnet*:
- image*: ../Images/file0.jpg | optional image/url to add to the front matter of your ebooks to get people to join your newsletter
link*: https://www.backthatelfup.com/free-books/
---
Customize Common Pages
Open-Publisher uses three ‘common’ pages by default which are shared between all books. These pages will need to be customized with your information.
Customize the contents of Source/_includes/amazon_review.md
, Source/_includes/bio.md
, and Source/_includes/license.md
.
-
Amazon Review: This page is used for our Amazon template and is added to the last page of the book immediately following the ending. We use it to kindly request that the reader consider leaving a review and provide a link to the Amazon page where they can easily do so.
-
Bio: This page is used as a bio page for more information about the author.
-
License: This is the license page. We default to the Creative Commons Attribution-NonCommercial-ShareAlike license because that’s what we personally use. Feel free to modify it to your preferred license.
- NOTE: Due to technological limitations the license page here IS NOT used when creating a print-ready PDF which uses it’s own license page as defined in the LaTeX template at
Pandoc/templates/cs-5x8-pdf.latex
in the “Create a copyright page” block.
- NOTE: Due to technological limitations the license page here IS NOT used when creating a print-ready PDF which uses it’s own license page as defined in the LaTeX template at
Build Your Book
Use Rake script to create your books by running bundle exec rake $FORMAT[$TITLE]
Build all formats of book titled “Example”
Run bundle exec rake all[Example]
Build epub format of book titled “Example”
Run bundle exec rake epub[Example]
Build amazon format of book titled “Example”
Run bundle exec rake amazon[Example]
Build smashwords format of book titled “Example”
Run bundle exec rake smashwords[Example]
Build a generic PDF format of book titled “Example”
Run bundle exec rake pdf[Example]
Build a print-ready pdf format of book titled “Example”
Run bundle exec rake print[Example]
Build Multiple Books
Open-Publisher can easily handle multiple books.
Build ALL formats of ALL books
Run bundle exec rake all[all]
Build epub format of ALL books
Run bundle exec rake epub[all]
Build amazon format of ALL books
Run bundle exec rake amazon[all]
Build smashwords format of ALL books
Run bundle exec rake smashwords[all]
Build a generic PDF format of ALL books
Run bundle exec rake pdf[all]
Build a print-ready pdf format of ALL books
Run bundle exec rake print[all]
Delete a book
Run bundle exec rake destroy
and enter the title of your book when prompted.