Document that datasette.render_template(template, ...) also accepts a list of templates

[simonw]

https://docs.datasette.io/en/stable/internals.html#await-render-template-template-context-none-request-none

await .render_template(template, context=None, request=None)

This currently only accepts a single template. If it accepted a list of templates (where the first available template gets rendered) it could be more widely used by Datasette internally.

Spotted this while researching #1042.

[simonw]

It turns out it already does that:

datasette/datasette/app.py

Lines 710 to 720 in 976e5f7

	async def render_template(
	self, templates, context=None, request=None, view_name=None
	):
	context = context or {}
	if isinstance(templates, Template):
	template = templates
	else:
	if isinstance(templates, str):
	templates = [templates]
	template = self.jinja_env.select_template(templates)

But the documentation doesn't reflect that:

template - string

The template file to be rendered, e.g. my_plugin.html. Datasette will search for this file first in the --template-dir= location, if it was specified - then in the plugin's bundled templates and finally in Datasette's set of default templates.