Some days ago there was a question at the Plone IRC-channel, whether the Plonetheming tool supports template inheritance [sic]. The answer is no, but let's play a bit with the problem.
The prefered theming solution for Plone, plone.app.theming, is based on Diazo theming engine, which allows to make a Plone theme from any static HTML mockup. To simplify a bit, just get a static HTML design, write a set of Diazo transformation rules, and you'll have a new Plone theme.
The ideal behind this theming solution is to make the theming story for Plone the easiest in the CMS industry: Just buy a static HTML design and you could use it as a theme as such. (Of course, the complexity of the required Diazo transformation rules depends on the complexity of the theme and themed content.)
But back to the original problem: Diazo encourages the themer to use a plenty of different HTML mockups to keep the transformation rules simple. One should not try to generate theme elements for different page types in Diazo transformation rules, but use dedicated HTML mockups for different page types. But what if the original HTML design came only with a very few selected mockups, and creating the rest from those is up to you. You could either copy and paste, or...
Here comes a proof of concept script for generating HTML mockups from TALusing Chameleon template compiler (and Nix to remove need for virtualenv, because of Python dependencies).
But at first, why TAL? Because METAL macros of TAL can be used to make the existing static HTML mockups into re-usable macros/mixins with customizable slots with minimal effort.
For example, an existing HTML mockup:
<html>
<head>...</head>
<body>
...
<div>
Here be dragons.
</div>
...
</body>
<html>
Could be made into a re-usable TAL template (main_template.html) with:
<metal:masterdefine-macro="master">
<html>
<head>...</head>
<body>
...
<divmetal:define-slot="content">
Here be dragons.
</div>
...
</body>
<html>
</metal:master>
And re-used in a new mockup with:
<htmlmetal:use-macro="main_template.macros.master">
<body>
<divmetal:fill-slot="content">
Thunderbirds are go!
</div>
</body>
<html>
Resulting a new compiled mockup:
<html>
<head>...</head>
<body>
...
<div>
Thunderbirds are go!
</div>
...
</body>
The script maps all direct sub-directories and files with .html suffix in the same directory with the compiled template into its TAL namespace, so that macros from those can be reached with METAL syntax metal:use-macro="filebasename.macros.macroname" or metal:use-macro="templatedirname['filebasename'].macros.macroname".
Finally, here comes the example code:
#! /usr/bin/env nix-shell
#! nix-shell -i python -p pythonPackages.chameleon pythonPackages.docopt pythonPackages.watchdog
"""Chameleon Composer
Copyright (c) 2015 Asko Soukka <asko.soukka@iki.fi>
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
Usage:
./compose.py <filename>
./compose.py src/front-page.html
./compose.py <source> <destination> [--watch]
./compose.py src build
./compose.py src build --watch
"""
from__future__importprint_function
fromchameleonimportPageTemplateFile
fromchameleonimportPageTemplateLoader
fromdocoptimportdocopt
fromwatchdog.observersimportObserver
fromwatchdog.observers.pollingimportPollingObserver
fromwatchdog.utilsimportplatform
importos
importsys
importtime
defrender(template):
assertos.path.isfile(template)
# Add siblings as templates into compilation context for macro-use
context={}
dirname=os.path.dirname(template)
fornameinos.listdir(dirname):
path=os.path.join(dirname,name)
basename,suffix=os.path.splitext(name)
ifos.path.isdir(path):
context[basename]=PageTemplateLoader(path,'.html')
elifsuffix=='.html':
context[basename]=PageTemplateFile(path)
returnPageTemplateFile(template)(**context).strip()
classComposer(object):
def__init__(self,source,destination):
self.source=source
self.destination=destination
self.mapping={}
self.update()
defupdate(self):
source=self.source
destination=self.destination
mapping={}
# File to file
ifos.path.isfile(source)andos.path.splitext(destination)[-1]:
mapping[source]=destination
# File to directory
elifos.path.isfile(source)andnotos.path.splitext(destination)[-1]:
mapping[source]=os.path.join(
destination,
os.path.splitext(os.path.basename(source))[0]+'.html'
)
# Directory to directory
elifos.path.isdir(source):
forfilenameinos.listdir(source):
path=os.path.join(source,filename)
ifos.path.splitext(path)[-1]!='.html':
continue
mapping[path]=os.path.join(
destination,
os.path.splitext(os.path.basename(path))[0]+'.html'
)
self.mapping=mapping
def__call__(self):
forsource,destinationinself.mapping.items():
ifos.path.dirname(destination):
ifnotos.path.isdir(os.path.dirname(destination)):
os.makedirs(os.path.dirname(destination))
withopen(destination,'w')asoutput:
print('{0:s} => {1:s}'.format(source,destination))
output.write(render(source).strip().encode('utf-8'))
# noinspection PyUnusedLocal
defdispatch(self,event):
# TODO: Build only changed files
self.update()
self.__call__()
defwatch(self):
ifplatform.is_darwin():
observer=PollingObserver()# Seen FSEventsObserver to segfault
else:
observer=Observer()
observer.schedule(self,self.source,recursive=True)
observer.start()
try:
whileTrue:
time.sleep(1)
exceptKeyboardInterrupt:
observer.stop()
observer.join()
sys.exit(0)
if__name__=='__main__':
arguments=docopt(__doc__,version='Chameleon Composer 1.0')
ifarguments.get('<filename>'):
print(render(arguments.get('<filename>')))
sys.exit(0)
composer=Composer(arguments.get('<source>'),
arguments.get('<destination>'))
composer()
ifarguments.get('--watch'):
print('Watching {0:s}'.format(arguments.get('<source>')))
composer.watch()