Added site config option toc_type, to allow overriding TOC template.

Name format for template is toc-$type.tmpl, which can be shipped in a brand ot packages some other way.

Added templates/toc-oneline.tmpl as an example of how to do this.

stand up publican website instance. create a custom toc template. (example in the publican source in git) update website using custom template.

Verified on Publican 3.0-0.t180

[Note for docs: template goes in /usr/share/publican/templates, specified in the site config file without the ".tmpl" filename extension]

But: Publican doesn't let me set either relative or absolute paths to this file. Would it be better to specify paths, so that we avoid any possible collisions when brands install their own tmpl files in /usr/share/publican/templates?

More info:

Setting an absolute path:

toc_type: /opt/local/bogus/dir/toc-min

and updating site gives me:

$ sudo publican update_site
file error - /opt/local/bogus/dir/toc-min.tmpl: absolute paths are not allowed (set ABSOLUTE option)

Setting a relative path:

toc_type: ../opt/local/bogus/dir/toc-min

and updating site gives me:

$ sudo publican update_site
file error - ../opt/local/bogus/dir/toc-min.tmpl: relative paths are not allowed (set RELATIVE option)

> Name format for template is toc-$type.tmpl, which can be shipped in a brand
> or packages some other way.

toc_type: foo

Associated template file toc-foo.tmpl in the normal template path.

To change the template path you'd have to set tmpl_path in the website config file and you'd need to override all the other template files.

OK; in that case, working as expected on publican-3.0-0.fc17.t180.noarch

Thanks!