第三方模块开发¶
DeerU为第三方开发者提供了一个 start
命令,用于快速生成Django app以及一些必要的文件,
这个命令也一样可以用于开发其他Django项目的app,不过在DeerU项目外运行这个命令你需要这样使用 deeru-admin start xxx
下面将用一个示例说明开发第三方模块的基本流程
新建项目:
deeru-admin install m_deeru
运行start命令
python manage.py start plugin content_detection
如果一切正常,那么你会看到下面的目录结构(这里只选取了重要的文件):
m_deeru/ content_detection/ apps.py consts.py ... content_detection_setup.py README.rst MANIFEST.in git_add.sh
-
content_detection/apps.py
在apps.py的中
AppConfig
中你可以看到一些专属的变量- deeru_config_context:
config_context的路径
-
content_detection/consts.py
在consts.py的中有一个dict
content_detection_config_context
, 这个只有主题开发才用得到。 在这个dict中的配置,会在访问页面时从数据库读取放入context中传给前端,这个dict的key为context中的名字,value为数据库中保存的名字,如:
{ 'top_ico2' : '顶部图标栏2' }
在 admin - 配置 - 新建 名为”顶部图标栏2” 的配置,此配置放入context中时名字为”top_ico2”
-
content_detection_setup.
py
¶ 此命令自动生成了打包的setup.py文件,你需要填写里面空的地方
-
git_add.
sh
¶ 如果不想把DeerU的代码一同上传到git仓库,可以查看里面的add示例。
-
编写你的代码
打包发布:
python content_detection_setup.py sdist bdist_wheel twine upload dist/*
提交到DeerU插件、主题列表里(不再支持插件了)
fork项目 https://github.com/gojuukaze/deeru_plugin_theme 把你的插件、主题加到py、readme 中,提交 合并请求