设置
Material for MkDocs 提供了多种自定义文档的选项。在本节中,我们将解释如何为您的站点创建一个有意义的结构,改变外观和感觉,添加博客和评论系统,并构建一个高度优化的站点。
站点结构
通过配置页眉和页脚的设置,选择多种导航模式,设置站点搜索等方式,设置和自定义文档的结构。
-
语言 - 选择超过 60 种支持的语言之一或添加新语言
-
导航 - 创建一个清晰、简明和全面的导航结构
-
页眉 - 自定义页眉的行为,添加公告栏
-
页脚 - 在页脚中添加到您的社交媒体资料或网站的链接
-
搜索 - 设置和配置搜索功能,在用户的浏览器中完全运行
-
标签 - 使用标签对页面进行分类和分组
外观
通过几行配置,与品牌的颜色、字体、图标、徽标等相匹配 - Material for MkDocs 可以轻松扩展基本配置或更改外观。
- 颜色 - 使用现有的颜色调色板更改颜色或使用 CSS 进行自定义
- 字体 - 从 1000 多种 Google 字体中选择或加载自托管字体
- 徽标和图标 - 更改徽标,使用 8000 多个图标之一,或添加新图标
- 社交卡片 - 在分享链接时自动生成社交媒体预览
内容
创建博客,集成评论系统,连接 git 仓库,并设置与项目版本控制方法相匹配的版本化文档。
优化
通过添加自动图片压缩、符合 GDPR 数据隐私法规和使其支持离线访问,添加站点分析和构建优化站点。