Hugo 主题
用于 Hugo 的 Perplex 主题
这个文档和多用途主题侧重于通过提供详细丰富的布局来获得良好的易读性。它通过自托管资源进行了高度的速度优化。启动新项目不需要其他软件。
要求
该主题依赖于 Hugo 的最新 扩展 版本以支持 WEBP。如果您是 Hugo 的新手,并想尽快开始使用,请访问 工作流程简介。
示例
该主题包含一个示例项目,其中在 exampleSite
文件夹中包含一些内容页面。该文档也是一个包含大量内容的 演示站点。
功能
各种类型的页面都渲染到相同的连贯的 流体响应式布局网格中。详细的排版设计基于经典原则和技术。
布局
Markdown 内容的默认样式 针对良好的易读性进行了优化,并且有很多选项可以进一步增强布局。
该主题可以生成
具有最多三个菜单级别的大型文档
博客文章
新闻流
作者页面
卡片预览
为了实现均衡的布局,一些内容片段和元数据参数不应超过一些合理的限制。该主题会提供检查和警告。我们可以在项目配置中单独更改限制并禁止所有警告。
配色方案
浅色和深色模式遵循操作系统环境的设置,并且它们的颜色对比符合 WCGA 标准。
默认的配色方案在单独的 CSS 文件中定义,可以替换为您自己的方案。
导航
所有元素,以便尽快浏览内容,都是从 frontmatter 中的数据生成的
顶部的站点菜单
用于文档的侧边栏菜单
分类
页面到页面链接
面包屑导航
图像
图像的外观可以在很大程度上进行控制。该主题处理它们的预处理和所有所需变体的生成。它们通过 Lazysizes 顺利交付,并且 没有 布局偏移。
图标
可以通过其标识符包含 Google 的 Material Symbols 和 Simple Icons 品牌图标。Material Symbols 会自动显示在文档的所有导航元素中。所有图标集也可以用作 Markdown 内容(使用短代码)。
全文搜索
该主题已准备好使用快速库 Pagefind 生成和自托管索引(需要额外安装其开源 node 包)。
高效!
使用此主题构建的站点可以 快速且经济高效 地交付。图像集经过高度优化以最大限度地减少所需的带宽(并且延迟加载),字体被分成小包,图标以内联方式嵌入。