# 自定义

> 如何自定义你的 htmlpress 项目。

Htmlpress 提供了少量钩子，用于调整站点的外观、内容，以及文件在构建中的流转方式。每个方面都有单独的页面介绍。

## 主题

### [配置](/zh/customization/configuration-file/)

`htmlpress.yaml` 基础：用于筛选内容的 `include`/`exclude` glob 模式。

### [站点元数据](/zh/customization/site-metadata/)

站点标题、描述、规范 URL、Logo 和 favicon。

### [文章分区](/zh/customization/article-sections/)

在侧边栏中把一个文件夹的页面归到它的索引页之下。

### [文章补丁](/zh/customization/article-patches/)

通过配置覆盖页面的元数据，无需编辑文件本身。

### [外部链接](/zh/customization/external-links/)

在页眉或侧边栏中添加外部链接。

### [语法主题](/zh/customization/syntax-themes/)

代码块的浅色与深色主题。

### [自定义路由](/zh/customization/custom-routes/)

使用 `.htmlpress/layouts/` 中的布局，为页面提供独立的外观框架。

### [翻译](/zh/customization/translations/)

以多种语言发布站点，带有语言选择器和回退机制。

### [版本管理](/zh/customization/versioning/)

为多个发布版本提供文档，每个版本一个分区或一次部署。

### [覆盖/弹出](/zh/customization/overriding-escaping/)

通过 `.htmlpress/` 替换任何内置的布局、样式表、脚本或组件。

### [AI 智能体](/zh/customization/ai-agents/)

面向 AI 智能体的 Markdown 副本、`llms.txt`、内容信号和智能体技能。

### [插件](/zh/customization/plugins/)

把 textlane 的 Markdown 与 HTML 插件加入页面流水线。