.. Webhooks
   ========

Web フック
==========

.. Web hooks are pretty amazing, and help to turn the web into a push instead of
   pull platform. We have support for hitting a URL whenever you commit to your
   project and we will try and rebuild your docs. This only rebuilds them if
   something has changed, so it is cheap on the server side. 

Web フックはとても素晴しい仕組みで、Web という環境を、引っ張ってくる(プルする)ものではなく、通知する(プッシュする)ものに変えてくれます。
RTD ではプロジェクトにコミットした際の通知先となる URL を用意しており、この URL への通知によって、ドキュメントの取得とリビルドを行ないます。
ドキュメントに何か変更があった場合のみリビルドするため、サーバサイドにとっては負荷の低い仕組みになっています。

.. As anyone who has worked with push knows, pushing a doc update to your repo and
   watching it get updated within seconds is an awesome feeling. If you're on
   github, simply put ``http://readthedocs.org/github`` as a post-commit hook on
   your project. Otherwise your project detail page has your post-commit hook on
   it. It will look something along the lines of
   ``http://readthedocs.org/build/<pk>``

プッシュ通知を利用している人ならご存知の通り、リポジトリへプッシュすると、すぐにドキュメントが更新される様は驚くばかりです。
もし github を利用しているのなら、自分のプロジェクトのポストコミットフックとして ``http://readthedocs.org/github`` を指定するだけです。
github 以外の場合は、プロジェクト詳細ページに ``http://readthedocs.org/build/<pk>`` のような、
プロジェクト専用の post-commit フック URL が掲載されているので、そちらを利用することができます。