查看“Zope配置文件参考”的源代码


原文出处：http://mechanicalcat.net/tech/zope/Zope_schema.html

原文作者：Mechanical Cat

授权许可：[http://www.creativecommons.cn/licenses/by-nc-sa/1.0/ 创作共用协议]

翻译人员：starbear （小宝）

校对人员：无

适用版本：

文章状态：草译

译者的话：此文翻译为本人学习用，能力有限，可能有部分地方翻译不准确，请随意更改

----


----
=== environment * (function cgi_environment) ===
<pre><nowiki>
+ (type str)  
Use any key/value pair, e.g. 'MY_PRODUCT_ENVVAR foo_bar' 
</nowiki></pre>

=== instancehome (function existing_directory)  ===
<pre><nowiki>
The top-level directory which contains the "instance" data for the application server. Typically this is a directory which may contain a "Products" subdirectory (which holds instance-local Zope Products), an "Extensions" subdirectory (which holds instance-local external methods), and an "import" directory (which holds instance-local importable ZODB exports). It may also contain "etc", "bin", "log", and "var" directories depending on how you'ce configured your Zope instance.  
包含有”instance”数据的应用服务程序的顶级目录。通常这个目录会包含一个”Products”子目录（该目录保存本地实例的Zope产品），一个”Extensions”子目录（该目录保存本地实例的外部方法）和一个”import”目录（该目录保存本地实例可导入的ZODB出口）。它也可能会包含”etc”,”bin”,”log”和”var”目录，这取决于你如何配置你的Zope实例。 
</nowiki></pre>

=== clienthome (function existing_directory)  ===
<pre><nowiki>
The directory used to store the default filestorage file used to back the ZODB database, as well as other files used by the Zope applications server during runtime. 
该目录用来保存支持ZODB数据库的默认文件存储文件，同时也有一些Zope服务程序运行时所需要的文件。
</nowiki></pre>

=== products (function existing_directory) (default: '[]')  ===
<pre><nowiki>
This specifies additional product directories which are added to Products.<u>path</u>. Directories are added in the order in which they are specified. 
该选项将指定的附加产品目录添加到Products._path_.Directories的清单中。
</nowiki></pre>

=== path (function existing_directory) (default: '[]')  ===
<pre><nowiki>
This specifies additional paths directories which are inserted into the beginning of Python's module search path. The set of directories specified is inserted into the beginning of the module search path in the order which they are specified here. Note that the processing of this directive may happen too late under some circumstances; it is recommended that you use the PYTHONPATH environment variable if using this directive doesn't work for you. 
该选项指定附加目录路径到Python模块搜索路径的开始的地方。这一系列指定的目录被插入到模块搜索路径清单的开始部分。注意在某些环境下处理该选项会特别慢；如果该选项不能正常工作的话推荐你使用PYTHONPATH环境参数。
</nowiki></pre>

=== pid-filename (function existing_dirpath)  ===
<pre><nowiki>
The full path to which the Zope process will write its OS process id at startup. 
Zope 启动时将OS进程id号写入文件的文件名和路径。
</nowiki></pre>

=== lock-filename (function existing_dirpath)  ===
<pre><nowiki>
The full path to a file which the Zope process will attempt to lock at startup (used to signal to other processes that this Zope instance is currently running). 
Zope启动时进程锁文件的路径（用来通知其它进程当前正在运行Zope实例）
</nowiki></pre>

=== debug-mode (function asBoolean) (default: 'on')  ===
<pre><nowiki>
A switch which controls several aspects of Zope operation useful for developing under Zope. When debug mode is on: - The process will not detach from the controlling terminal - Errors in product initialization will cause startup to fail (instead of writing error messages to the event log file). - Filesystem-based scripts such as skins, PageTemplateFiles, and DTMLFiles can be edited while the server is running and the server will detect these changes in real time. When this switch is off, you must restart the server to see the changes. Setting this to 'off' when Zope is in a production environment is encouraged, as it speeds execution (sometimes dramatically). 
一些Zope操作方面的控制开关，在Zope下开发时非常有用。当debug模式打开时：-进程不会离开控制终端-产品初始化的错误将会导致启动失败（而不是将错误信息写入到事件日志文件中去）。-像skins, PageTemplateFiles和DTMLFiles这些基于系统的脚本在服务运行的时候是可编辑的，并且这些改变能被服务实时监测到。当这个开关关闭，你必须重启服务才能看到改变。在Zope产品环境中这个开关应当关闭，这样它的执行速度会更快（有时会让你吃惊）。
</nowiki></pre>

=== effective-user (type str)  ===
<pre><nowiki>
If you intend to run Zope as the "root" user, you must supply this directive with an effective username or userid number to which Zope will 'suid' after the server ports are bound. This directive only has effect under UNIX and if Zope is started as the root user. 
如果你想用”root”用户运行Zope，你必须提供这个选项，一个有效的用户名或userid号，在服务端口被绑定后Zope将会以’suid’来运行（Zope will 'suid' after the server ports are bound）。这个选项仅仅在UNIX下用root用户运行Zope时有效。
</nowiki></pre>

=== enable-product-installation (function asBoolean) (default: 'on')  ===
<pre><nowiki>
If this directive is turned on, Zope performs 'product installation' (the registration of Python modules in various Products directories) at startup. Turning this off can speed Zope startup time, but it can also cause your Control_Panel Product list to become desynchronized with the contents of your Products directories. If the 'zeo_client_name' directive is set, and this directive is unset, this directive will be implicitly turned off. 
如果这个选项是打开的，Zope会在启动的时候执行’product installation’（注册Python模块到不同的产品目录）。关闭这个选项Zope的启动速度会加快，但是会导致你的Control_Panel的产品列表与你的产品目录中的内容不同步。如果’zeo_client_name’选项设置了，这个选项未被设置，这个选项就会被默认关闭。
</nowiki></pre>

=== locale (instance ZConfig.datatypes.MemoizedConversion)  ===
<pre><nowiki>
Enable locale (internationalization) support by supplying a locale name to be used. See your operating system documentation for locale information specific to your system. If your Python module does not support the locale module, or if the requested locale is not supported by your system, an error will be raised and Zope will not start. 
一个locale名字被使用时locale（国际化）支持就会被激活。查看你的操作系统文档中你的系统指定的locale信息。如果你的Python模块不支持locale模块，或者要求的locale不被你的系统支持，Zope启动的时候将会出现错误。
</nowiki></pre>

=== datetime-format (function datetime_format) (default: 'us')  ===
<pre><nowiki>
Set this variable either to "us" or "international" to force the DateTime module to parse date strings either with month-before-days-before-year ("us") or days-before-month-before-year ("international"). The default behaviour of DateTime (when this setting is left unset) is to parse dates as US dates. 
设置这个参数为"us" 或 "international"强制Date-Time模块使用month-before-days-before-year ("us") 或 days-before-month-before-year ("国际")格式。默认的时间格式（当没有设置这个选项时）为US日期格式。
</nowiki></pre>

=== zserver-threads (function integer) (default: '4')  ===
<pre><nowiki>
Specify the number of threads that Zope's ZServer web server will use to service requests. The default is 4. 
指定Zope的Zserver web服务器用来服务请求的线程数。默认为4。
</nowiki></pre>

=== python-check-interval (function integer) (default: '500')  ===
<pre><nowiki>
Value passed to Python's sys.setcheckinterval() function. The higher this is, the less frequently the Python interpreter checks for keyboard interrupts. Setting this to higher values also reduces the frequency of potential thread switches, which can improve the performance of a busy server. 
传给Python sys.setcheckinterval（）函数的值。这个值越高，Python解释程序越少检查键盘的中断。设高这个值同样减少线程转换的频率，这样能提高繁忙服务器的性能。
</nowiki></pre>

=== zserver-read-only-mode (function asBoolean) (default: 'off')  === 
<pre><nowiki>
If this variable is set, then the database is opened in read only mode. If this variable is set to a string parsable by DateTime.DateTime, then the database is opened read-only as of the time given. Note that changes made by another process after the database has been opened are not visible. 
如果这个参数设置了，那么数据库会以只读模式打开。如果这个参数被设置为DateTime.DateTime字符，那么数据库在给定的时间里是以只读模式打开的。注意数据库被打开后其他进程做的修改将是不可见的。
</nowiki></pre>

=== structured-text-header-level (function integer) (default: '3') ===
<pre><nowiki>
Set the default starting HTML header level for structured text documents. The default is 3, which implies that top-level headers will be created with an H3 HTML tag.
设置结构化文本文档HTML标题级别。默认为3，这就意味着最高级别的标题会被打上H3 HTML标签。
</nowiki></pre>

=== rest-input-encoding (type str) ===
<pre><nowiki>
Specifies the input encoding of re-StructuredText documents (e.g. 'utf-8', 'iso-8859' or any other valid encoding recognized by Python). The default is your Python's default encoding. 
指定输入re-StructuredText文档的编码（例如：'utf-8', 'iso-8859'或者其他的能被Python识别的的编码）默认的配置是你的Python默认编码。
</nowiki></pre>

=== rest-output-encoding (type str) ===
<pre><nowiki>
Specifies the output encoding of re-StructuredText documents (e.g. 'utf-8', 'iso-8859' or any other valid encoding recognized by Python). The default is your Python's default encoding. 
指定re-StructuredText文档的输出编码（比如'utf-8', 'iso-8859'或者其他Python能识别的有效编码）。默认的编码是你的Python的默认编码。
</nowiki></pre>

=== maximum-security-manager-stack-size (function integer) (default: '100') ===
<pre><nowiki>
This variable allows you to customize the size of the Zope SecurityManager stack. You shouldn't change this unless you know what it means. 
这个变量允许你定制Zope安全管理器队列（SecurityManager stack）。在你明白它的意思之前你不要去改变它。
</nowiki></pre>

=== publisher-profile-file (type str) ===
<pre><nowiki>
Causing this directive to point to a file on the filesystem will cause Zope's profiling capabilities to be enabled. For more information, see the Debug/Profiling tab of Zope's Control_Panel. 
把这个选项指向文件系统的一个文件将会把Zope的性能配置（profiling）激活。查看Zope控制面版的Debug/Profiling标签获取更多的信息。
</nowiki></pre>

=== cgi_environment * (function cgi_environment) ===
<pre><nowiki>
+ (type str) 
Use any key/value pair, e.g. 'HTTPS_PORT 443' 
</nowiki></pre>

=== dns-server (function dns_resolver) ===
<pre><nowiki>
Specify the ip address of your DNS server in order to cause resolved hostnames to be written to Zope's access log. By default, Zope will not resolve hostnames unless this is set. 
指定你的DNS服务器的IP地址，这样可以解析出主机名然后写到Zope的访问日志中去。默认的情况下Zope不会解析主机名。
</nowiki></pre>

=== ip-address (instance ZConfig.datatypes.IpaddrOrHostname) ===
<pre><nowiki>
The default IP address on which Zope's various server protocol implementations will listen for requests. If this is unset, Zope will listen on all IP addresses supported by the machine. 
Zope不同服务协议的执行都要求在这个默认的IP地址上监听。如果没有设置这个选项，Zope会在机器提供的所有的IP地址上监听。
</nowiki></pre>

=== http-realm (type str) (default: 'Zope') ===
<pre><nowiki>
The HTTP "Realm" header value sent by this Zope instance. This value often shows up in basic authentication dialogs. 
Zope实例传出的HTTP “Realm”头。这个值经常在基本验证对话框里出现。
</nowiki></pre>

=== automatically-quote-dtml-request-data (function asBoolean) (default: 'on') ===
<pre><nowiki>
Set this directive to 'off' in order to disable the autoquoting of implicitly retrieved REQUEST data by DTML code which contains a '<' when used in construction. When this directive is 'on', all data implicitly retrieved from the REQUEST in DTML (as opposed to addressing REQUEST.somevarname directly) that contains a '<' will be HTML-quoted when interpolated via a or &dtml-; construct. This mitigates the possibility that DTML programmers will leave their sites open to a "client-side trojan" attack. 
将这个选项置于’off’将不能自动引用通过DTML代码取回的包含’<’语法结构的REQUEST数据。当这个选项置于’on’，所有从DTML的REQUEST取回的数据里包含的’<’将会被a或者&dtml-;置换后被HTML引用。这样会减少DTML程序员开放站点而导致被"client-side trojan"攻击的可能性。
</nowiki></pre>

=== trusted-proxy (instance ZConfig.datatypes.IpaddrOrHostname) (default: '[]') ===
<pre><nowiki>
Define one or more 'trusted-proxies' keys, each of which is a hostname or an IP address. The set of definitions comprises a list of front-end proxies that are trusted to supply an accurate X_FORWARDED_FOR header to Zope (security-related). 
定义一条或者多条'trusted-proxies'条目，其中的每一条都是一个主机名或者一个IP地址。这一系列的定义是由一个受信任的前端代理列表所组成，这些定义能向Zope提供精确的X_FORWARDED_FOR头（安全关系（secruity-related））。
</nowiki></pre>

=== security-policy-implementation (function security_policy_implementation) (default: 'C') ===
<pre><nowiki>
The default Zope "security policy" implementation is written in C. Set this key to "PYTHON" to use the Python implementation (useful for debugging purposes); set it to "C" to use the C implementation. 
默认的Zope”安全策略”（ "security policy"）是由C来实现的。这个条目设置为“PYTHON“就是由Python来实现（用调试）；设置为“C”使用C来实现。
</nowiki></pre>

=== skip-authentication-checking (function asBoolean) (default: 'off') ===
<pre><nowiki>
Set this directive to 'on' to cause Zope to prevent Zope from attempting to authenticate users during normal operation. Potentially dangerous from a security perspective. Only works if security-policy-implementation is set to 'C'.
将这个选项设置成”on”使Zope在进行普通操作时避免做用户验证。这从安全的角度看是危险的。只有在security-policy-implementation设置成”C”时才用。
</nowiki></pre>

=== skip-ownership-checking (function asBoolean) (default: 'off') ===
<pre><nowiki>
Set this directive to 'on' to cause Zope to ignore ownership checking when attempting to execute "through the web" code. By default, this directive is off in order to prevent 'trojan horse' security problems whereby a user with less privilege can cause a user with more privilege to execute code which the less privileged user has written. 
将这个选项设置成’on’会使Zope在执行”though the web”代码时忽略所有权检查。这个选项默认情况下是关闭的，为了防止特洛伊木马（'trojan horse'）安全问题而导致的高权限的用户能执行由低权限用户写的代码。
</nowiki></pre>

=== maximum-number-of-session-objects (function integer) (default: '1000') ===
<pre><nowiki>
An integer value representing the number of items to use as a "maximum number of subobjects" value of the '/temp_folder/session_data' transient object container within Zope's object database. 
一个整数值，表示一个Zope对象数据库的'/temp_folder/session_data'这个临时对象容器的”最大子对象数”。
</nowiki></pre>

=== session-add-notify-script-path (type str) ===
<pre><nowiki>
An optional full Zope path name of a callable object to be set as the "script to call on object addition" of the session_data transient object container created in the '/temp_folder' folder at startup. 
一个可选的可调用对象的Zope全路径名，该项可作为临时会话数据对象容器的”对象添加时被调用的脚本”（"script to call on object addition"），该容器启动时在'/temp_folder'文件夹中创建。
</nowiki></pre>

=== session-delete-notify-script-path (type str) ===
<pre><nowiki>
An optional full Zope path name of a callable object to be set as the "script to call on object deletion" of the sessioN_data transient object container created in the /temp_folder folder at startup. 
一个可选的可调用对象的Zope全路径名，该项可作为临时会话数据对象容器的”对象删除时被调用的脚本”， 该容器启动时在'/temp_folder'文件夹中创建。
</nowiki></pre>

=== session-timeout-minutes (function integer) (default: '20') ===
<pre><nowiki>
An integer value representing the number of minutes to be used as the "data object timeout" of the '/temp_folder/session_data' transient object container in Zope's object database. 
一个整数值，该整数值表示Zope对象数据库中'/temp_folder/session_data'临时对象容器的”数据对象超时”的时间（译者注：单位为分钟）。
</nowiki></pre>

=== suppress-all-access-rules (function asBoolean) (default: 'off') ===
<pre><nowiki>
If this directive is set to on, no access rules in your Zope site will be executed. This is useful if you "lock yourself out" of a particular part of your site by setting an improper access rule. 
如果这个选项被打开，你的Zope站点的访问规则将不会被执行。当你的站点里的一个特定的访问规则设置不恰当使你不能访问时这个选项就很有用了。
</nowiki></pre>
=== suppress-all-site-roots (function asBoolean) (default: 'off') ===
<pre><nowiki>
If this directive is set to on, no site roots in your Zope site will be effective. This is useful if you "lock yourself out" of a particular part of your site by setting an improper site root. 
当这个选项打开时，你的Zope站点里将没有一个根站点（site roots）是可用的。当你的站点里一个特定的根站点设置不恰当而使你不能访问时这个选项就很有用了。
</nowiki></pre>

=== database-quota-size (instance ZConfig.datatypes.SuffixMultiplier) ===
<pre><nowiki>
Set this directive to an integer in bytes in order to place a hard limit on the size which the default FileStorage-backed Zope database can grow. Additions to the database will not be permitted once this filesize is exceeded. 
将这个选项的参数设置一个以字节为单位的整数，这样能限制Zope数据库默认的后台存储文件增长得过大。当文件大小超过限制时将不允许再往数据库里添加数据。
</nowiki></pre>

=== read-only-database (function asBoolean) ===
<pre><nowiki>
If this directive is set to "on", the main Zope FileStorage-backed ZODB database will be opened in read-only mode. 
如果这个选项设置成”on”,Zope的后台主存储文件ZODB数据库将会以只读方式打开。
</nowiki></pre>

=== zeo-client-name (type str) ===
<pre><nowiki>
Provide a string value to uniquely identify the local cache files created if this Zope is a ZEO client. Setting this directive implies setting 'enable-product-installation' to 'off' if 'enable-product-installation' is left unset. 
当Zope为ZEO客户端的时候将会为本地缓存文件提供一个唯一标识字符串值。设置这个选项时如果'enable-product-installation'未被设置，则必须将'enable-product-installation'设置成’off’。
</nowiki></pre>

=== eventlog * (classobj EventLogFactory) ===
<pre><nowiki>
level (function logging_level) (default: 'info') 
zlog.loghandler * 
email-notifier (classobj SMTPHandlerFactory) 
dateformat (type str) (default: '%Y-%m-%dT%H:%M:%S') 
level (function logging_level) (default: 'notset') 
from (type str) 
to (type str) (default: '[]') 
subject (type str) (default: 'Message from Zope') 
smtp-server (function inet_address) (default: 'localhost') 
format (function log_format) (default: '%(asctime)s %(message)s') 
http-logger (classobj HTTPHandlerFactory) 
dateformat (type str) (default: '%Y-%m-%dT%H:%M:%S') 
level (function logging_level) (default: 'notset') 
url (function http_handler_url) (default: 'http://localhost/') 
method (function get_or_post) (default: 'GET') 
format (function log_format) (default: '%(asctime)s %(message)s') 
logfile (classobj FileHandlerFactory) 
dateformat (type str) (default: '%Y-%m-%dT%H:%M:%S') 
level (function logging_level) (default: 'notset') 
path (type str) 
format (function log_format) (default: '------\\n%(asctime)s %(message)s') 
syslog (classobj SyslogHandlerFactory) 
dateformat (type str) (default: '%Y-%m-%dT%H:%M:%S') 
level (function logging_level) (default: 'notset') 
facility (function syslog_facility) (default: 'user') 
address (classobj SocketAddress) (default: 'localhost:514') 
format (function log_format) (default: '%(message)s') 
win32-eventlog (classobj Win32EventLogFactory) 
dateformat (type str) (default: '%Y-%m-%dT%H:%M:%S') 
level (function logging_level) (default: 'notset') 
appname (type str) (default: 'Zope') 
format (function log_format) (default: '%(message)s') 
</nowiki></pre>

=== access access (classobj LoggerFactory) ===
<pre><nowiki>
level (function logging_level) (default: 'info') 
zlog.loghandler * 
</nowiki></pre>

=== trace trace (classobj LoggerFactory) ===
<pre><nowiki>
level (function logging_level) (default: 'info') 
zlog.loghandler * 
</nowiki></pre>

=== max-listen-sockets (function integer) (default: '1000') ===
<pre><nowiki>
The maximum number of sockets that ZServer will attempt to open in order to service incoming connections. 
Zserver打开的最大套接字连接的数目。
</nowiki></pre>

=== zserver.server *  ===
<pre><nowiki>
The "server" type is used to describe a single type of server instance. The value for a server section is an object with the ServerFactory interface. 
该服务器类型是用来描述一个服务器实例的单个类型。该值是服务器工厂接口（ServerFactory interface）服务器部分的一个对象。
fast-cgi (classobj FCGIServerFactory) 
address (classobj SocketAddress) 
ftp-server (classobj FTPServerFactory) 
address (function inet_address) 
http-server (classobj HTTPServerFactory) 
address (function inet_address) 
force-connection-close (function asBoolean) (default: 'off') 
webdav-source-clients (type str) 
Regular expression used to identify clients who should receive WebDAV source responses to GET requests. 
用来标识发出GET请求而收到WebDAV源响应的客户端的正则表达式。

icp-server (classobj ICPServerFactory) 
address (function inet_address) 
monitor-server (classobj MonitorServerFactory) 
address (function inet_address) 
persistent-cgi (classobj PCGIServerFactory) 
path (function existing_file) 
webdav-source-server (classobj WebDAVSourceServerFactory) 
address (function inet_address) 
force-connection-close (function asBoolean) (default: 'off') 
</nowiki></pre>

=== port-base (function integer) (default: '0') ===
<pre><nowiki>
Base port number that gets added to the specific port numbers specified for the individual servers. 
		基本端口号，该端口号添加到为特殊服务指定的特殊端口号中。
</nowiki></pre>

=== zodb.database +  ===
<pre><nowiki>
Zope ZODB databases must have a name, and they are required to be referenced via the "zodb_db" database type because it is the only kind of database definition that implements the required mount-point argument. There is another database sectiontype named "zodb", but it cannot be used in the context of a proper Zope configuration (due to lack of a mount-point). 
Zope的ZODB数据库必需要有一个名字，而且它们是通过”zodb_db”数据库类型被引用的，因为只有这种数据库定义执行时要求挂载点参数。还有一种叫做”zodb”数据库部件，但它不能在正规的Zope配置文档里使用（因为缺少挂载点）。
zodb (classobj ZODBDatabase) 
zodb.storage * 
demostorage (classobj DemoStorage) 
name (type str) (default: 'Demo Storage') 
zodb.storage * 
quota (function integer) 
filestorage (classobj FileStorage) 

path (type str) 
Path name to the main storage file. The names for supplemental files, including index and lock files, will be computed from this. 
主存储文件的路径名。追加的文件名称，其中包括索引和锁文件，都是从这里计算的获得的。

create (function asBoolean) (default: 'false') 
Flag that indicates whether the storage should be truncated if it already exists. 
标记如果存储文件存在的话是否需要压缩。

read-only (function asBoolean) (default: 'false') 
If true, only reads may be executed against the storage. Note that the "pack" operation is not considered a write operation and is still allowed on a read-only filestorage.
如果为真，只有读操作可以进行。注意，”pack”操作是不作为写操作的，故也可以在只读存储文件里操作。

quota (instance ZConfig.datatypes.SuffixMultiplier) 
Maximum allowed size of the storage file. Operations which would cause the size of the storage to exceed the quota will result in a ZODB.FileStorage.FileStorageQuotaError being raised. 
存储文件所允许的最大容量。所有会导致存储超过限制的操作都会得到一个ZODB.FileStorage.FileStorageQuotaError的提示。

fullstorage (classobj BDBFullStorage) 
name (type str) 
interval (instance ZConfig.datatypes.SuffixMultiplier) (default: '2m') 
kbyte (function integer) (default: '0') 
min (function integer) (default: '0') 
logdir (type str) 
cachesize (instance ZConfig.datatypes.SuffixMultiplier) (default: '128MB') 
frequency (instance ZConfig.datatypes.SuffixMultiplier) (default: '0') 
packtime (instance ZConfig.datatypes.SuffixMultiplier) (default: '4h') 
classicpack (function integer) (default: '0') 
read-only (function asBoolean) (default: 'off') 
mappingstorage (classobj MappingStorage) 
name (type str) (default: 'Mapping Storage') 
minimalstorage (classobj BDBMinimalStorage) 
name (type str) 
interval (instance ZConfig.datatypes.SuffixMultiplier) (default: '2m') 
kbyte (function integer) (default: '0') 
min (function integer) (default: '0') 
logdir (type str) 
cachesize (instance ZConfig.datatypes.SuffixMultiplier) (default: '128MB') 
frequency (instance ZConfig.datatypes.SuffixMultiplier) (default: '0') 
packtime (instance ZConfig.datatypes.SuffixMultiplier) (default: '4h') 
classicpack (function integer) (default: '0') 
read-only (function asBoolean) (default: 'off') 

temporarystorage (classobj TemporaryStorage) 
A nonundoing storage which keeps data in RAM and which does not need to be packed unless cyclic references are kept.
一个不可恢复（nonundoing）的存储系统，它的数据保存在RAM中，并且在没有出现循环提示的情况下没必要去删除。
name (type str) (default: 'Temporary Storage') 
zeoclient (classobj ZEOClient) 
server (classobj SocketAddress) (default: '[]') 

storage (type str) (default: '1') 
The name of the storage that the client wants to use. If the ZEO server serves more than one storage, the client selects the storage it wants to use by name. The default name is '1', which is also the default name for the ZEO server. 
客户端需要使用的存储系统名称。如果ZEO服务器同时提供多个存储系统，客户端就会用名称来选取存储系统。默认名称是‘1’，同时也是ZEO服务器的默认名称。

cache-size (function integer) (default: '20000000') 
The maximum size of the client cache, in bytes. 
客户端的缓存最大数，单位是字节。

name (type str) (default: '') 
The storage name. If unspecified, the address of the server will be used as the name. 
存储系统名称。如果没有指定，服务器地址就会被当作名称来使用。

client (type str) 
Enables persistent cache files. The string passed here is used to construct the cache filenames. If it is not specified, the client creates a temporary cache that will only be used by the current object. 
激活永久缓存文件。这里的这个字符串用来创建缓存文件名。如果没有指定，客户端创建的临时缓存只能被当前的对象使用。

var (type str) 
The directory where persistent cache files are stored. By default cache files, if they are persistent, are stored in the current directory.
永久缓存文件的存储目录。假如默认缓存文件是永久的，就会保存在当前的目录下。

min-disconnect-poll (function integer) (default: '5') 
The minimum delay in seconds between attempts to connect to the server, in seconds. Defaults to 5 seconds.
两次尝试连接服务器之间的最小延迟秒数。默认是5秒。

max-disconnect-poll (function integer) (default: '300') 
The maximum delay in seconds between attempts to connect to the server, in seconds. Defaults to 300 seconds.
两次尝试连接服务器之间的最大延迟秒数。默认是300秒。

wait (function asBoolean) (default: 'on') 
A boolean indicating whether the constructor should wait for the client to connect to the server and verify the cache before returning. The default is true. 
一个布尔类型，该类型指出是否构造程序需要等待客户端连接到服务器并且在返回前检查缓存。默认是true。

read-only (function asBoolean) (default: 'off') 
A flag indicating whether this should be a read-only storage, defaulting to false (i.e. writing is allowed by default).
一个标记指出存储系统是否为只读，默认为false（例：默认情况下写是被允许的）

read-only-fallback (function asBoolean) (default: 'off') 
A flag indicating whether a read-only remote storage should be acceptable as a fallback when no writable storages are available. Defaults to false. At most one of read_only and read_only_fallback should be true. 
一个标记指出当没有一个有效的可写存储系统时是否接受低效率的远程只读存储系统。默认是false。只读和低效只读最多只能有一个是true。

realm (type str) 
The authentication realm of the server. Some authentication schemes use a realm to identify the logic set of usernames that are accepted by this server. 
服务器的验证域（realm）。有些验证方案用域(realm)来识别被服务接受的逻辑用户名集合。
cache-size (function integer) (default: '5000') 
pool-size (function integer) (default: '7') 
version-pool-size (function integer) (default: '3') 
version-cache-size (function integer) (default: '100') 

zodb_db (classobj ZopeDatabase) 
We need to specialize the database configuration section for Zope only by including a (required) mount-point argument, which is a string. A Zope ZODB database can have multiple mount points, so this is a multikey. 
我们应该把数据库的这部分配置专用于需要挂载点草书的Zope站点，这部分配置是一个字符串。一个Zope的ZODB数据库可以有多个挂载点，所以这部分配置应该是多条的。
zodb.storage * 
cache-size (function integer) (default: '5000') 
pool-size (function integer) (default: '7') 
version-pool-size (function integer) (default: '3') 
version-cache-size (function integer) (default: '100') 

mount-point (function mount_point) (default: '[]') 
The mount point is the slash-separated path to which this database will be mounted within the Zope application server.
挂载点是一个由斜线分隔的路径，Zope应用服务器里的数据库就挂载在这个路径下。

connection-class (function importable_name) 
Change the connection class a database uses on a per-database basis to support different connection policies. Use a Python dotted-path name to specify the connection class. 
更改数据库使用的每数据库底层连接类使之能支持不同的连接策略。使用Python的点路径名来指定连接类。

class-factory (function importable_name) (default: 'DBTab.ClassFactories.autoClassFactory') 
Change the class factory function a database uses on a per-database basis to support different class factory policy. Use a Python dotted-path name to specify the class factory function. 
更改数据库使用的每数据库底层的类工厂函数使之支持不同的类工厂策略。使用Python的点路径名指定类工厂函数。

container-class (function python_dotted_path) 
Change the contiainer class a (mounted) database uses on a per-database basis to support a different container than a plain Folder. Use a Python dotted-path name to specify the container class. 
更改（已挂载）数据库使用的每数据库底层的容器类使之能支持除文件夹外其他的容器。使用Python的点路径名指定容器类。
</nowiki></pre>

=== runner * (function null_conversion) ===
<pre><nowiki>
program (type str) (default: '[]') 
The program(s) that will be run by the runner
使用者将要运行的程序

daemon (function asBoolean) (default: 'true') 
Command-line option: -d or --daemon. If this option is true, zdrun.py runs in the background as a true daemon. It forks an child process which becomes the subprocess manager, while the parent exits (making the shell that started it believe it is done). The child process also does the following: - if the directory option is set, change into that directory - redirect stdin, stdout and stderr to /dev/null - call setsid() so it becomes a session leader - call umask(022) 
命令行选项： -d 或 –daemon。如果这个选项为true，zdrun.py将以一个真实的进程在后台运行。当父进程存在时（用shell启动它，确认启动完成），父进程会派生出一个作为子进程管理器的孩子进程。孩子进程同时还做以下的事情：-如果目录选项设置了，就转到设置的目录里去 –重定向标准输入、输出和错误到/dev/null –调用setsid（）使自己成为主会话 –调用umask（022）

backoff-limit (function integer) (default: '10') 
Command-line option: -b or --backoff-limit. When the subprocess crashes, zdrun.py inserts a one-second delay before it restarts it. When the subprocess crashes again right away, the delay is incremented by one second, and so on. What happens when the delay has reached the value of backoff-limit (in seconds), depends on the value of the forever option. If forever is false, zdrun.py gives up at this point, and exits. An always-crashing subprocess will have been restarted exactly backoff-limit times in this case. If forever is true, zdrun.py continues to attempt to restart the process, keeping the delay at backoff-limit seconds. If the subprocess stays up for more than backoff-limit seconds, the delay is reset to 1 second. 
命令行选项：-b 或 –backoff-limit。当子进程崩溃了，zdrun.py在子进程重启前插入一秒钟的延时。当子进程马上又崩溃了，这个延时会增加一秒，接下去也如此。当延时秒数到达backoff-limit值时会发生什么呢，这主要取决于forever选项值。如果forever是false，zdrun.py这时会停止并退出。这时一个经常并亏的子进程已经被重启了backoff-limit次。如果forever是true，zdrun.py继续尝试重启这个进程，保持延时时间问backoff-limit秒。如果子进程存活的时间超过backoff-limit秒，延时的时间会被重置到1秒。

forever (function asBoolean) (default: 'false') 
Command-line option: -f or --forever. If this option is true, zdrun.py will keep restarting a crashing subprocess forever. If it is false, it will give up after backoff-limit crashes in a row. See the description of backoff-limit for details. 
命令行选项： -f 或 –forever。如果这个选项为true，zdrun.py将会一直重启一个崩溃的子进程。如果是false，它将会在子进程崩溃backoff-limit次后停止。查看backoff-limit的描述了解详情。

hang-around (function asBoolean) (default: 'false') 
If this option is true, the zdrun.py process will remain even when the daemon subprocess is stopped. In this case, zopectl will restart zdrun.py as necessary. If this option is false, zdrun.py will exit when the daemon subprocess is stopped (unless zdrun.py intends to restart it). 
如果这个选项为true，当daemon子进程停止的时候zdrun.py进程还是会保持着。这时，zopectl将会重启zdrun.py。如果这个选项是false，当daemon子进程停止时zdrun.py会退出（除非zdrun.py打算重启）。

default-to-interactive (function asBoolean) (default: 'true') 
If this option is true, zopectl enters interactive mode when it is invoked without a positional command argument. If it is false, you must use the -i or --interactive command line option to zopectl to enter interactive mode.
如果这个选项为true，当不带参数调用zopect时就会进入交互模式。如果是false，你必须使用-I 或 –interactive命令行选项使zopectl进入交互模式。

prompt (type str) (default: 'zopectl>') 
The prompt shown by zopectl program. 
		这个提示在zopectl程序里显示
</nowiki></pre>