django-plugin-blog

A simple blog implemented as a DJP plugin.

安装

将此插件安装在与您的Django应用程序相同的环境中。

pip install django-plugin-blog

用法

This adds a blog at /blog/, configured to be edited using the Django admin.

自定义模板

默认模板期望有一个包含 {% block title %}、{% block content %} 和 {% block extra_head %} 块的基本模板。

您可以使用 DJANGO_PLUGIN_BLOG_BASE_TEMPLATE 设置来指向现有的基本模板。

您还可以在您的模板目录中提供以下模板文件的自己的版本

• django_plugin_blog/base.html - 博客的基本模板
• django_plugin_blog/index.html - 索引页面，在 /blog/
• django_plugin_blog/archive.html - 归档页面，在 /blog/archive/
• django_plugin_blog/year.html - 一年的归档，在 /blog/YYYY/
• django_plugin_blog/tag.html - 标签的归档，在 /blog/tag/TAG/
• django_plugin_blog/entry.html - 文章详情页面，位于 /blog/YYYY/slug/

Atom源

在 /blog/feed/ 提供了源。您可以使用 DJANGO_PLUGIN_BLOG_FEED_TITLE 设置来自定义此源标题。

自定义URL

默认情况下，插件在 /blog/ 之下添加URL。您可以使用 DJANGO_PLUGIN_BLOG_URL_PREFIX 设置来更改此设置。

开发

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

cd django-plugin-blog
python -m venv venv
source venv/bin/activate

现在安装依赖项和测试依赖项

pip install -e '.[test]'

要运行测试

python -m pytest