datasette-edit-templates by simonw

星标

README 源代码

datasette-edit-templates

PyPI Changelog Tests License

一个允许在 Datasette 中编辑 Datasette 模板的插件。

安装

请将此插件安装在与 Datasette 相同的环境中。

datasette install datasette-edit-templates

用法

在启动时,将在您正在运行 Datasette 的数据库中创建一个名为 _templates_ 的表。

使用应用程序菜单导航到 /-/edit-templates 页面,并在那里编辑模板。

更改应该会立即显示,并会持久保存到您的数据库中。

此界面仅适用于具有 edit-templates 权限的用户。

默认情况下,root 用户拥有此权限。您可以使用 datasette mydb.db --root 作为 root 用户登录。

配置

要将 _templates_ 表放在特定数据库中,请设置 datasette-edit-templates: database 插件配置选项

{
    "plugins": {
        "datasette-edit-templates": {
            "database": "some_database"
        }
    }
}

在 Datasette 1.0a5 或更高版本上,您可以使用 内部数据库 并设置 "internal_db: true":

{
    "plugins": {
        "datasette-edit-templates": {
            "internal_db": true
        }
    }
}

默认情况下,将使用 prepare_jinja2_environment() 钩子来加载自定义模板。

您可以使用 skip_prepare_jinja2_environment 插件配置选项禁用此行为

{
    "plugins": {
        "datasette-edit-templates": {
            "skip_prepare_jinja2_environment": true
        }
    }
}

如果您想使用另一个插件进一步自定义模板的加载方式,请设置此选项。

用于访问此插件的菜单项默认标记为“编辑模板”。您可以使用 menu_label 插件配置选项来自定义此项

{
    "plugins": {
        "datasette-edit-templates": {
            "menu_label": "Custom templates"
        }
    }
}

将其设置为 null 将完全隐藏菜单选项。

开发

要在本地设置此插件,首先请检出代码。然后创建一个新的虚拟环境

cd datasette-edit-templates
python3 -mvenv venv
source venv/bin/activate

或者如果您正在使用 pipenv

pipenv shell

现在安装依赖项和测试

pip install -e '.[test]'

运行测试

pytest