/loggerhead/trunk

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/loggerhead/trunk

« back to all changes in this revision

Viewing changes to docs/index.rst

  • Committer: Colin Watson
  • Date: 2022-08-08 16:33:50 UTC
  • mto: This revision was merged to the branch mainline in revision 528.
  • Revision ID: cjwatson@canonical.com-20220808163350-xd8ilh0u5m1kiylb
Port from SimpleTAL to Chameleon.

SimpleTAL is a painful dependency, because it has no download files on
PyPI: the only way to depend on it properly is therefore using a direct
URL reference, and as I understand it packages with such references
those can't be uploaded to PyPI.

Porting to Chameleon (Zope's default TAL implementation nowadays) turns
out not to be too difficult.  The main work involved is because it
doesn't support path expressions.  It would be possible to add those
using `z3c.pt`, and I considered that, but that has a significant
dependency tree for packages that don't already use the Zope Toolkit,
and it would have also required extra startup complexity to register
`ITraversable` adapters.  It's easier to convert path expressions to the
equivalent Python expressions, although the process of doing so was
unfortunately quite error-prone.

Show diffs side-by-side

added added

removed removed

Lines of Context:
13
13
 
14
14
Loggerhead depends on the following Python libraries.:
15
15
 
16
 
- SimpleTAL for templating.
 
16
- Chameleon for templating.
17
17
 
18
18
- Paste for the server. (You need version 1.2 or newer of Paste).
19
19
 
27
27
 
28
28
.. code-block:: sh
29
29
 
30
 
   $ sudo apt-get install python-simpletal
 
30
   $ sudo apt-get install python-chameleon
31
31
   $ sudo apt-get install python-paste
32
32
   $ sudo apt-get install python-pastedeploy
33
33
   $ sudo apt-get install python-flup
37
37
 
38
38
.. code-block:: sh
39
39
 
40
 
   $ easy_install \
41
 
     -f http://www.owlfish.com/software/simpleTAL/py2compatible/download.html \
42
 
     SimpleTAL
 
40
   $ easy_install Chameleon
43
41
   $ easy_install Paste
44
42
   $ easy_install PasteDeploy
45
43
   $ easy_install flup