~launchpad-pqm/launchpad/devel

7849.16.65 by Sidnei da Silva
- Move documentation from TODO into chameleon.txt
1
Running Launchpad with Chameleon Template Engine
2
================================================
3
4
- Need to pull the following dependencies into ``sourcecode``::
5
6
  - lp:sourcecodegen/trunk
7
  - lp:chameleon.core/trunk
8
  - lp:chameleon.zpt/trunk
9
  - lp:z3c.pt/trunk
10
  - lp:z3c.ptcompat/trunk
11
12
- Run launchpad with ``PREFER_Z3C_PT=true make run`` to enable
13
  ``z3c.pt``. Omitting it or setting to ``false`` will disable
14
  ``z3c.pt`` and use ``zope.pagetemplate`` instead. Yes, it's that
15
  simple. This is possible thanks to ``z3c.ptcompat``.
16
17
- Other useful environment options for ``z3c.pt``::
18
19
  # in debug-mode, templates on disk are reloaded if they're modified
20
  CHAMELEON_DEBUG (default: false)
21
22
  # disable disk-cache to prevent the compiler from caching on disk
23
  CHAMELEON_CACHE (default: true)
24
25
  # if eager parsing is enabled, templates are parsed upon
26
  # instantiation, rather than when first called upon; this mode is
27
  # useful for verifying validity of templates across a project
28
  CHAMELEON_EAGER (default: false)
29
30
  # in strict mode, filled macro slots must exist in the macro that's
31
  # being used.
32
  CHAMELEON_STRICT (default: false)
33
34
  # when validation is enabled, dynamically inserted content is
35
  # validated against the XHTML standard
36
  CHAMELEON_VALIDATE (default: false)