Migrate Kid to Genshi ===================== If you use bots edi type template then you are using kid for those templates. From version 2.1.0 onwards, using Genshi is also supported, using edi type ``template-html``. In a future bots version, kid will be removed as it is no longer being developed. You may have copied templates from a plugin, or developed your own. Each template normally consists of three files: * ``usersys/grammars/template/.py`` is the grammar configured in the translation and defines the actual template files used. * ``usersys/grammars/template/templates/.kid`` is the template containing html code for the main body of the message. * ``usersys/grammars/template/templates/_envelope.kid`` is the envelope template containing header and footer html code. .. note:: Your naming standard for the .kid files may differ from the above example To convert this to a Genshi template, at least the following steps are required. There may be additional changes depending on your template complexity. For more info see `Comparing Genshi to Kid `_. #. Of course, the `Genshi `_ library must be installed for this to work. #. Copy the three source files from ``usersys/template`` to ``usersys/templatehtml``. The compiled .pyc files are not copied. Keep the same ``/templates`` sub-directory structure for the templates. #. Also copy the ``__init.py__`` files when first creating this new directory structure. #. Rename the two copied .kid files to .html (ie. just change the file extension) #. Edit the ``.py`` file and change it's ``template`` and ``envelope-template`` settings that refer to the .kid files to .html files. .. code-block:: python syntax = { 'charset':'utf-8', 'contenttype':'text/html', 'merge':False, 'template':'.html', 'envelope-template':'_envelope.html'} #. Edit the two .html template files and make the following changes: * Namespaces should be changed .. code-block:: html .. code-block:: html * xi:include should be used instead of py:replace in the envelope template .. code-block:: html

.. code-block:: html

#. Change your translation: change template to template-html. #. Last, but not least: test this ;-)