GitBook で作成したドキュメントを GitHub Pages で公開する - まちいろエンジニアブログ
こんにちは、まちいろの工藤 (@macococo) です。 以前本ブログにて『まちいろブートキャンプの取り組みについて』という社内研修の紹介記事を書きましたが、 最近そのブートキャンプ用の資料を GitBook で作成して GitHub Pages で公開してみたので、今回はその手順を紹介したいと思います。 GitBook とは？ www.gitbook.com GitBook とは、Markdown で記述したドキュメントを HTML や PDF に変換することができるツールです。 HTML に変換できるため、HTML をホスティングすることができる GitHub Pages と組み合わせることで、Pull Request フローを通して文章作成をしつつ、ドキュメントを公開することが可能です。 GitBook 用のリポジトリを作成する まずは GitHub に GitBook 用のリポジ
GitBook/GitHub/CircleCIでメンテ可能な仕様書を書く - Qiita
はじめに あるプロジェクトで仕様書をそれなりのクオリティで書く必要が出てきました。Markdownで書きたいなーとか履歴管理したいなーと思っていたので、GitHubで管理してGitBookとしてドキュメント化することに決めました。 内容 GitBookとは？ 「Markdownで簡単に電子書籍が作れるよ」というものです。GitHubのレポジトリを指定すると勝手にホスティングしてくれる gitbook.com というサービスの他に、OSSでも公開されているので自前の構築も可能です。 gitbook.com を使えばかなり楽が出来ますが、以下の2点が問題点としてありました。 確認した時点で日本語ディレクトリだと正常に動かなかった ほかの人(主にクライアント)に見せるためにprivateで構築してコラボレーターに追加するのが面倒 そこで今回はOSS版のGitBookを活用し、自前で構築しました。
GitBook 環境を準備してみる | DevelopersIO
毎度お馴染み流浪の動かしてみた & C 芸人の Fujimura です。 最近はドキュメントを書くことが多いのですが、markdown で書かれたドキュメントをいい感じの PDF にしてくれるコマンドラインツールがないかなと google 先生や識者に尋ねてみたところ、gitbook が使えそうということがわかったため、手元に環境構築してみました。 GitbookIO/gitbook: Modern book format and toolchain using Git and Markdown インストール README.md にあるとおりに gitbook-cli を npm でインストールします。 $ npm install -g gitbook-cli これでインストールされるのはラッパーらしく、実際には gitbook の何らかのサブコマンドを実行すると、最新版がインストールされ
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
