support for two layout.html templates

[shimizukawa]

ReadTheDocs use layout.html to add their logo, but this skips project's custom layout.html and AFAICS this can't be changed without changing Sphinx code. See:

readthedocs/readthedocs.org#152 (comment)

Sphinx uses magic ! to skip template path, so only sphinx templates are searched when extend-ed template is prefixed with !. I think that the simplest way to allow two custom templates would be to add another magic prefix, say ?, that would skip only the first template directory in the list. Just a few lines in sphinx.jinja2glue.BuiltinTemplateLoader.get_source():

if template.startswith('?'):
    loaders = loaders[1:]
    template = template[1:]

what do you think?

---

• Bitbucket: https://bitbucket.org/birkenfeld/sphinx/issue/903
• Originally reported by: Marcin Wojdyr
• Originally created at: 2012-03-27T17:42:22.813