跳转到主要内容

定制站点

站点级配置:品牌、导航、布局、搜索、多语言、多版本、打印与 Agent 输出。

本栏目覆盖站点级配置:hugo.yml 里的参数、data/ 下的数据文件、assets/ 下的样式入口。单个页面的写法与 front matter 见创作内容

按改动目标查找

改动目标 对应页面
站名、Logo、favicon 品牌外观
配色、深浅色模式、字体 品牌外观
顶栏菜单与下拉 导航与菜单
侧栏宽度、图标密度、目录深度 布局与页面类型
首页与落地页 首页与落地页
全文检索与索引范围 全文检索
命令面板里的条目 命令面板
快捷键 键盘导航
新增一门语言 多语言
多版本站点与归档横幅 多版本
标签与分类 分类体系
编辑本页、最后修改、贡献者 仓库与页面信息
打印与整章导出 打印支持
llms.txt 与每页 .md 输出 Agent 支持
某个参数的类型与默认值 配置总览

评论、分析与部署需要接入外部服务,见维护管理

主题真正会读的每一个站点参数:类型、默认值、去哪一页改。查参数从这里开始。

替换站名、Logo、favicon、主色、深浅色与字体,只需改配置与两个 SCSS 入口文件。

用一份本地 YAML 组合首页:Hero、卡片、能力面板、时间线、定价、案例、下载。任意页面也能用同一套分区做成落地页。

配置顶栏菜单与下拉、栏目切换器、面包屑、页面操作、翻页器和页脚链接。

用 type 决定一页用哪种外壳,再调侧栏宽度与图标、目录深度、栏目首页样式和页宽。

打开本地搜索,控制索引体积与结果排序,让中文查询也能命中。

一个对话框同时承担页面搜索、页面动作与站点命令:如何打开、包含哪些分组、如何添加自定义命令。

全部单键快捷键、它们何时让行给输入,以及按站点或按页面关闭的方法。

增加一种语言、并排放置译文、按语言配置菜单与界面文案,并对齐中英标题锚点。

配置版本切换菜单与归档横幅,并选择多个版本在域名上的部署布局。

用 tags / categories 给页面加一条横跨目录的索引:术语页、筛选芯片、右栏分类云与顶栏分类面板都是自动的。

把「编辑当前页面」「提交文档议题」「查阅编辑历史」接到你的仓库,并在页尾显示最后修改时间、贡献者与反馈组件。

单页交给浏览器的 Cmd/Ctrl+P,整个栏目用 print 输出格式合成一份连续文档。

每一页多产出一份 .md,站点根目录多一份 llms.txt,读者可以把当前页交给 ChatGPT 或 Claude。