跳转至

General

为MkDocs转换材料

我们正在开发一套令人惊叹的功能,这需要一些幕后工作,我们现在准备在一系列帖子中分享。在这里,我们概述了我们的目标、正在开发的功能、让我们彻夜难眠的事情以及我们对开源的承诺。

我们知道,自上次更新以来已经有一段时间了,这就是为什么我们渴望与您分享Material for MkDocs内部和周围发生的事情。在2024年的大部分时间里,我们一直专注于改造MkDocs材料的核心,为最常被要求的新的、相互关联的功能奠定基础。

本文是系列文章中的第一篇,我们将探讨如何通过改进信息检索来支持用户,为多语言网站和版本控制提供更好的支持,以及改善整体创作体验。我们概述了我们对项目发展的愿景,并描述了我们一直在做的工作。在这篇和接下来的博客文章中,我们将与您分享我们的进展,我们很高兴听到您的想法。

Adding a badge to your project

你喜欢使用MkDocs的Material吗?分享爱!您现在可以添加 项目README的徽章,显示您的项目是用 MkDocs的材料。

MkDocs徽标的材料刚刚添加到Simple Icons中,该图标由 Shields.io在徽章中包含徽标。我们为您生成了一个徽章 您可以添加到项目的README中:

Material for MkDocs

Sunsetting Gitter:迈向高效的社区参与

当我们开始围绕MkDocs的Material组建一个团队时,我们决定 日落,并于2023年10月13日存档我们的Gitter频道,以支持 [GitHub讨论]。

作为我们努力改进材料维护流程的一部分 为了支持社区,我们审查了不同文档的使用情况 沟通渠道。目前,Gitter和[GitHub讨论] 允许向社区寻求支持,讨论想法和问题。在the 过去几周,我们开始质疑这种重复是否是最好的 我们项目的兴趣。这篇文章解释了我们决定背后的基本原理。

过去、现在和未来

2021年对这个项目来说是美好的一年,因为我们推出了许多新的、令人惊叹的产品 功能,用户增长显著,并利用GitHub赞助商使 项目可持续。

今天,MkDocs和MkDocs材料是最受欢迎的 为您的网站选择静态站点生成器和主题时的选项 技术文档项目。MkDocs的材料确保您 无论屏幕如何,内容总是完美地呈现给观众 分辨率或设备性能。它已经发展成为一个技术框架 写作,提供许多功能,其中一些功能在其他网站上尚未发现 静态站点生成器。然而,我们还远未结束,因为2022年即将到来 带来一些有趣的新功能。