Skip to content

设置

Material for MkDocs 提供了多种自定义文档的选项。在本节中,我们将解释如何为您的站点创建一个有意义的结构,改变外观和感觉,添加博客和评论系统,并构建一个高度优化的站点。

站点结构

通过配置页眉和页脚的设置,选择多种导航模式,设置站点搜索等方式,设置和自定义文档的结构。

  • 语言 - 选择超过 60 种支持的语言之一或添加新语言

  • 导航 - 创建一个清晰、简明和全面的导航结构

  • 页眉 - 自定义页眉的行为,添加公告栏

  • 页脚 - 在页脚中添加到您的社交媒体资料或网站的链接

  • 搜索 - 设置和配置搜索功能,在用户的浏览器中完全运行

  • 标签 - 使用标签对页面进行分类和分组

外观

通过几行配置,与品牌的颜色、字体、图标、徽标等相匹配 - Material for MkDocs 可以轻松扩展基本配置或更改外观。

  • 颜色 - 使用现有的颜色调色板更改颜色或使用 CSS 进行自定义
  • 字体 - 从 1000 多种 Google 字体中选择或加载自托管字体
  • 徽标和图标 - 更改徽标,使用 8000 多个图标之一,或添加新图标
  • 社交卡片 - 在分享链接时自动生成社交媒体预览

内容

创建博客,集成评论系统,连接 git 仓库,并设置与项目版本控制方法相匹配的版本化文档。

  • 博客 - 设置一个独立的博客或将其与您的文档一起托管
  • 评论系统 - 在任何页面或页脚上添加第三方评论系统
  • 版本化 - 通过与外部工具集成,部署多个版本
  • 仓库 - 将您的文档连接到您的 git 仓库

优化

通过添加自动图片压缩、符合 GDPR 数据隐私法规和使其支持离线访问,添加站点分析和构建优化站点。