MariaDB 服务器文档（PDF 版）

MariaDB 服务器文档现已发布为单个 PDF 文件，可离线浏览。下载这 3000 多页的内容并查看吧！

迟到总比不到好

有些事情需要很长时间！2014 年，Jira 上有一个请求，要求将 MariaDB Server 知识库作为一个 PDF 文件发布。这已经是七年多以前的事了。MDEV-6881，你已经从编号中看出来了——我们现在已经远远超过 MDEV-28000 了。

这个请求一直萦绕在我们脑海中。这次实现它是因为摆弄 Python 以及将一种格式转换为另一种格式（包括 PDF）的相对便捷性。

使用场景

不，我们不指望你会打印出来。但我们确实认为拥有一个包含所有 MariaDB Server 文档的单个 PDF 文件会带来很多好处。

1. 你可以离线使用它。当网络连接不好时。或者当你故意关闭互联网以提高工作效率时。
2. 你可以用它来获取概览。很可能你只使用了其中一部分对你有益的功能。阅读目录，你就会对你错过的东西有个大致了解。
3. 你可以把它当成“富有成效的消遣”。卡在某个地方等待，只有手机或平板电脑在手？学习一些新的 MariaDB 功能，而不是无休止地浏览或在 Instagram 上羡慕别人。

我们确信还有其他使用 PDF 的理由。当你觉得它有用时，请告诉我们！

入门指南

我们有几个建议。

1. 下载它，地址是 mariadb.org/mariadbserverpdf/。
2. 将它保存在你的笔记本电脑上，以便找到。我把它放在 Documents/mariadb/manual/ 目录中。
3. 将它保存在你的手机上。我在我的 kajPhone 上使用原生图书应用。
4. 阅读目前位于第 6 页的单页目录。它向你展示了本书的结构。
5. 阅读第 3-5 页的前言。它向你介绍本书的“前史”、结构和格式。它描述了当前的初版。它告诉你如何就手册向我们提供反馈；我们期望今年几乎每月都会推出新版本。它还包含致谢，感谢那些让本书成为可能的人。
6. 阅读从第 7 页开始的完整 38 页目录。是的，阅读它会花很长时间，但当你读完后，你可能已经对你一直错过的东西以及你之前不知道但可能想尝试的功能有了一个很好的了解。
7. 继续，开始使用它吧，别忘了使用搜索功能。
8. 定期回来获取更新。我们不断更新知识库，并定期构建新的 PDF 版本。不要无意中使用旧版本。

提供反馈

我们想听取个人用户的意见。在会议上，利用讲座间隙在走廊里交流时，提出开放性问题很容易，而且对双方都感觉富有成效。

在线上复制同样的富有成效的讨论要困难得多。它需要双方的努力。这感觉就像工作。

我们仍在寻找您向我们提供有意义反馈的最佳方式。欢迎通过 Zulip (https://mariadb.zulipchat.com/ – Documentation 主题) 联系我们。发送电子邮件至 foundation@mariadb.org 也能送达我们。

当您发现具体的错误时，请按照知识库文章 https://mariadb.com/kb/en/reporting-documentation-bugs/ 中提到的指南将其提交到 Jira。

致谢

这本书的完成要感谢很多人。在此博客中，我仅感谢其中两位——担任编辑的 Ian Gilfillan 和根据知识库创建 PDF 的开发者、他的儿子 Dorje Gilfillan。书中列有其他所有为此书做出贡献的人员的长名单。我想，下载并试用这本书会让他们感到高兴！