注释

这是 mdbook document 的非官方中文翻译版本,根据mdBook document(official) GitHub 版本 0.4.18 翻译

简介

mdBook是一个通过Markdown制作图书的命令行工具软件。它非常适合创建产品说明或API文档、教程、课程教材或任何需要清晰、易于导航和可定制的演示文稿。

  • 轻量级的Markdown语法帮助你聚焦写作
  • 集成的搜索功能支持
  • 支持多种编程语言代码块的语法高亮
  • 主题文件允许自定义输出的格式
  • 预处理能够为自定义语法和内容修改提供扩展
  • 后端可以将输出多种格式文件
  • 由高效、安全、简单的Rust语言编写
  • 自动对Rust代码示例进行测试

本指南就是由 mdBook 生成的一个示例。同时mdBook也被Rust语言项目使用,而 The Rust Programming Language 这本书也是mdBook生成的另一个很好的示例。

贡献

mdBook是免费的开源的。您可以在 GitHub找到源代码,同时您也可以将问题和功能请求发布在 GitHub issue tracker。mdBook 依靠社区来修复错误和 添加功能:如果您想做出贡献,请阅读 CONTRIBUTE 指南,并考虑是否提交一个 拉取请求

许可协议

mdBook 源代码及文档基于 Mozilla Public License v2.0发布.