{"ok": true, "next": null, "rows": [{"id": "metadata:database-level-metadata", "page": "metadata", "ref": "database-level-metadata", "title": "Database-level metadata", "content": "\"Database-level\" metadata refers to fields that can be specified for each database in a Datasette instance. These attributes should be listed under a database inside the  \"databases\"  field. \n                 The following are the full list of allowed database-level metadata fields: \n                 \n                     \n                         source \n                     \n                     \n                         source_url \n                     \n                     \n                         license \n                     \n                     \n                         license_url \n                     \n                     \n                         about \n                     \n                     \n                         about_url", "breadcrumbs": "[\"Metadata\", \"Metadata reference\"]", "references": "[]"}, {"id": "metadata:id1", "page": "metadata", "ref": "id1", "title": "Metadata", "content": "Data loves metadata. Any time you run Datasette you can optionally include a\n            YAML or JSON file with metadata about your databases and tables. Datasette will then\n            display that information in the web UI. \n         Run Datasette like this: \n         datasette database1.db database2.db --metadata metadata.yaml \n         Your  metadata.yaml  file can look something like this: \n         [[[cog\nfrom metadata_doc import metadata_example\nmetadata_example(cog, {\n    \"title\": \"Custom title for your index page\",\n    \"description\": \"Some description text can go here\",\n    \"license\": \"ODbL\",\n    \"license_url\": \"https://opendatacommons.org/licenses/odbl/\",\n    \"source\": \"Original Data Source\",\n    \"source_url\": \"http://example.com/\"\n}) \n         ]]] \n         [[[end]]] \n         Choosing YAML over JSON adds support for multi-line strings and comments. \n         The above metadata will be displayed on the index page of your Datasette-powered\n            site. The source and license information will also be included in the footer of\n            every page served by Datasette. \n         Any special HTML characters in  description  will be escaped. If you want to\n            include HTML in your description, you can use a  description_html  property\n            instead.", "breadcrumbs": "[]", "references": "[]"}, {"id": "metadata:id2", "page": "metadata", "ref": "id2", "title": "Metadata reference", "content": "A full reference of every supported option in a  metadata.json  or  metadata.yaml  file.", "breadcrumbs": "[\"Metadata\"]", "references": "[]"}, {"id": "metadata:metadata-column-descriptions", "page": "metadata", "ref": "metadata-column-descriptions", "title": "Column descriptions", "content": "You can include descriptions for your columns by adding a  \"columns\": {\"name-of-column\": \"description-of-column\"}  block to your table metadata: \n             [[[cog\nmetadata_example(cog, {\n    \"databases\": {\n        \"database1\": {\n            \"tables\": {\n                \"example_table\": {\n                    \"columns\": {\n                        \"column1\": \"Description of column 1\",\n                        \"column2\": \"Description of column 2\"\n                    }\n                }\n            }\n        }\n    }\n}) \n             ]]] \n             [[[end]]] \n             These will be displayed at the top of the table page, and will also show in the cog menu for each column. \n             You can see an example of how these look at  latest.datasette.io/fixtures/roadside_attractions .", "breadcrumbs": "[\"Metadata\"]", "references": "[{\"href\": \"https://latest.datasette.io/fixtures/roadside_attractions\", \"label\": \"latest.datasette.io/fixtures/roadside_attractions\"}]"}, {"id": "metadata:metadata-source-license-about", "page": "metadata", "ref": "metadata-source-license-about", "title": "Source, license and about", "content": "The three visible metadata fields you can apply to everything, specific databases or specific tables are source, license and about. All three are optional. \n             source  and  source_url  should be used to indicate where the underlying data came from. \n             license  and  license_url  should be used to indicate the license under which the data can be used. \n             about  and  about_url  can be used to link to further information about the project - an accompanying blog entry for example. \n             For each of these you can provide just the  *_url  field and Datasette will treat that as the default link label text and display the URL directly on the page.", "breadcrumbs": "[\"Metadata\"]", "references": "[]"}, {"id": "metadata:metadata-table-config", "page": "metadata", "ref": "metadata-table-config", "title": "Table configuration", "content": "Datasette supports a range of table-level configuration options including sort order, page size, facets, full-text search, column types, and more. These are now documented in the  table configuration  section of the configuration reference. \n             For backwards compatibility these options can be specified in either  metadata.yaml  or  datasette.yaml .", "breadcrumbs": "[\"Metadata\"]", "references": "[]"}, {"id": "metadata:per-database-and-per-table-metadata", "page": "metadata", "ref": "per-database-and-per-table-metadata", "title": "Per-database and per-table metadata", "content": "Metadata at the top level of the file will be shown on the index page and in the\n                footer on every page of the site. The license and source is expected to apply to\n                all of your data. \n             You can also provide metadata at the per-database or per-table level, like this: \n             [[[cog\nmetadata_example(cog, {\n    \"databases\": {\n        \"database1\": {\n            \"source\": \"Alternative source\",\n            \"source_url\": \"http://example.com/\",\n            \"tables\": {\n                \"example_table\": {\n                    \"description_html\": \"Custom <em>table</em> description\",\n                    \"license\": \"CC BY 3.0 US\",\n                    \"license_url\": \"https://creativecommons.org/licenses/by/3.0/us/\"\n                }\n            }\n        }\n    }\n}) \n             ]]] \n             [[[end]]] \n             Each of the top-level metadata fields can be used at the database and table level.", "breadcrumbs": "[\"Metadata\"]", "references": "[]"}, {"id": "metadata:table-level-metadata", "page": "metadata", "ref": "table-level-metadata", "title": "Table-level metadata", "content": "\"Table-level\" metadata refers to fields that can be specified for each table in a Datasette instance. These attributes should be listed under a specific table using the  \"tables\"  field. \n                 The following metadata fields are supported at the table level: \n                 \n                     \n                         source \n                     \n                     \n                         source_url \n                     \n                     \n                         license \n                     \n                     \n                         license_url \n                     \n                     \n                         about \n                     \n                     \n                         about_url \n                     \n                     \n                         columns  (see  Column descriptions ) \n                     \n                 \n                 Additionally, tables support a number of configuration options ( sort ,  sort_desc ,  size ,  sortable_columns ,  label_column ,  hidden ,  facets ,  facet_size ,  fts_table ,  fts_pk ,  searchmode ,  column_types ). See  table configuration  for full details.", "breadcrumbs": "[\"Metadata\", \"Metadata reference\"]", "references": "[]"}, {"id": "metadata:top-level-metadata", "page": "metadata", "ref": "top-level-metadata", "title": "Top-level metadata", "content": "\"Top-level\" metadata refers to fields that can be specified at the root level  of a metadata file. These attributes are meant to describe the entire Datasette instance. \n                 The following are the full list of allowed top-level metadata fields: \n                 \n                     \n                         title \n                     \n                     \n                         description \n                     \n                     \n                         description_html \n                     \n                     \n                         license \n                     \n                     \n                         license_url \n                     \n                     \n                         source \n                     \n                     \n                         source_url", "breadcrumbs": "[\"Metadata\", \"Metadata reference\"]", "references": "[]"}], "truncated": false}