Hugo 主题
Quint
一个简约的主题,具有轻盈的氛围、站点搜索、内置图像横幅以及自动暗黑和浅色模式。
Quint:极简主义的精髓
Quint 是一款简约的 Hugo 主题,旨在营造干净、轻盈的氛围,强调清晰度和易读性。它具有优雅的内置图像横幅和轻量化的设计,使其成为展示您内容的首选。
查看演示站点存储库,您也可以将其用作新站点的启动模板。(嘘……那里有一个一键部署到 Netlify 的按钮。)
此处提供在线演示。
功能
- 极简设计:专注于内容可读性,减少干扰。
- 暗黑和浅色模式:自动主题切换,尊重浏览者的浏览器/设备设置。
- 响应式布局:在移动设备和桌面设备上都具有出色的外观。
- 包含图像横幅:附带精美的简约图像横幅,为您的站点定下基调。随时替换或添加您自己的横幅。
- 站点搜索:使用 Lunr.js 在您的静态站点上内置搜索。
- 社交图标:在页脚中可配置的指向您社交媒体的链接。
快速开始
要开始使用 Quint,您需要在您的机器上安装 Hugo。有关安装 Hugo 的更多信息,请查看官方 Hugo 文档。
有关使用 Hugo 创建新站点的分步指南,请阅读 快速入门。
步骤 1:安装主题
安装 Hugo 后,将 Quint 添加到您站点的 themes 目录中。从您的站点根目录运行
git submodule add https://github.com/victoriadrake/hugo-theme-quint.git themes/quint
步骤 2:将主题添加到您的配置
打开您的 Hugo 站点的配置文件(hugo.toml
、hugo.yaml
或 hugo.json
),并将 theme
参数更新为使用 quint
对于 hugo.toml
:
theme = "quint"
对于 hugo.yaml
:
theme: "quint"
步骤 3:配置
Quint 开箱即用,效果极佳。或者,将配置值从 yoursite/themes/quint/hugo.toml
复制到您站点的配置 (yoursite/hugo.toml
) 中,以进一步个性化 Quint。
步骤 4:运行服务器
运行 Hugo 以生成您的站点并启动服务器。从您的站点根目录运行
hugo server
在您的 Web 浏览器中导航到 https://#:1313
以查看使用 Quint 主题的站点效果。
获取更新
要下载最新版本的 Quint,请运行
git submodule update --remote themes/quint
自定义
Quint 的设计宗旨是易于自定义。
CSS
通过在您的 Hugo 配置中命名,轻松添加您自己的自定义 CSS 文件
[params]
css = ["css/custom.css"] # Your custom CSS overrides, stored in yoursite/static/
布局
您可以使用项目中同名的文件来覆盖任何布局。例如,文件 yoursite/layouts/partials/contact.html
将覆盖 yoursite/themes/quint/layouts/partials/contact.html
。
通过覆盖 yoursite/themes/quint/layouts/index.html
文件,从主页添加或删除部分。只需在您的项目目录 (yoursite/layouts/index.html
) 中创建此文件的副本,然后删除或添加您想要的任何 partial
。
图像横幅
如果页面或帖子未在前端指定 image
,Quint 将通过从目录 themes/quint/static/images
中选择随机图像来显示精美的图像横幅。
这是通过选择一个 1-10 的随机数来实现的,该随机数对应于一个图像文件名。您可以添加到此集合或替换您想要的任何图像。只需更新最大随机数以匹配您拥有的图像数量即可。
[params]
numImages = 12 # Number of random images to choose from for banners (in themes/quint/static/images)
贡献
欢迎为 Quint 做出贡献!请随时在 GitHub 上提交问题或拉取请求,以改进主题的功能或文档。
想获得一些入门的想法吗?以下是我想看到添加的功能的快速列表
- 代码块复制按钮
- Hugo 的 Chroma 语法高亮
- Hugo 的资源生成器,具有管道、指纹识别、捆绑和缩小功能
- 多语言支持
- 面包屑导航
许可证
本主题根据 MIT 许可证发布。有关更多详细信息,请参阅 LICENSE 文件。
归属
- Quint 使用了优秀的 Open Sauce 字体。
- 设备模型来自 deviceframes.com。