253 lines
10 KiB
Markdown
253 lines
10 KiB
Markdown
|
# FixIt 主题 | Hugo
|
|||
|
|
|
|||
|
|
[](https://github.com/hugo-fixit/FixIt/releases)
|
|||
|
|
[](https://gohugo.io/)
|
|||
|
|
[](/LICENSE)
|
|||
|
|
|
|||
|
|
👉 [English README](README.md) | 简体中文说明
|
|||
|
|
|
|||
|
|
> [FixIt](https://github.com/hugo-fixit/FixIt) 是一个**简洁**、**优雅**且**高效**的 [Hugo](https://gohugo.io/) 博客主题。
|
|||
|
|
|
|||
|
|
它的原型基于 [LoveIt 主题](https://github.com/dillonzq/LoveIt)，[KeepIt 主题](https://github.com/Fastbyte01/KeepIt) 和 [LeaveIt 主题](https://github.com/liuzc/LeaveIt)。
|
|||
|
|
|
|||
|
|
FixIt 主题继承了这些主题的优秀功能，并在此基础上添加了新的功能与优化，请阅读 [为什么选择 FixIt](#为什么选择-FixIt) 来了解更多。
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 快速上手
|
|||
|
|
|
|||
|
|
前往 [快速上手页面](https://fixit.lruihao.cn/zh-cn/documentation/getting-started/) 或从一个模板直接开始：
|
|||
|
|
|
|||
|
|
* [hugo-fixit/hugo-fixit-blog-git](https://github.com/hugo-fixit/hugo-fixit-blog-git)
|
|||
|
|
* [hugo-fixit/hugo-fixit-blog-go](https://github.com/hugo-fixit/hugo-fixit-blog-go)
|
|||
|
|
|
|||
|
|
## [完整文档](https://fixit.lruihao.cn/zh-cn/categories/documentation/)
|
|||
|
|
|
|||
|
|
前往这篇 [文档](https://fixit.lruihao.cn/zh-cn/documentation/basics/)，阅读关于安装与使用的详细指南。
|
|||
|
|
|
|||
|
|
或者在本地运行 [文档站点](https://fixit.lruihao.cn/zh-cn/)，更多细节详见 [参与贡献](#参与贡献)。
|
|||
|
|
|
|||
|
|
除此之外，还有 [FixIt 主题维基](https://github.com/hugo-fixit/FixIt/wiki)。
|
|||
|
|
|
|||
|
|
## 从 LoveIt 迁移
|
|||
|
|
|
|||
|
|
如果你现在正在使用 LoveIt 主题（或者一些其他的主题），你可以很容易地迁移至 FixIt。
|
|||
|
|
|
|||
|
|
你可以将这个主题仓库添加为你的网站目录的子模块。或者，您可以通过 [其他方式](https://fixit.lruihao.cn/zh-cn/documentation/basics/#install-theme) 安装主题。
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
git submodule add https://github.com/hugo-fixit/FixIt.git themes/FixIt
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
之后，你可以在站点目录通过这条命令来将主题更新至最新版本：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
git submodule update --remote --merge
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
接着，前往 `config.toml` 并将默认主题更改为 `FixIt`。
|
|||
|
|
|
|||
|
|
```diff
|
|||
|
|
- theme = "LoveIt"
|
|||
|
|
+ theme = "FixIt"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
这样就完成了迁移工作，现在一切准备就绪 🎉
|
|||
|
|
|
|||
|
|
## 为什么选择 FixIt
|
|||
|
|
|
|||
|
|
FixIt 主题继承了 LoveIt 等主题的优秀功能，并在它们的基础上添加了新的功能与优化，详见 [特性](#特性)。除此之外，FixIt 主题还有以下优点：
|
|||
|
|
|
|||
|
|
* 完善的中英文官方文档
|
|||
|
|
* 社区支持：主题官网、Discussions 和官方 QQ 群
|
|||
|
|
* 持续积极地更新
|
|||
|
|
* 不断收纳各方的建议和想法
|
|||
|
|
* 高度开放主题可自定义部分
|
|||
|
|
|
|||
|
|
总之，如果你更偏好 FixIt 主题的设计语言和自由度，如果你和我一样喜欢个性化自定义主题，那么，FixIt 主题可能是更适合你。
|
|||
|
|
|
|||
|
|
## 谁在用 FixIt
|
|||
|
|
|
|||
|
|
为了直观地浏览主题特性，这里有一些基于 **FixIt** 主题渲染的 [预览网站](https://fixit.lruihao.cn/zh-cn/friends/)。
|
|||
|
|
|
|||
|
|
## 特性
|
|||
|
|
|
|||
|
|
### 性能和 SEO
|
|||
|
|
|
|||
|
|
* **性能**优化：在 [Google PageSpeed Insights](https://developers.google.com/speed/pagespeed/insights) 中， 99/100 的移动设备得分和 100/100 的桌面设备得分
|
|||
|
|
* 使用基于 JSON-LD 格式 的 **SEO SCHEMA** 文件进行 SEO 优化
|
|||
|
|
* 支持 **[Google Analytics](https://analytics.google.com/analytics)**
|
|||
|
|
* 支持 **[Fathom Analytics](https://usefathom.com/)**
|
|||
|
|
* 支持搜索引擎的**网站验证** (Google, Bing, Yandex, Pinterest, Baidu, 360 and Sogou)
|
|||
|
|
* 支持所有第三方库的 **CDN**
|
|||
|
|
|
|||
|
|
### 外观和布局
|
|||
|
|
|
|||
|
|
* **响应式**布局
|
|||
|
|
* **浅色/深色** 主题模式
|
|||
|
|
* 全局一致的**设计语言**
|
|||
|
|
* 支持**分页**
|
|||
|
|
* 易用和自动展开的**文章目录**
|
|||
|
|
* 支持**多语言**和国际化
|
|||
|
|
* 美观的 **CSS 动画**
|
|||
|
|
|
|||
|
|
### 社交和评论系统
|
|||
|
|
|
|||
|
|
* 支持 **[Gravatar](https://gravatar.com)** 头像
|
|||
|
|
* 支持本地**头像**
|
|||
|
|
* 支持多达 **87** 种社交链接
|
|||
|
|
* 支持多达 **28** 种网站分享
|
|||
|
|
* 支持 **[Disqus](https://disqus.com)** 评论系统
|
|||
|
|
* 支持 **[Gitalk](https://github.com/gitalk/gitalk)** 评论系统
|
|||
|
|
* 支持 **[Valine](https://valine.js.org/)** 评论系统
|
|||
|
|
* 支持 **[Waline](https://waline.js.org/)** 评论系统
|
|||
|
|
* 支持 **[Facebook](https://developers.facebook.com/docs/plugins/comments/) 评论**系统
|
|||
|
|
* 支持 **[Telegram comments](https://comments.app/) 评论**系统
|
|||
|
|
* 支持 **[Commento](https://commento.io/)** 评论系统
|
|||
|
|
* 支持 **[Utterances](https://utteranc.es/)** 评论系统
|
|||
|
|
* 支持 **[Artalk](https://artalk.js.org/)** 评论系统
|
|||
|
|
* 支持 **[Twikoo](https://twikoo.js.org/)** 评论系统
|
|||
|
|
* 支持 **[giscus](https://giscus.app/zh-CN/)** 评论系统
|
|||
|
|
|
|||
|
|
### 扩展功能
|
|||
|
|
|
|||
|
|
* 支持**渐进式网页应用**
|
|||
|
|
* 支持**二级菜单**
|
|||
|
|
* 支持**内容加密**（页面、局部）
|
|||
|
|
* 支持**友情链接**的页面模板
|
|||
|
|
* 支持基于 [Lunr.js](https://lunrjs.com/) 或 [algolia](https://www.algolia.com/) 或 [Fuse.js](https://fusejs.io/) 的**搜索**
|
|||
|
|
* 支持 **Twemoji**
|
|||
|
|
* 支持**代码高亮**
|
|||
|
|
* 一键**复制代码**到剪贴板
|
|||
|
|
* 支持基于 [lightgallery](https://github.com/sachinchoolur/lightgallery) 的**图片画廊**
|
|||
|
|
* 支持 **[Font Awesome](https://fontawesome.com/) 图标**的扩展 Markdown 语法
|
|||
|
|
* 支持**上标注释**的扩展 Markdown 语法
|
|||
|
|
* 支持**分数**的扩展 Markdown 语法
|
|||
|
|
* 支持基于 [KaTeX](https://katex.org/) 的**数学公式**
|
|||
|
|
* 支持基于 [mermaid](https://github.com/knsv/mermaid) 的**图表** shortcode
|
|||
|
|
* 支持基于 [ECharts](https://echarts.apache.org/) 的**交互式数据可视化** shortcode
|
|||
|
|
* 支持基于 [Mapbox GL JS](https://docs.mapbox.com/mapbox-gl-js) 的 **Mapbox** shortcode
|
|||
|
|
* 支持基于 [APlayer](https://github.com/MoePlayer/APlayer) 和 [MetingJS](https://github.com/metowolf/MetingJS) 的**音乐播放器** shortcode
|
|||
|
|
* 支持 **Bilibili 视频** shortcode
|
|||
|
|
* 支持多种**注释**的 shortcode
|
|||
|
|
* 支持**自定义样式**的 shortcode
|
|||
|
|
* 支持**自定义脚本**的 shortcode
|
|||
|
|
* 支持基于 [TypeIt](https://typeitjs.com/) 的**打字动画** shortcode
|
|||
|
|
* 支持基于 [cookieconsent](https://github.com/osano/cookieconsent) 的 **Cookie 许可横幅**
|
|||
|
|
* 支持基于 [cell-watermark](https://github.com/Lruihao/watermark) 的**网页水印**
|
|||
|
|
* 支持基于 [pangu.js](https://github.com/vinta/pangu.js) 的**中文排版**
|
|||
|
|
* ……
|
|||
|
|
|
|||
|
|
## 多语言和国际化
|
|||
|
|
|
|||
|
|
FixIt 支持下列语言：
|
|||
|
|
|
|||
|
|
* 英语
|
|||
|
|
* 简体中文
|
|||
|
|
* 繁体中文
|
|||
|
|
* 法语
|
|||
|
|
* 波兰语
|
|||
|
|
* 巴西葡萄牙语
|
|||
|
|
* 意大利语
|
|||
|
|
* 西班牙语
|
|||
|
|
* 德语
|
|||
|
|
* 塞尔维亚语
|
|||
|
|
* 俄语
|
|||
|
|
* 罗马尼亚语
|
|||
|
|
* 越南语
|
|||
|
|
* [贡献一种新的语言](https://github.com/hugo-fixit/FixIt/pulls)
|
|||
|
|
|
|||
|
|
[语言兼容性](https://fixit.lruihao.cn/zh-cn/theme-documentation-basics/#language-compatibility)
|
|||
|
|
|
|||
|
|
## [路线图](https://github.com/hugo-fixit/FixIt/projects/1)
|
|||
|
|
|
|||
|
|
## [更新日志](/CHANGELOG.md)
|
|||
|
|
|
|||
|
|
## 问题、想法、bugs 和 PRs
|
|||
|
|
|
|||
|
|
所有的反馈都是欢迎的！详见 [议题](https://github.com/hugo-fixit/FixIt/issues) 或者 [讨论](https://github.com/hugo-fixit/FixIt/discussions)。
|
|||
|
|
|
|||
|
|
## 参与贡献
|
|||
|
|
|
|||
|
|
请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) 以了解贡献该项目的基本信息。
|
|||
|
|
|
|||
|
|
确保在贡献和参与讨论时遵守 [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)。
|
|||
|
|
|
|||
|
|
**贡献时，请先通过此存储库上的问题讨论您希望进行的更改，然后再进行实际更改**。
|
|||
|
|
|
|||
|
|
## [所有贡献者](contributors.md)
|
|||
|
|
|
|||
|
|
## 镜像
|
|||
|
|
|
|||
|
|
* Gitee 镜像仓库：<https://gitee.com/lruihao/FixIt>
|
|||
|
|
|
|||
|
|
## 致谢
|
|||
|
|
|
|||
|
|
<details open>
|
|||
|
|
<summary>FixIt 主题中用到了以下项目，感谢它们的作者：</summary>
|
|||
|
|
|
|||
|
|
* [normalize.css](https://github.com/necolas/normalize.css)
|
|||
|
|
* [Font Awesome](https://fontawesome.com/)
|
|||
|
|
* [Simple Icons](https://github.com/simple-icons/simple-icons)
|
|||
|
|
* [Animate.css](https://daneden.github.io/animate.css/)
|
|||
|
|
* [autocomplete-js](https://github.com/algolia/autocomplete)
|
|||
|
|
* [Lunr.js](https://lunrjs.com/)
|
|||
|
|
* [algoliasearch](https://github.com/algolia/algoliasearch-client-javascript)
|
|||
|
|
* [Fuse.js](https://fusejs.io/)
|
|||
|
|
* [object-fit-images](https://github.com/fregante/object-fit-images)
|
|||
|
|
* [Twemoji](https://github.com/twitter/twemoji)
|
|||
|
|
* [emoji-data](https://github.com/iamcal/emoji-data)
|
|||
|
|
* [lightgallery](https://github.com/sachinchoolur/lightgallery)
|
|||
|
|
* [Sharer.js](https://github.com/ellisonleao/sharer.js)
|
|||
|
|
* [TypeIt](https://typeitjs.com/)
|
|||
|
|
* [KaTeX](https://katex.org/)
|
|||
|
|
* [mermaid](https://github.com/mermaid-js/mermaid)
|
|||
|
|
* [ECharts](https://echarts.apache.org/)
|
|||
|
|
* [Mapbox GL JS](https://docs.mapbox.com/mapbox-gl-js)
|
|||
|
|
* [APlayer](https://github.com/MoePlayer/APlayer)
|
|||
|
|
* [MetingJS](https://github.com/metowolf/MetingJS)
|
|||
|
|
* [Gitalk](https://github.com/gitalk/gitalk)
|
|||
|
|
* [Valine](https://valine.js.org/)
|
|||
|
|
* [cookieconsent](https://github.com/osano/cookieconsent)
|
|||
|
|
* [cell-watermark](https://github.com/Lruihao/watermark)
|
|||
|
|
* [不蒜子](http://busuanzi.ibruce.info/)
|
|||
|
|
* [pangu.js](https://github.com/vinta/pangu.js)
|
|||
|
|
* [Artalk](https://artalk.js.org/)
|
|||
|
|
* [Waline](https://waline.js.org/)
|
|||
|
|
* [Twikoo](https://twikoo.js.org/)
|
|||
|
|
* [github-corners](https://github.com/tholman/github-corners)
|
|||
|
|
* [giscus](https://giscus.app/zh-CN)
|
|||
|
|
* [crypto-js](https://github.com/brix/crypto-js)
|
|||
|
|
* [vConsole](https://github.com/Tencent/vConsole)
|
|||
|
|
* [eruda](https://github.com/liriliri/eruda)
|
|||
|
|
* [pace](https://github.com/CodeByZach/pace)
|
|||
|
|
|
|||
|
|
</details>
|
|||
|
|
|
|||
|
|
<details open>
|
|||
|
|
<summary>FixIt 主题还借鉴了以下项目的部分功能，同样感谢它们的作者：</summary>
|
|||
|
|
|
|||
|
|
* [DoIt](https://github.com/HEIGE-PCloud/DoIt)
|
|||
|
|
* [NexT](https://github.com/next-theme/hexo-theme-next)
|
|||
|
|
|
|||
|
|
</details>
|
|||
|
|
|
|||
|
|
## 许可协议
|
|||
|
|
|
|||
|
|
FixIt 根据 **MIT** 许可协议授权。 更多信息请查看 [LICENSE 文件](LICENSE)。
|
|||
|
|
|
|||
|
|
## 作者
|
|||
|
|
|
|||
|
|
[Lruihao](https://github.com/Lruihao "在 GitHub 上关注我")
|
|||
|
|
|
|||
|
|
## 赞助支持
|
|||
|
|
|
|||
|
|
给我一个 Star 🌟 已经是对我最大的鼓励和支持了。\
|
|||
|
|
如果你喜爱这个主题，请考虑给我买杯咖啡 ☕️。
|
|||
|
|
|
|||
|
|
* [PayPal](https://paypal.me/Lruihao)
|
|||
|
|
* [支付宝](images/alipay.jpg)
|
|||
|
|
* [微信支付](images/wechatpay.jpg)
|
|||
|
|
|
|||
|
|
谢谢！❤️
|