Grok source renderers
Project description
Grok source renderers
First take on making the zope.app.render classes available from Grok templates.
RestructuredText: template files with ‘.rst’ extension
renders a complete HTML page, including embedded stylesheet (default) or with a configurable external stylesheet
Installation
Add ‘megrok.rendersource’ to the ‘install_requires’ list in your packages ‘setup.py’. Run buildout again. Template reloading is available in developer mode only: add ‘devmode on’ to the ‘zope.conf = ‘ line in your buildout.cfg
Configuration
To configure the stylesheet used with your template, add a method ‘namespace’ to your view class:
class Overview(grok.View):
def namespace(self):
# compute the stylesheet path to the file inside the 'static' folder,
# eg. 'grok.css'
stylesheet=self.static['grok.css']()
# enable absolut URL handling, disable embedding
return {'settings_overrides': {'stylesheet': stylesheet,
'stylesheet_path': None,
'embed_stylesheet': 0,
'input_encoding': 'utf-8',
'output_encoding': 'utf-8',
}}
Other docutils related options can be added to the ‘settings_overrides’ dictionary. CF grok_overview.txt for more info on the namespace method.
Changes
0.5.1 (2010-03-10)
added the long description…
0.5 (2010-03-10)
upgrade to grok version 1.1rc1
changed the project namespace from d2m.rendersource to megrok.rendersource
