Skip to content

设置

Material for MkDocs 提供了广泛的选项来定制您的文档。在本节中，我们将解释如何为您的网站创建有意义的结构，改变外观和感觉，添加博客和评论系统，以及构建一个高度优化的网站。

网站结构

通过配置头部和底部来设置和定制您的文档结构，选择多种导航模式，设置网站搜索等。

  • Language – 从 60 多种支持的语言中选择或添加一种新语言
  • Navigation – 创建清晰、简洁和全面的导航结构
  • Header – 自定义头部的行为，添加公告栏
  • Footer – 在底部添加社交媒体资料或网站的链接
  • Search – 设置和配置搜索，完全在用户的浏览器中运行
  • Tags – 用标签对页面进行分类并分组相关页面

外观

通过几行配置，使您的品牌颜色、字体、图标、徽标等相匹配 – Material for MkDocs 使扩展基本配置或更改外观变得简单。

  • Colors – 使用现有的调色板更改颜色或使用 CSS 自定义
  • Fonts – 从 1,000 种 Google 字体中选择或加载自托管字体
  • Logo & Icons – 更改徽标，使用 8,000 多种图标中的任何一种，或添加新的图标
  • Social Cards – 在共享链接时自动创建社交媒体预览

内容

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

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

优化

添加网站分析并通过添加自动图像压缩、遵守 GDPR 数据隐私法规以及使其具备离线能力来构建一个优化的网站。