SVBTLE 主题技术文档

1. 安装指南

从源码安装

首先，下载 SVBTLE 主题仓库 并将其保存在可访问的位置。接着，编辑 settings.py 文件，并将 THEME 变量修改为指向下载的主题位置。

从官方仓库安装

请参考 Pelican 主题的 安装说明。

2. 项目使用说明

SVBTLE 主题是一个接近 Svbtle.com 的复制版本，用于与 Pelican 一起使用。您可以在 这里 查看主题演示，或者 这里 查看网站代码。

主题特色包括：

• 代码块语法高亮
• Google Analytics 集成
• Disqus 评论系统
• 自定义链接列表
• 支持 LaTeX 插件

已知问题：

• 未进行 IE 测试
• 无自定义菜单
• 头部日期格式在 ./templates/header.html 中硬编码，除了文章以外
• Svbtle 使用 Freight-Sans-Pro 字体为文章标题，Proxima Nova 字体为正文。虽然它们是很棒的字体，但都不是免费的。我已经提供了链接，以防客户已安装，但大多数用户将使用 Open Sans 字体浏览网站

3. 项目API使用文档

当前主题支持的 Pelican 全局变量包括：

• GOOGLE_ANALYTICS
• GAUGES_ANALYTICS
• DISQUS_SITENAME
• LINKS(('name1', 'url1'), ('name2', 'url2'))
• DEFAULT_DATE_FORMAT = ('%b %d, %Y')：建议的日期格式
• FEED_DOMAIN = SITEURL
• AUTHOR_BIO，提供一个出现在侧边栏的简短传记

在本地开发时，请设置以下变量：

SITEURL = http://localhost:8000

如果想要启用 LaTeX 支持，必须配置额外的设置。

4. 项目安装方式

• 修改主题 accent 颜色：通过编辑 @accent 在 ./static/css/style.less 中实现。
• 使用不同的 Pygmentize 主题：通过编辑 ./Makefile 并运行 make pygments 实现。

作者：William Ting

本项目根据 MIT 许可发布，详细信息请查看 LICENSE 文件。