向项目添加新闻应用程序的可重用小程序包
giant-news的Python项目详细描述
重大新闻
一个可重用的包,可用于任何需要通用News
应用程序的项目。在
这将包括基本格式和功能,如通过管理员创建模型。在
安装
要使用包管理器安装,请运行:
$ poetry add giant-news
然后,您应该将"news", "easy_thumbnails" and "filer"
添加到设置文件中的INSTALLED_APPS
。
此应用程序中的详细信息页使用此应用程序中未包含的插件。建议您在项目中包含一组插件,或使用giant-plugins
应用程序。在
为了运行django-admin
命令,您需要通过运行
配置
此应用程序公开以下设置:
- 在
在ARTICLETAG_ADMIN_LIST_DISPLAY
是管理索引的字段列表。这一定是个列表 - 在
在ARTICLETAG_ADMIN_FIELDSETS
允许用户定义管理字段集。这必须是两个元组的列表 - 在
在ARTICLETAG_ADMIN_READONLY_FIELDS
允许用户在管理中配置只读字段。这一定是个列表 - 在
在ARTICLE_ADMIN_LIST_DISPLAY
是管理索引的字段列表。这一定是个列表 - 在
在ARTICLE_ADMIN_SEARCH_FIELDS
允许用户在管理中配置搜索字段。这一定是个列表 - 在
在ARTICLE_ADMIN_FIELDSETS
允许用户定义管理字段集。这必须是两个元组的列表 - 在
在ARTICLE_ADMIN_READONLY_FIELDS
允许用户在管理中配置只读字段。这一定是个列表 - 在
在AUTHOR_ADMIN_LIST_DISPLAY
是管理索引的字段列表。这一定是个列表 - 在
在AUTHOR_ADMIN_FIELDSETS
允许用户定义管理字段集。这必须是两个元组的列表 - 在
在AUTHOR_ADMIN_READONLY_FIELDS
允许用户在管理中配置只读字段。这一定是个列表 - 在
在RELATED_ARTICLES_LIMIT
允许用户设置相关文章插件中的文章数量,默认值为3。必须是int
网址
将以下内容添加到core.urls
以获得常规功能:
path("news/", include("news.urls"), name="news"),
如果要自定义URL以包含不同的路径和/或模板,首先必须在core.urls
中导入from news import views as news_views
,然后可以添加以下内容:
path("news/", news_views.ArticleIndex.as_view(template_name="news/index.html"), name="news-index"),
path("news/<slug:slug>/", news_views.ArticleDetail.as_view(template_name="news/detail.html"), name="news-detail"),
准备释放
为了为TestPyPi和PyPi的新版本准备包,您需要做一件关键的事情。您需要更新pyproject.toml
中的版本号。
这样就可以在不发生版本号冲突的情况下发布包。版本编号还必须遵循语义版本规则,可以在此处找到https://semver.org/。在
出版
出版一个包含诗歌的包是非常容易的。检查版本号是否已更新(与以前的版本不同)后,只需运行两个命令。在
$ `poetry build`
将为您打包项目,以便于发布。在
$ `poetry publish`
将包发布到PyPi。您需要输入在公司密码管理器中找到的帐户的用户名和密码
- 项目
标签: