zcontact 0.1.0a11

快速开始

按照以下说明安装ZContact并创建默认的服务器设置。

0. 如果尚未安装，请安装依赖项（这些依赖项的大部分来自Zope 3）

   $ sudo apt-get install build-essential python-all python-all-dev
     libc6-dev libicu-dev python-setuptools

1. 安装ZContact

   $ sudo easy_install-2.4 zcontact

2. 创建一个名为“MyZContactServer”的zcontact“实例”（包括服务器配置、日志文件和数据库）。您可以将MyZContactServer替换为您想要的任何名称，或者留空，它将默认为“zcontact”

   $ paster make-config zcontact MyZContactServer

3. 转到您zcontact实例的新创建配置区域并启动服务器

   $ cd MyZContactServer
   $ paster serve deploy.ini

4. ZContact现在可在 http://localhost:8080 上访问。

更新您的ZContact安装

要更新您的ZContact应用程序，只需运行以下命令并重新启动您的服务器。

$ sudo easy_install-2.4 -U zcontact

（-U代表“更新”）。

作为守护进程运行ZContact

要将ZContact作为守护进程运行，请转到您的ZContact实例所在的目录，并输入

$ paster serve deploy.ini –daemon

可以使用以下命令停止正在运行的守护进程：

$ paster serve deploy.ini stop

迁移数据

要从一台zcontact服务器迁移数据到另一台，请按照以下步骤操作

1. 确保两个zcontact实例均未运行。

2. 将您想要迁移的数据库文件复制到新实例。数据库文件位于ZContact实例的var/目录中，名为Data.fs。您不需要移动任何Data.fs.*文件。

3. 重启您的ZContact实例。

开发者安装

如果您想将ZContact作为开发者（即从仓库检出）而不是作为系统上的egg安装，请按照以下步骤操作

1. 从Launchpad获取最新ZContact代码的一个分支

    $ bzr branch http://bazaar.launchpad.net/~pcardune/zcontact/zcontact-lp
   
   (Note: you can also use bzr checkout instead of bzr branch if you
   don't want to get all the revision information)

2. 切换到您刚刚创建分支的目录

   $ cd zcontact-lp

3. 运行make

    $ make
   
   (Note: This will run the bootstrap.py script which sets up buildout,
   and it will invoke buildout which downloads all the necessary eggs
   to the eggs/ directory.  If you have a common place where you have
   development eggs available, you should modify buildout.cfg before
   running make.)

4. 运行测试

   $ make test

5. 创建配置

    $ make install
   
   (This adds the var and log directories along with a deploy.ini,
   site.zcml, and zope.conf in the checkout)

6. 启动服务器

   $ make run

7. 生成测试覆盖率报告

   $ make coverage

注意：如果您遇到setuptools版本不正确的错误，则需要安装easy_install脚本并运行

$ sudo easy_install-2.4 -U setuptools

（-U选项强制setuptools在线查找最新更新）

如果您不喜欢使用make，或者您不在Linux系统上，则可以尝试以下操作

$ python bootstrap.py
$ ./bin/buildout -vN

明智的建议：Zope社区似乎普遍认为，永远不应该使用标准系统Python来运行您的软件，因为这可能会搞砸它。如果可以避免，搞砸系统Python不是一个好主意。因此，为了真正正确地完成这项工作，您应该通过实际下载src、编译它并将它安装到类似/opt/mypython的某个地方来安装自己的Python。然后，在安装检出时使用

$ /opt/mypython/bin/python bootstrap.py
$ ./bin/buildout -vN

这样会更好。

获取更多信息

在chat.freenode.net上联系我。我常用的用户名是pcardune，我在#schooltool和#zope3-dev频道附近。否则，请通过paul_at_carduner_dot_net向我发送电子邮件

请发送您希望放入此README文件中的其他指令请求。

占位符用于更改