Skip to content

Latest commit

 

History

History
262 lines (193 loc) · 10.4 KB

README.zh-cn.md

File metadata and controls

262 lines (193 loc) · 10.4 KB
Raw

FixIt 主题 | Hugo

GitHub release (latest by date) Hugo License

👉 English README | 简体中文说明

FixIt 是一个简洁、优雅且高效的 Hugo 博客主题。

它的原型基于 LoveIt 主题，KeepIt 主题 和 LeaveIt 主题。

FixIt 主题继承了这些主题的优秀功能，并在此基础上添加了新的功能与优化，请阅读 为什么选择 FixIt 来了解更多。

Hugo Theme FixIt

立即开始

前往这篇 文档，阅读关于安装与使用的详细指南。

或者，在本地构建 文档：

Gitee 镜像仓库：https://gitee.com/lruihao/FixIt

git clone --recursive https://github.com/hugo-fixit/FixIt.git && cd FixIt

hugo server --source=docs

除此之外，还有FixIt 主题维基。

迁移和升级

如果你现在正在使用 LoveIt 主题（或者一些其他的主题），你可以很容易地迁移至 FixIt。

你可以将这个主题仓库添加为你的网站目录的子模块。

# 稳定版
git submodule add https://github.com/hugo-fixit/FixIt.git themes/FixIt

# ⚠️ 开发版
git submodule add -b dev https://github.com/hugo-fixit/FixIt.git themes/FixIt

接着，前往 config.toml 并将默认主题更改为 FixIt。

- theme = "LoveIt"
+ theme = "FixIt"

这样就完成了迁移工作，现在一切准备就绪 🎉

之后，你可以在站点目录通过这条命令来将主题更新至最新版本：

git submodule update --remote --merge

为什么选择 FixIt

FixIt 主题继承了 LoveIt 等主题的优秀功能，并在它们的基础上添加了新的功能与优化，详见 特性。除此之外，FixIt 主题还有以下优点：

  • 完善的中英文官方文档
  • 社区支持：主题官网、Discussions 和官方 QQ 群
  • 持续积极地更新
  • 不断收纳各方的建议和想法
  • 高度开放主题可自定义部分

总之，如果你更偏好 FixIt 主题的设计语言和自由度，如果你和我一样喜欢个性化自定义主题，那么，FixIt 主题可能是更适合你。

谁在用 FixIt

为了直观地浏览主题特性，这里有一些基于 FixIt 主题渲染的预览网站。

你可以 提交 PR 以字典顺序将您的 FixIt 网站添加到列表中。（例如：#111）

特性

性能和 SEO

  • 性能优化：在 Google PageSpeed Insights 中， 99/100 的移动设备得分和 100/100 的桌面设备得分
  • 使用基于 JSON-LD 格式 的 SEO SCHEMA 文件进行 SEO 优化
  • 支持 Google Analytics
  • 支持 Fathom Analytics
  • 支持搜索引擎的网站验证 (Google, Bing, Yandex, Pinterest, Baidu, 360 and Sogou)
  • 支持所有第三方库的 CDN
  • 基于 lazysizes 自动转换图片为懒加载

外观和布局

  • 响应式布局
  • 浅色/深色 主题模式
  • 全局一致的设计语言
  • 支持分页
  • 易用和自动展开的文章目录
  • 支持多语言和国际化
  • 美观的 CSS 动画

社交和评论系统

扩展功能

  • 支持渐进式网页应用
  • 支持二级菜单
  • 支持内容加密（页面、局部）
  • 支持友情链接的页面模板
  • 支持基于 Lunr.js 或 algolia 的搜索
  • 支持 Twemoji
  • 支持代码高亮
  • 一键复制代码到剪贴板
  • 支持基于 lightgallery 的图片画廊
  • 支持 Font Awesome 图标的扩展 Markdown 语法
  • 支持上标注释的扩展 Markdown 语法
  • 支持分数的扩展 Markdown 语法
  • 支持基于 KaTeX 的数学公式
  • 支持基于 mermaid 的图表 shortcode
  • 支持基于 ECharts 的交互式数据可视化 shortcode
  • 支持基于 Mapbox GL JS 的 Mapbox shortcode
  • 支持基于 APlayer 和 MetingJS 的音乐播放器 shortcode
  • 支持 Bilibili 视频 shortcode
  • 支持多种注释的 shortcode
  • 支持自定义样式的 shortcode
  • 支持自定义脚本的 shortcode
  • 支持基于 TypeIt 的打字动画 shortcode
  • 支持基于 cookieconsent 的 Cookie 许可横幅
  • 支持基于 cell-watermark 的网页水印
  • 支持基于 pangu.js 的中文排版
  • ...

多语言和国际化

FixIt 支持下列语言：

  • 英语
  • 简体中文
  • 繁体中文
  • 法语
  • 波兰语
  • 巴西葡萄牙语
  • 意大利语
  • 西班牙语
  • 德语
  • 塞尔维亚语
  • 俄语
  • 罗马尼亚语
  • 越南语
  • 贡献一种新的语言

语言兼容性

路线图

更新日志

问题、想法、bugs 和 PRs

所有的反馈都是欢迎的！详见 议题 或者 讨论。

参与贡献

请参阅 CONTRIBUTING.md 以了解贡献该项目的基本信息。

确保在贡献和参与讨论时遵守 CODE_OF_CONDUCT.md。

贡献时，请先通过此存储库上的问题讨论您希望进行的更改，然后再进行实际更改。

所有贡献者

致谢

FixIt 主题中用到了以下项目，感谢它们的作者：
FixIt 主题还借鉴了以下项目的部分功能，同样感谢它们的作者：

许可协议

FixIt 根据 MIT 许可协议授权。 更多信息请查看 LICENSE 文件。

作者

Lruihao

赞助支持

如果你喜爱这个主题，请考虑给我买杯咖啡 ☕️.

谢谢！❤️