Skip to content

Commit

Permalink
Rename _rows_and_columns.html to _table.html, refs #521
Browse files Browse the repository at this point in the history
  • Loading branch information
simonw committed Jul 3, 2019
1 parent c461357 commit e7120d9
Show file tree
Hide file tree
Showing 5 changed files with 20 additions and 20 deletions.
File renamed without changes.
2 changes: 1 addition & 1 deletion datasette/templates/row.html
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ <h1 style="padding-left: 10px; border-left: 10px solid #{{ database_color(databa

<p>This data as {% for name, url in renderers.items() %}<a href="{{ url }}">{{ name }}</a>{{ ", " if not loop.last }}{% endfor %}</p>

{% include custom_rows_and_columns_templates %}
{% include custom_table_templates %}

{% if foreign_key_tables %}
<h2>Links from other tables</h2>
Expand Down
2 changes: 1 addition & 1 deletion datasette/templates/table.html
Original file line number Diff line number Diff line change
Expand Up @@ -145,7 +145,7 @@ <h3>{{ extra_wheres_for_ui|length }} extra where clause{% if extra_wheres_for_ui
</div>
{% endif %}

{% include custom_rows_and_columns_templates %}
{% include custom_table_templates %}

{% if next_url %}
<p><a href="{{ next_url }}">Next page</a></p>
Expand Down
16 changes: 8 additions & 8 deletions datasette/views/table.py
Original file line number Diff line number Diff line change
Expand Up @@ -744,14 +744,14 @@ async def extra_template():
"sort": sort,
"sort_desc": sort_desc,
"disable_sort": is_view,
"custom_rows_and_columns_templates": [
"_rows_and_columns-{}-{}.html".format(
"custom_table_templates": [
"_table-{}-{}.html".format(
to_css_class(database), to_css_class(table)
),
"_rows_and_columns-table-{}-{}.html".format(
"_table-table-{}-{}.html".format(
to_css_class(database), to_css_class(table)
),
"_rows_and_columns.html",
"_table.html",
],
"metadata": metadata,
"view_definition": await db.get_view_definition(table),
Expand Down Expand Up @@ -828,14 +828,14 @@ async def template_data():
),
"display_columns": display_columns,
"display_rows": display_rows,
"custom_rows_and_columns_templates": [
"_rows_and_columns-{}-{}.html".format(
"custom_table_templates": [
"_table-{}-{}.html".format(
to_css_class(database), to_css_class(table)
),
"_rows_and_columns-row-{}-{}.html".format(
"_table-row-{}-{}.html".format(
to_css_class(database), to_css_class(table)
),
"_rows_and_columns.html",
"_table.html",
],
"metadata": (self.ds.metadata("databases") or {})
.get(database, {})
Expand Down
20 changes: 10 additions & 10 deletions docs/custom_templates.rst
Original file line number Diff line number Diff line change
Expand Up @@ -145,14 +145,14 @@ The lookup rules Datasette uses are as follows::
row.html

Rows and columns include on table page:
_rows_and_columns-table-mydatabase-mytable.html
_rows_and_columns-mydatabase-mytable.html
_rows_and_columns.html
_table-table-mydatabase-mytable.html
_table-mydatabase-mytable.html
_table.html

Rows and columns include on row page:
_rows_and_columns-row-mydatabase-mytable.html
_rows_and_columns-mydatabase-mytable.html
_rows_and_columns.html
_table-row-mydatabase-mytable.html
_table-mydatabase-mytable.html
_table.html

If a table name has spaces or other unexpected characters in it, the template
filename will follow the same rules as our custom ``<body>`` CSS classes - for
Expand Down Expand Up @@ -189,16 +189,16 @@ content you can do so by creating a ``row.html`` template like this::
Note the ``default:row.html`` template name, which ensures Jinja will inherit
from the default template.

The ``_rows_and_columns.html`` template is included on both the row and the table
page, and displays the content of the row. The default ``_rows_and_columns.html`` template
`can be seen here <https://github.com/simonw/datasette/blob/master/datasette/templates/_rows_and_columns.html>`_.
The ``_table.html`` template is included on both the row and the table
page, and displays the content of the row. The default ``_table.html`` template
`can be seen here <https://github.com/simonw/datasette/blob/master/datasette/templates/_table.html>`_.

You can provide a custom template that applies to all of your databases and
tables, or you can provide custom templates for specific tables using the
template naming scheme described above.

Say for example you want to output a certain column as unescaped HTML. You could
provide a custom ``_rows_and_columns.html`` template like this::
provide a custom ``_table.html`` template like this::

<table>
<thead>
Expand Down

0 comments on commit e7120d9

Please sign in to comment.