Read The Docs (Sphinxドキュメントホスティングサービス) が便利なので紹介
Sphinxドキュメントのリポジトリを指定するとビルドとHTMLサイトのホスティングをしてくれるサービス Read the Docs を試してみました。
公式ドキュメント
お試し
下記2つのリポジトリ試してみました。
リポジトリの内容がビルドされます。bitbucketにpushしたら更新されるように設定ができます。
セットアップ方法の紹介
サインアップしましょう
http://readthedocs.org/ サイトにアクセスします。Sign Upをクリック
Username と メールアドレスとパスワードを入力
メールが届くので、activateします
login すると下記のような画面となります
手動でビルドしてみましょう
bitbucket と ReadTheDocsの連携
bitbucket側の Admin → Services で ReadTheDocs を追加する
連携の確認
bitbucket に push するとトリガがかかりビルド開始されます(結構速い)
更新されました!
dashboardで状況が確認できます
簡単ですね。
感想
- 一度公開されると、それ移行ビルドは早い。リポジトリにpushするとこの例では5秒後には
更新されていました。
- 最初の公開までに2時間程度かかることがありました。しばらく待ってみましょう。すぐ公開されることもあります。
- 検索窓がありますが、検索してもヒットしないです。こんなものでしょうか?