=====================================
Deliverance 環境構築 buildout 使用編
=====================================

.. warning::
    本ドキュメントはxdvがリリースされる前の2009年9月時点のものであり、
    コードなどは書かれてる通りの手順ではうまく動かないと思います。


このドキュメントは、ほぼ素の状態のPython環境でDeliveranceを使い始めるための手順を記載しています。

なお、Pythonはインストール済みで、実行ファイルへのパスが通っている状態にしておいてください。
この方法はシステムのPython環境は手を加えません。

インストールする
----------------

素のPython環境を想定し、必要なパッケージを導入します。

::

  $ mkdir deliv
  $ cd deliv
  $ wget "http://svn.zope.org/*checkout*/zc.buildout/trunk/bootstrap/bootstrap.py"
  $ python bootstrap.py init


次にdeliveranceのインストール手順をbuildout.cfgに記載します::

  [buildout]
  parts = deliverance
  extensions = gp.vcsdevelop
  vcs-extend-develop = svn+http://codespeak.net/svn/z3/deliverance/trunk/#egg=deliverance
  develop-dir = src
  
  [deliverance]
  recipe = zc.recipe.egg
  eggs =
      lxml==2.2.2
      deliverance
      PasteScript


deliveranceは未リリースの0.3版を使用したいので、Subversionリポジトリパスを指定してインストールすることにします。
また、設定ファイルのテンプレート生成のためにPasteScriptをインストールします。
上記で "lxml==2.2.2" としているのは、この記事を書いた時点では、配布サイトで2.2.3以降はコンパイル済みのeggが登録されていなかったためです。

上記の設定で環境を構築します。

::

  $ bin/buildout


最後にDeliveranceの設定ファイルをテンプレートから生成します。

::

  $ bin/paster create --list-templates
  Available templates:
    basic_package:      A basic setuptools-enabled package
    deliverance:        Basic template for a deliverance-proxy setup
    deliverance_plone:  Plone-specific template for deliverance-proxy
    paste_deploy:       A web application deployed through paste.deploy
  
  $ bin/paster create -t deliverance Deliv1
  Selected and implied templates:
    deliverance#deliverance  Basic template for a deliverance-proxy setup
  
  Variables:
    egg:      Deliv1
    package:  deliv1
    project:  Deliv1
  Enter host (The host/port to serve on) ['localhost:8000']:
  Enter proxy_url (The main site to connect/proxy to) ['http://localhost:8080']: http://twitter.com/
  Enter proxy_rewrite_links (Rewrite links from sub_host?) ['n']: y
  Enter password (The password for the deliverance admin console) ['']: admin
  Enter theme_url (A URL to pull the initial theme from (optional)) ['']:
    :
    :
  Creating .\Deliv1\theme
  Creating .\Deliv1\theme/theme.html
  Creating .\Deliv1\theme\style.css

とりあえずここで何も考えずに Deliverance を起動してみます。

::

  $ bin/deliverance-proxy Deliv1/etc/deliverance.xml
  To see logging, visit http://localhost:8000/.deliverance/login
      after login go to http://localhost:8000/?deliv_log
  serving on http://127.0.0.1:8000


Deliveranceが http://localhost:8000/ で起動しました。
先のテンプレ作成時に proxy_url に http://twitter.com/ を指定していたので、ブラウザで http://localhost:8000/ にアクセスするとtwitterサイトが表示されるはずです。
この状態のままthemeファイルや変換ルールを変更して、ブラウザをリロードすることで少しずつ表示を変えることが出来ます。