Help us understand the problem. What is going on with this article?

MacOSでGitBookの環境をセットアップする

More than 1 year has passed since last update.

MarkDownのドキュメントをGitで手軽に管理できるGitBookを導入する。

条件:
* Mac OS Sierra
* npmがインストールされている

インストール〜ブックの作成

gitbook-cliのインストール

$ npm install gitbook-cli -g
$ source ~/.bashrc 

gitbookの初期化

$ cd [対象ディレクトリ]
$ gitbook init

以下のファイルが自動で生成されるため、これらをベースにブックを編集する。

  • README.md
  • SUMMARY.md

HTMLを出力する

gitbookをビルドすると_bookというフォルダへHTMLが出力される。

$ gitbook build

以下のコマンドでビルド&ローカルサーバーを立ち上げて確認することも可能。

$ gitbook serve

Starting server ...
Serving book on http://localhost:4000

localhostのポート4000を開く。

Kobito.f4pE0u.png

PDFを出力する

PDFで出力をする場合は、Calibreというアプリケーションが必要。
https://calibre-ebook.com/

手っ取り早くcaskでインストールする。

$ brew cask install calibre

以下のコマンドを実行すると、book.pdfというファイル名でpdfが出力される。

$ gitbook pdf

info: 7 plugins are installed 
info: 6 explicitly listed 
info: loading plugin "highlight"... OK 
info: loading plugin "search"... OK 
info: loading plugin "lunr"... OK 
info: loading plugin "sharing"... OK 
info: loading plugin "fontsettings"... OK 
info: loading plugin "theme-default"... OK 
info: found 1 pages 
info: found 0 asset files 
info: >> generation finished with success in 5.7s ! 
info: >> 1 file(s) generated

プレビューでbook.pdfを開いた場合

owlbeck
Why not register and get more from Qiita?
  1. We will deliver articles that match you
    By following users and tags, you can catch up information on technical fields that you are interested in as a whole
  2. you can read useful information later efficiently
    By "stocking" the articles you like, you can search right away
Comments
No comments
Sign up for free and join this conversation.
If you already have a Qiita account
Why do not you register as a user and use Qiita more conveniently?
You need to log in to use this function. Qiita can be used more conveniently after logging in.
You seem to be reading articles frequently this month. Qiita can be used more conveniently after logging in.
  1. We will deliver articles that match you
    By following users and tags, you can catch up information on technical fields that you are interested in as a whole
  2. you can read useful information later efficiently
    By "stocking" the articles you like, you can search right away
ユーザーは見つかりませんでした