Flask扩展,为您的网站添加漂亮的博客
项目描述
Canonical博客扩展
此扩展允许您为Flask应用程序添加一个简单的前端部分。所有文章都通过JSON API从Canonical的Wordpress后端获取。
此扩展提供3个路由的蓝图
- "/": 返回文章列表
- "/": 文章页面
- "/feed": 为页面提供RSS订阅。
安装
要将此扩展作为项目依赖项安装,您可以使用PIP;
pip3 install canonicalwebteam.blog
有关更多信息,请参阅pip安装文档。
用法
本地开发
对于本地开发,建议使用我们的网站项目之一(如ubuntu.com)测试此模块。有关更多信息,请参阅本指南(仅限内部使用)。
模板
模块期望在blog/index.html
、blog/article.html
、blog/blog-card.html
、blog/archives.html
、blog/upcoming.html
和blog/author.html
中找到HTML模板。
这些模板的示例可以在https://github.com/canonical-websites/jp.ubuntu.com/tree/master/templates/blog找到。
用法
在您的应用程序中,您可以执行以下操作
import flask
import talisker.requests
from flask_reggie import Reggie
from canonicalwebteam.blog import BlogViews, build_blueprint, BlogAPI
app = flask.Flask(__name__)
Reggie().init_app(app)
session = talisker.requests.get_session()
blog = build_blueprint(
BlogViews(
api=BlogAPI(session=session),
)
)
app.register_blueprint(blog, url_prefix="/blog")
您可以通过以下可选参数自定义博客
blog = build_blueprint(
BlogViews(
blog_title="Blog",
blog_path="blog",
tag_ids=[1, 12, 112],
exclude_tags=[26, 34],
per_page=12,
feed_description="The Ubuntu Blog Feed",
api=BlogAPI(
session=session,
use_image_template=True,
thumbnail_width=330,
thumbnail_height=185,
),
)
)
测试
所有测试都可以通过./setup.py test
运行。
重新生成固定数据
所有API调用都通过VCR捕获并保存为fixtures
目录中的固定数据。如果API更新,可以轻松更新所有固定数据,只需删除fixtures
目录并重新运行测试。
要执行此操作,请运行rm -rf fixtures && ./setup.py test
。
项目详情
下载文件
下载适用于您平台的应用程序文件。如果您不确定要选择哪一个,请了解更多关于安装包的信息。
源分发
canonicalwebteam.blog-6.4.2.tar.gz (13.3 kB 查看哈希值)
构建版本
关闭
canonicalwebteam.blog-6.4.2.tar.gz 的哈希
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 1230cf0e18eadaeb0f257031df2e7640d27c737e165a4a0bd4accef892e937a0 |
|
MD5 | d70827cb38292a5ed5905513d1a24288 |
|
BLAKE2b-256 | 3079042269a81ccfa1d39efea7bd87ffcdadcd9dc8c64c82e0c0215b133a2d39 |
关闭
canonicalwebteam.blog-6.4.2-py3-none-any.whl 的哈希
算法 | 哈希摘要 | |
---|---|---|
SHA256 | b686fbbc8e30e1a467d6199bf8a1bf9e882cf29a8be7c6f24a5d09d5255a68c6 |
|
MD5 | ab3a2dd157ed0cc48b54ff7ee6fabac5 |
|
BLAKE2b-256 | 395907d9d07f5ac1e99b7ca0f51e98576663f8a1b7e9cab6ac189e4eb60c2d65 |