鹈鹕的芦苇主题
bulrush的Python项目详细描述
芦苇
图标来自Dave Gandy的Font Awesome。纯html/css"fork me
"on github"功能区基于Simon Whitaker的Github fork-ribbon-css
将其修改为更平坦。
功能
[X]响应式设计-桌面四列布局(≥980px),三列 平板电脑(≥769px),移动式单柱。选项卡式导航栏折叠 进入手机上的下拉菜单"汉堡菜单"。
[X]元标记功能-支持打开图形和Twitter 卡片元标记,在共享社交文章时提供增强的显示 媒体网站(注:目前仅适用于文章和页面)。
[X]可打印布局-打印时导航隐藏,避免 浪费空间。
[X]自定义样式-可以包括其他CSS文件以自定义 默认样式。
[X]服务集成-包括DISPS、Github、Google Analytics 和MailChimp。
[X]PYPI软件包可用-因此它可以被
PIP安装
-ed.
安装
bulrush可通过python包索引获得,因此您可以安装它 用:
pip install bulrush
模块的主要输出为:
路径
:主题的路径;过滤器
:主题使用的附加Jinja过滤器;和环境
:主题所需的Jinja环境。
您可以在pelicanconf.py中使用它们,如下所示:
importbulrushTHEME=bulrush.PATHJINJA_ENVIRONMENT=bulrush.ENVIRONMENTJINJA_FILTERS=bulrush.FILTERS
其他要求
您需要使相应的鹈鹕插件可用。一
实现这一点的方法是将鹈鹕插件
存储库作为
你的网站,然后你可以添加到你的pelicanconf.py
:
PLUGIN_PATHS=['pelican-plugins']PLUGINS=['assets']
注意:以这种方式引用鹈鹕插件可能会影响 你的项目许可证。请参见https://github.com/textup/bulrush/issues/17
替代方案
如果你不想安装来自pypi的主题,你可以简单地给鹈鹕一个
内部bulrush/
目录的相对路径。例如,将bulrush添加为
子模块和集合:
THEME='bulrush/bulrush'
在这种情况下,您需要配置环境并自行筛选
并确保webassets
是从pypi安装的。
其他屏幕截图
480 x 480px(移动):
840 x 480px(平板电脑):
980 x 480px(桌面):
设置
Bulrush除了支持基本设置中的以下选项外,还支持
您的pelicanconf.py
:
取消网站名称
github_url
谷歌分析
'ua-xxxx-yyyy'
以激活谷歌分析。许可证
链接
('title','url')
用于显示在侧边栏的"blogroll"部分中的链接。mailcimp
菜单项
站点字幕
社交
('title','url')
将显示在侧边栏的"social"部分中。Twitter用户名
如果菜单上的"显示类别"被省略或显式设置为"真",则
类别显示在带有任何菜单项的选项卡式导航中。如果
在菜单上显示页面
被省略或显式设置为真
,它们被列出
在侧边栏中有任何社交
或其他链接
社交链接
在侧边栏中为
社交
链接列表。请查看social.html
以查看此标题
适用于。如果没有匹配的站点,则:
- 如果元组中的第二个url元素以
'mailto:'
开头,则为一个信封 使用图标;否则 - 使用地球图标。
MailChimp配置
如果您使用mailcimp来处理博客的邮件列表,那么 可以在侧栏中配置订阅表单。你需要设定三个值 若要启用此功能,您可以从注册表单创建者获取。简单地 查找表单操作:
<formaction="//user.region.list-manage.com/subscribe/post?u=abc123&id=def456"...
并提取相关章节:
MAILCHIMP=dict(domain='user.region.list-manage.com',user_id='abc123',list_id='def456',validation=True,# enable jQuery validation)
如果设置validation=false
(或完全忽略它),您将减少
页面加载(因为它不需要140kb的javascript)但不会得到内联表单
提交或电子邮件验证。
您还可以添加rewards\u url
,提供您唯一的monkeyreawardsurl,
启用一个由mailchimp提供能量的链接。
许可证设置
您可以提供两个选项之一来指定lic为您的内容添加内容:
许可证名称(
str
):要显示的许可证的名称。除非另有规定 指定后,将使用默认图标(file-text-o
)并输入 将链接到当前页。Creative Commons许可证名称(例如
'cc by-sa 4.0'
)将自动 识别并生成相应的图标和链接。许可证定义(
dict
):指定名称
、url
和 可选的图标
(必须是字体awesome图标名,默认为file-text-o
)。
许可证详细信息将显示在每个 页,
自定义样式
如果额外路径元数据中的任何条目以
'.css'
它们将包含在基本模板中,允许网站样式
根据需要重写。例如,在pelicanconf.py中:
# Static filesSTATIC_PATHS=['extra',...]EXTRA_PATH_METADATA={'extra/custom.css':{'path':'custom.css'},...}
使用中
现在很少有Bulrush(或其修改版本)的用户:
如果你想成为这里的主角(或者现在或者不想成为),感觉 免费提交拉取请求。