Commit f3a9528b authored by Hanno Schlichting's avatar Hanno Schlichting

Simplified instance skeleton, removing old `Extensions`, `import`,...

Simplified instance skeleton, removing old `Extensions`, `import`, `lib/python` and `Products` from the default. You can continue to manually add these back.
parent b426828b
......@@ -31,6 +31,10 @@ Features Added
Restructuring
+++++++++++++
- Simplified instance skeleton, removing old `Extensions`, `import`,
`lib/python` and `Products` from the default. You can continue to manually
add these back.
- Removed the rarely used support for the `++skin++` traverser. You can enable
it in your own applications by defining::
......
......@@ -311,11 +311,7 @@
required="yes">
<description>
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",
application server. It may also contain "etc", "bin", "log",
and "var" directories depending on how you've configured your Zope
instance.
</description>
......@@ -348,32 +344,26 @@
<multikey name="products" datatype="existing-directory">
<description>
This specifies additional product directories which are added to
Products.__path__. Directories are added in the order in which
they are specified.
This specifies a product directory which is added to Products.__path__.
Directories are added in the order in which they are specified.
</description>
<metadefault>$instancehome/Products</metadefault>
<metadefault></metadefault>
</multikey>
<key name="extensions" datatype="existing-directory">
<description>
This overrides the path to the Extensions directory.
This provides a path to an Extensions directory.
</description>
<metadefault>$instancehome/Extensions</metadefault>
<metadefault></metadefault>
</key>
<multikey name="path" datatype="string">
<description>
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.
</description>
<metadefault>$instancehome/lib/python</metadefault>
the beginning of Python's module search path.
</description>
<metadefault></metadefault>
</multikey>
<key name="pid-filename" datatype="existing-dirpath">
......
Additional products for your Zope instance should be installed in this
directory. A freshly created instance should only contain this
README.txt file and an __init__.py in this directory.
# See http://peak.telecommunity.com/DevCenter/setuptools#namespace-packages
try:
__import__('pkg_resources').declare_namespace(__name__)
except ImportError:
from pkgutil import extend_path
__path__ = extend_path(__path__, __name__)
......@@ -4,6 +4,4 @@ server. It contains the following directories:
bin/ Scripts used to control the Zope instance
etc/ Configuration files
log/ Log files
lib/python/ Installed Python packages specific to the instance
Products/ Installed Zope Products specific to the instance
var/ Run-time data files, including the object database
......@@ -50,61 +50,6 @@ instancehome $INSTANCE
# clienthome /home/chrism/projects/sessions/var
# Directive: path
#
# Description:
# Name of a directory which should be inserted into the
# the beginning of Python's module search path. This directive
# may be specified as many times as needed to insert additional
# directories. 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.
#
# Default: $INSTANCE/lib/python
#
# Example:
#
# path $INSTANCE/mypymodules
# Directive: products
#
# Description:
# Name of a directory that contains additional Product packages. This
# directive may be used as many times as needed to add additional
# collections of products. Each directory identified will be
# added to the __path__ of the Products package. All Products are
# initialized in ascending alphabetical order by product name. If
# two products with the same name exist in two Products directories,
# the order in which the packages appear here defines the load
# order. The master Products directory exists in Zope's software home,
# and cannot be removed from the products path (and should not be added
# to it here).
#
# Default: $INSTANCE/Products
#
# Example:
#
# products /home/chrism/projects/myproducts
# Directive: extensions
#
# Description:
# Name of a directory that contains additional "extensions"
# (implementations of ExternalMethods or catalog brains). This
# directive will be searched before the 'Extensions' directory
# of the 'instancehome'.
#
# Default: unset
#
# Example:
#
# extensions /home/chrism/extensions
# Directive: environment
#
# Description:
......
This directory is used by the running Zope process to import objects
into the ZODB. Please place any files that you wish to be able to
import into this directy. For more information, please see The Zope
Book.
This directory will hold any additional Python packages installed into
this Zope instance. Installing Distutils-based packages should be
done using the command:
<<PYTHON>> setup.py install --home <<INSTANCE_HOME>>
This will cause the newly installed Python packages to appear in this
directory.
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment