【Document】Gitbookでイカしたドキュメントを作る
Gitbookとは
Gitbookは、Gitでの管理を意識したMarkdown記述式のドキュメンテーションツールです。
見栄えの良いドキュメントを簡単に作成・公開することができます。
GitbookではGitによってバージョン管理を行うことができます。
ソースコードのバージョン管理のようにGitでドキュメント管理用のリポジトリをローカル、およびリモートに作成でき、リモートに置かれたドキュメントは整形された形で外部に公開することができます。
Usage
Gitbook公式)はGitbook用ドキュメントのリモートリポジトリとなっており、すぐにGitbook用リポジトリを作成することができます。
1. アカウントを作成する
Gitbook公式のトップページにユーザ名・メールアドレス・パスワードを入力する欄があるので、各々入力して "Sign up for Gitbook" をクリック。
Sign up に成功すると以下のようなメッセージが出るので、入力したメールアドレスのメールボックスを確認。
するとGitbookからメールが届いているので、"Confirm email address" ボタンをクリック。
これで、アカウントは作成完了です。
2. リポジトリを作成する
次にリポジトリを作るため、右上の "New+" ボタンをクリックします。
作成するドキュメントの種類を決めます。
ドキュメントの種類は３つありますが、あくまでフォーマットなので後から修正できます。
今回は "Book & Manual" を選択します。
リポジトリ名と説明を入れたら、右下の "Create Book" をクリック。
これでリポジトリ作成完了です！
3. ドキュメントを作成する
作成したリポジトリの画面で、 "Edit your book" をクリック。
すると編集画面に遷移します。
新しいドキュメントを作ったり、既存のドキュメントを編集したりできます。
編集が完了したら右上の "publish" をクリックすると、リポジトリに編集結果が反映されます。
4. 作成したドキュメントを見る
Gitbookのアカウントホームページから、閲覧したいドキュメントのリポジトリのプルダウンをクリックし"Read"を選択。
すると現在公開されている状態のBookを閲覧することができます。
いかがだったでしょうか。
Gitbookはマテリアルデザインを踏襲したスッキリとした見た目なので、
見心地の良いドキュメントを作成することができると思います。
ブラウザ上でも十分編集可能ですが、ローカルのエディタを使いたいという方は
ローカルにGitbookをインストールするやり方がおすすめです。
こちらについても後ほど紹介しようと思います。
