Read the Tests

For the python code on the File system level there is a test directory containing a test_Foo.py for each Foo.py (at least it should be ;).

If You do not know how the code shoud be used, maybe You can take a look at the tests. They read a little boring (as tests do mostly) but they maybe explain how the methods should be called, and what is the expected result.

Afterwards You maybe find it easier to understand, how the Zope level page templates and scripts work, or at least what this or that class is good for.

P.S.: Not completely unimportant: You can run the tests by setting up the environment variables INSTANCE_HOME to Your Zope instance product directory and SOFTWARE_HOME to the lib/python directory inside of the Zope binaries.

Then just type:

   python ./tests/runalltests.py
 

in the directory of the Silva product.

For versions of Silva prior to 0.9.3 You can call from Your ZOPEHOME:

   PYTHONPATH=./lib/python:./lib/python2.1 python ./lib/python/Products/Silva/tests/test_all.py
 

(assuming that You do not have an "INSTANCE_HOME" setup, i.e. with separate Zope binaries and data - I hope You can figure out Yourself how to handle that case.)