跳转至

设置

Material MkDocs 提供了多种选项来自定义您的文档,在本章节中,我们将介绍如何为给网站创建有意义的结构、更改外观和感觉、添加博客和评论系统,以及构建高度优化的网站。

1. 网站结构

我们可以根据自己的喜好配置页眉和页脚、选择合适的导航模式、设置站点搜索等,进一步完善文档结构。

  • 语言


    支持 60 多种语言,并且新增语言类型

  • 导航


    创建清晰、简洁、全面的导航结构

  • 页眉


    自定义页眉以及添加公告栏

  • 页脚


    在页脚中添加个人资料或者网站链接

  • 搜索


    设置和配置搜索

  • 标签


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

2. 外观

Material MkDocs 可以轻松扩展基本配置或者改变外观,只需几行配置就能更改掉网站的颜色、字体、图标、徽标等。

  • 颜色


    使用现有调色板更改颜色或自定义 CSS 样式

  • 字体


    支持 1,000 多种 Google 字体中,或者加载你托管字体

  • Logo和图标 --- 更改 Logo,内置 8,000 多个图标,也添加新图标

  • 社交卡片


    分享链接时自动创建社交媒体预览

3. 内容

创建博客、集成评论系统、连接 git 存储库,并设置版本化的文档。

  • 博客


    设置独立博客,或者与文档一起托管

  • 评论系统


    在任何页面或页脚上添加第三方评论系统

  • 版本


    集成外部实用程序,部署多个版本

  • 仓库


    文档连接到 Git 仓库

4. 优化

基于图像自动压缩、GDPR 数据隐私法规以及离线等功能,添加站点分析并构建优化的网站。

  • Site analytics – Learn how your users experience your documentation
  • Optimized site – Create optimized sites that rank great on search engines
  • Data Privacy – Ensure compliance with data privacy regulations
  • Offline usage – Build an online and offline-capable documentation