私はどのように書いて自己私の電子ブックを公開!

最近、初めての電子書籍を書きましたBuilding JavaScript A+ Promises in 10 steps そして、両方ともそれを自己出版しましたGumroad and Amazon .
あなたが私に1ヵ月の背中を尋ねたならば、それは私が本を書いたでしょうか?私は、書いて、本を出版することはとても多くの仕事であると思いました、そして、あなたは編集者/批評家と出版家をそれに戻す必要があると思いました!JavaScript Promises 私のために常に楽しい話題でした、そして、私は常に試みて、そのgotchasとあなたが私のユースケースを達成するためにそれを使うことができる異なる方法で実験します.私はまた、ほとんどの人々はそれをよく使用することで快適ですが、それがどのように下に動作しているかを理解することになるが、それは常に明確ではなかったことが分かった.
私は最初にゼロから約束を作成する方法については、ブログを書くことを計画している+仕様.私には少し理解があった.どのように内部的に動作しますが、実際に実装を開始したとき、本当に謙虚なプロセスでした.
私は多くのエッジケースに気づいていませんでした、そして、私は固定して、構築して、繰り返す全体の旅行を文書化し始めました.
私はまた、市場の研究のほんの少しを行った私は、これらの約束をゼロから構築されているかどうかを見たかったが、私は書籍の使用方法/パターンと約束を作成することを教えたブログの一握りの話を見つけただけではなく、私は来るべき日に気をつけなさい.

This is how the book came to be!

どうやって書くの?
私は、単一のファイルにプレーンMarkdownを使用して本を書いた.私は当時の私に意味を持つようにトップレベルの見出しを使用して章を画定します.
私はそれの多くを書くために使用され、それは非常に少ない構文を知っているマークダウンを使用して超簡単だった.コード断片のためのbackticks# 見出しと- リスト用.それはすべてそこにある.

どのように、私は出版のために本を準備しましたか?
私は最初に原稿を終えて、フローのためにそれを読んでいる証拠に集中して、はっきりして、年代順に方法ですべての概念をカバーしていたことを確認しました.
一度満足して満足して満足していたコンテンツgoogle-fu すべてのフォーマットをサポートするために必要なものを参照してください.ですから、あなたが注意しなければならない三つの主要なフォーマットがあります.

PDF

エパブ

モビィ

使用するpandoc カスタマイズの少しのビットダウンから書籍を作成します.

PDF
プレーンの使用pandoc 私が欲しいものを私に与えていませんでした.それで、私は驚くべきものを使いましたEisvogel template 良い見てPDFファイルを取得します.

Please read the setup instructions which are written in detail in the above Github link.

それを動作させるために、私のソース原稿マークダウンファイルの上部に少しメタデータを追加する必要がありました.最後にトリプルドットに注意してください.

---
titlepage: true
titlepage-rule-height: 0
titlepage-background: "cover.png"
toc-own-page: true
listings-disable-line-numbers: true
...

これはtable-of-contents 別のページに、私は自己デザインのカバー写真を追加しましたCanva
もう一つ問題があった.私の全体の原稿がちょうど1つの大きいMarkdownファイルにあったので、個々の章はトップレベル見出しによって画定されました.PanDocはpdf 章が新しいページから始まっていなかったファイルは、以前の内容と連続してレンダリングされるようでした.
これを修正するために、私は、トップレベル\newpage先頭レベルの見出しは次のことを意味します

\newpage
# This is a top level heading

最終生成コマンドpdf

pandoc index.md -o "Building A+ Promises.pdf" --from markdown --template eisvogel --listings --pdf-engine=/Library/TeX/texbin/pdflatex --toc --toc-depth 2 -N

エパブ
これは電子ブックリーダーのために必要です、私は私のMacの使用Books.app テストする.
手順はほとんど同じですが、別の方法です.The metadata はファイルの先頭から削除され、yaml ファイル.私も削除\newpage タグとしては、PDFテンプレートのみだった.
使用したepubファイルをビルドするコマンド

pandoc index.md -o "Building A+ Promises.epub" --from gfm --listings  --toc --toc-depth 2 -N  --metadata-file metadata.txt --css syles.css --epub-cover-image=cover.png

スタイルシートにスタイルシートを渡すことで、いくつかのコンポーネントをスタイル化できます.以下のcssファイルを使用しました

code {
  font-family: monospace;
  background-color: rgb(247, 247, 247);
}

pre {
  font-family: monospace;
  padding: 16px;
  font-size: 80%;
  border-radius: 3px;
  background-color: rgb(247, 247, 247);
}

私は、プレーンのコードスニペットにわずかなハイライトを加えたかっただけですpandoc が追加されなかった.
The metadata.txt このように見えた

title:
- type: main
  text: Building JavaScript A+ Promises in 10 steps!
creator:
- role: author
  text: Ankeet Maini
identifier:
date: 2020-08-29

Mobi
これは最も簡単だった.私はアマゾンのキンドル自社出版社にログインしました.上記の生成をアップロードしましたepub そして互換性に変換したmobi ファイル.
私の本のレビューを読んだことがあるなら、これはすべてです.
Amazonのリストに投稿したり、直接フィードバックを送ってください.
ありがとう
当初公開https://ankeetmaini.dev/how-I-wrote-and-published-my-ebook