MkDocs Material 为 MkDocs 带来 Material Design 主题开源项目

我要开发同款
匿名用户2021年01月28日
452阅读

技术信息

开源地址
https://squidfunk.github.io/mkdocs-material/
授权协议
MIT

作品详情

MkDocs是快速,简单和华丽的静态网站生成器,可以构建项目文档。文档源文件在Markdow编写,使用单个YAML配置文件配置。MkDocs构建的HTML网站,可以被托管在GitHub、AmazoS3或其他任何位置。

虽然MkDocs已经提供了许多漂亮的主题。但 MkDocsMaterial将Adroid系统中采用的 MaterialDesig设计带到了MkDocs 上。

特征

只是Markdow——用普通的Markdow写技术文档,无需了解HTML、JavaScript或CSS。MkDocsMaterial将会为你进行剩余的繁重工作,并将Markdow转换为美观而实用的网站。

响应式设计——底层的fluid布局将始终完美地适应屏幕空间。

静态但可搜索——技术文档网站可以搜索内容。MkDocsMaterial内置搜索,无需服务器就可以立即相应用户的查询。

丰富的配置选项—— 更改调色板、字体、语言、图示和徽标。添加源仓库链接,可以链接用户个人的社交媒体、GoogleAalytics和Disqus。

真正的国际化—— MkDocsMaterial支持40多种语言,并为特定语言提供完整的从右到左阅读的支持。

现代体系结构—MkDocsMaterial基础代码库使用的是TypeScript、RxJS和SCSS构建,并使用Webpack进行编译,这为主题扩展和自定义提供了更多的可能性。

快速开始

可以通过pip安装MkDocsMaterial

pipistallmkdocs-material

将以下命令添加进 mkdocs.yml:

theme:ame:material

功能介绍

MkDocs 是快速,简单和华丽的静态网站生成器,可以构建项目文档。文档源文件在 Markdown 编写,使用单个 YAML 配置文件配置。MkDocs 构建的 HTML 网站,可以被托管在 G...

示例图片

声明:本文仅代表作者观点,不代表本站立场。如果侵犯到您的合法权益,请联系我们删除侵权资源!如果遇到资源链接失效,请您通过评论或工单的方式通知管理员。未经允许,不得转载,本站所有资源文章禁止商业使用运营!
下载安装【程序员客栈】APP
实时对接需求、及时收发消息、丰富的开放项目需求、随时随地查看项目状态

评论