テキストで書かれたドキュメントのソースをGitHubで共有してJenkinsでHTMLやPDFをビルドする環境については、@kaorun55さんや@ryuzeeさんが紹介してくださっています。 書籍執筆における、継続的なデリバリー - かおるんダイアリー ReVIEW + Jenkinsでドキュメントを常時ビルドする | Ryuzee.com コマンドラインからDropboxを操作する方法 (+Jenkinsとの連携) | Ryuzee.com 最近、コミュニティのあるプロジェクトで複数人でドキュメンテーションをすることになったので 是非、これらの環境を構築したいと思いました。まず、最初は費用が掛からない方法で、始めたいと思い、やり方を検討した結果、ドキュメンテーションのツールにSphinx、リポジトリにGitHub、ビルドにBuildHiveを利用することにしました。 Sphinx-Us
今回の本は3人で書いたこともあり、前回と比べて執筆環境を大きく変えました。 その中の一つに「最新の原稿を、すぐに電子書籍の形で確認できる」環境があります。 専門的に書くと 「Sphinxのドキュメントを、githubにpushすると、JenkinsがビルドしてePubにしてくれる」 ようにしました。もう少し砕くと 「原稿を、インターネット上で共有している場所に置くと、自動で電子書籍の形にしてくれる」 でしょうか。 具体的には、左のようなテキストが、右のような電子書籍に(自動で)なります。 自動的に生成された電子書籍を確認することで、編集者や著者が最新の原稿の内容を確認できるようになっています。 オーム社やオライリー社でやってる制作システムを自前で構築しました、ということです。 より詳細な構築方法については、反響を見て考えようかと思います(アカウント管理やなんかがちょっと手間になりそうなので
難しそうな気配を感じて二の足を踏んでいたが意外とあっさりだったのでメモ。 1. Sphinxの出力ファイルを単に配置するだけでは_staticなどが無視されて悲しくなるので、github pages に Sphinx で生成したドキュメントを公開する。 - kuma8の日記を参考に、sphinxtogithubをインストールする。(←意外とあっさりポイント1) 2. make cleanしてmake htmlし直して問題ないことを確認。 3. 今回HTMLを生成するためのsphinxのコードは今このリポジトリで管理されているので、この手元のワークツリーを空っぽにしたりとかしたくない。そこでリポジトリ内で同じリポジトリをcloneする。ちなみにいまプロジェクトルートがlearn_languageで、その中のsphinxdocってディレクトリの中にいる。 $ git clone https:/
http://pages.github.com/ GitHub Pages というものがある。簡単な規則に沿ってページを作ればサブドメインでのページが作れる感じのサービスと認識した。規則は簡単。 irof.github.com というリポジトリを作る そこに index.html を置く そしたら後はGitHubが勝手に良いようにしてくれて、http://irof.github.com/ でアクセスできるようになる。素晴らしい。（この時点では「hello, world」とだけ書いてた） でもHTMLなんていちいち書いてられないし、GitHub Pagesで紹介されているようなJekyllなんてのは知らない…と言うかHTMLはSphinxで出したい。 しかし素直に sphinx-quickstart で出力したHTMLをpushしたところで、GitHub Pagesは _ で始まるのを対象と
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
