8.1 KiB
LoveIt 主题 | Hugo
English README | 中文说明
LoveIt 是一个简洁、优雅且高效的 Hugo 博客主题。
它的原型基于 LeaveIt 主题 和 KeepIt 主题。
由于三个主题外观的相似性，如果你对于它们的不同之处有疑问，请阅读 为什么选择 LoveIt，以便你能选择最适合你的一个。
主题预览
为了直观地浏览主题特性，这里有一个基于 LoveIt 主题渲染的 预览网站。
为什么选择 LoveIt
相较于 LeaveIt 主题 和 KeepIt 主题，LoveIt 主题主要有以下修改
- 固定的标题栏
- 系统原生字体
- 主页副标题的打字机效果
- 焕然一新的主页文章列表，已经兼容最新版 Hugo
- 所有主题图标替换为 Font Awesome
- 大量的样式细节调整，包括颜色、字体大小、边距、代码预览样式
- 可读性更强的暗黑模式
- 一些美观的 CSS 动画
- 易用和自动展开的文章目录，同时适配移动端
- 为了更适合作为博客主题，去除了画廊功能，但保留了图片懒加载以提高性能
- 使用 Font Awesome 图标的扩展 Markdown 语法
- 支持基于 Katex 的数学公式
- 支持基于 mermaid 的图表和流程图生成功能
- 支持基于 APlayer 和 MetingJS 的内嵌音乐播放器
- 支持内嵌 Bilibili 视频
- 支持多种提醒样式的 shortcode
- 支持自定义对齐和浮动方式的 shortcode
- 支持所有第三方库的 CDN
- 更加丰富的自定义设置
所以，如果你更偏好 LoveIt 主题的设计语言和自由度，如果你想便捷地使用扩展的 Font Awesome 图标，如果你想在文章内嵌数学公式、流程图、音乐或是 Bilibili 视频， 那么，LoveIt 主题可能是更适合你。 希望你会 LoveIt ❤️!
特性
性能和 SEO
- 性能优化：在 Google PageSpeed Insights 中， 99/100 的移动设备得分和 100/100 的桌面设备得分
- 使用基于 JSON-LD 格式 的 SEO SCHEMA 文件进行 SEO 优化
- 支持 Google Analytics
- 支持搜索引擎的网站验证 (Google, Bind, Yandex and Baidu)
- 支持所有第三方库的 CDN
- 基于 lazysizes 自动转换图片为懒加载
外观和布局
- 桌面设备/移动设备 响应式布局
- 暗黑/明亮 模式
- 页面和列表保持一致的视觉样式
- 支持分页
- 易用和自动展开的文章目录，同时适配移动端
- 支持多语言和国际化
- 美观的 CSS 动画
社交和评论系统
扩展功能
- 基于 Hugo 使用的 chroma 进行代码高亮
- 使用 Font Awesome 图标的扩展 Markdown 语法
- 支持基于 Katex 的数学公式
- 支持基于 mermaid 的图表和流程图生成功能
- 支持基于 APlayer 和 MetingJS 的内嵌音乐播放器
- 支持内嵌 Bilibili 视频
- 支持多种提醒样式的 shortcode
- 支持自定义对齐和浮动方式的 shortcode
- 支持基于 TypeIt 的打字动画
- 支持基于 Smooth Scroll 的回到顶部动画
- ...
快速开始
直接克隆这个代码库到你的 Hugo 主题目录，
cd themes
git clone https://github.com/dillonzq/LoveIt.git
或者，把这个代码库作为子模块。
git submodule add https://github.com/dillonzq/LoveIt.git themes/LoveIt
下一步， 打开 Hugo 网站的根目录下的 config.toml 文件来把 theme 设置为 LoveIt：
theme = "LoveIt"
更多信息请查看 Hugo 的 官方安装指南。
网站设置
请看一看 exampleSite 目录下的文件。
这个目录包含了 en 和 zh 两种语言的预览网站配置。它可以作为你的网站的配置模板。
复制 config.toml 文件到你的 Hugo 网站代码根目录。必要的话覆盖原始配置文件。
目录结构建议
以下是一些方便你清晰管理和生成文章的目录结构建议：
- 保持博客文章存放在
content/posts目录，例如：content/posts/我的第一篇文章.md - 保持简单的静态页面存放在
content目录，例如：content/about.md - 保持图片之类的媒体资源存放在
static目录，例如：static/images/2019/9/screenshot.png
为你的网站自定义样式
如果你想改变一些网站样式来满足你的需求，你可以编辑：
assets/css/_varibales.scss： 你可以覆盖_variables.scss中的变量来自定义样式assets/css/_custom.scss： 你可以把自定义的样式放在这个文件- 需要使用hugo extended版本编译sass，否则修改css无法生效
网站图标、浏览器配置、网站清单
强烈建议你把：
- apple-touch-icon.png (180x180)
- favicon-32x32.png (32x32)
- favicon-16x16.png (16x16)
- mstile-150x150.png (150x150)
- android-chrome-192x192.png (192x192)
- android-chrome-512x512.png (512x512)
放在 /static 目录。利用 https://realfavicongenerator.net/ 可以很容易地生成这些文件。
可以自定义 browserconfig.xml 和 site.webmanifest 文件来设置 theme-color 和 background-color。
小技巧
在生成网站时设置 production 环境变量
由于主题的一些功能仅在生产环境有效，所以你需要在生成网站时设置 production 环境变量。
HUGO_ENV=production hugo --gc --minify
怎样切换网站 暗黑-明亮 模式
- 你可以点击圆形图标来切换网站 暗黑-明亮 模式。桌面模式下圆形图标在网页右上角，移动设备模式下在网站左上角标题旁边
- 如果你想自定义切换网站 暗黑-明亮 模式的元素，可以使用一个 class 包含
.theme-switch的元素，详见此处
主页预览文章模式
如果你想在主页显示文章而不仅仅是个人信息，请打开配置文件 config.toml，并增加下面一行：
[params]
home_mode = "post"
增加网站 logo 和封面用于 SEO 优化
增加一个 logo 图片 (127x40) 和一个封面图片 (800x600) 在 static 目录。
问题、想法、 bugs 和 PRs
所有的反馈都是欢迎的！详见 issue tracker。
许可协议
LoveIt 根据 MIT 许可协议授权。 更多信息请查看 LICENSE 文件。
感谢以下在主题中使用过的项目的作者：
- Font Awesome
- Animate.css
- lazysizes
- Smooth Scroll
- TypeIt
- Katex
- mermaid
- APlayer
- MetingJS
- Gitalk
- Valine