githubにだいたい書いてあるのを一通りやってみる。
Install
nodistとかいうのでnode, npmを導入済み。
$ npm install gitbook -g
$ mkdir gitbook-practice
$ cd gitbook-practice
$ vim README.md
$ vim SUMMARY.md
$ gitbook serve
README.md
# About this repository
This repository is a practice on gitbook.
`I like this kind of tool.`
SUMMARY.md
* [Yukaary on the ebi fly](docs/README.md)
* [why ebi fly](docs/section1-1.md)
* [the histroy of makimaki](docs/section1-2.md)
* [The time she was born](docs/section1-2-1.md)
* [Meet yukarin](docs/section1-2-2.md)
* [Zunda-mochi terrolism](docs/section2.md)
* [Threaten under green nats](docs/section2-1.md)
* [Cultic leader Zunko Touhoku](docs/section2-2.md)
4000番ポートでサーバーが立ち上がってhttp://localhost:4000で整形されたコンテンツが見えるようになった。
Configuration
book.json
ってのをリポジトリの直下に置いておけば設定を読むよと書いてある。設定項目とその意味は」githubのREADME.mdに全部掲載されている。
出力形式
gitbook build, gitbook serveではドキュメントの出力形式を選べる.
- site (デフォルト)
- page
- ebook
- json
ebookでPDF出力ができるみたいだけど、ebook-convertとかいうのが必要らしい。なんぞこれ。
Calibre
少し調べた結果、Calibreというフリーで使える電子書籍のアプリケーション?にebook-convertが含まれているのが分かった。
さっそくインストールするとC:\Program Files (x86)\Calibre2
にebook-convertを確認。これでPDF出力できるんじゃないかなっ。
$ gitbook build ./gitbook_sample -f ebook --output=./out
Starting build ...
Successfully built!
やったぜ。outディレクトリの中にindex.pdfを確認。開いてみたらさっき書いた内容が載っていた。
あとは画像を掲載できるか確認すれば一通り使えるんじゃなかろうか。最近何かと頭を抱えているJavascriptの書籍がgitbookで書かれていた。無料みたいだし後で読んでみようかな。
Sparkleshareと連携
これとSparkleshareを組み合わせたらとても便利なんじゃないかな。時間があったら試してみよう。
No comments:
Post a Comment