【mdBook】1 安装

有多种方式可以安装 mdBook CLI 工具。请选择以下任一适合您需求的方法。如果您是为了自动部署而安装 mdBook,请查看持续集成章节以获取更多安装示例。

预编译二进制文件

可在 GitHub Releases 页面下载可执行的二进制文件。下载适用于您平台(Windows、macOS 或 Linux)的二进制文件并解压存档。存档包含一个 mdbook 可执行文件,您可以运行它来构建您的书籍。

为了更方便地运行,请将二进制文件所在路径添加到您的 PATH 环境变量中。

使用 Rust 从源码构建

要从源码构建 mdbook 可执行文件,您首先需要安装 Rust 和 Cargo。请按照 Rust 安装页面上的说明进行操作。mdBook 目前至少需要 Rust 1.82 版本。

安装完 Rust 后,可以使用以下命令来构建和安装 mdBook:

bash 复制代码
cargo install mdbook

这将自动从 crates.io 下载 mdBook,进行构建,并将其安装到 Cargo 的全局二进制目录(默认为 ~/.cargo/bin/)。

当您想更新到新版本时,可以再次运行 cargo install mdbook。该命令将检查是否有更新的版本,并在找到新版本时重新安装 mdBook。

要卸载,请运行命令 cargo uninstall mdbook

安装最新的主版本(master)

发布到 crates.io 的版本可能会略微落后于 GitHub 上托管的版本。如果您需要最新版本,可以自行构建 mdBook 的 git 版本。Cargo 使这变得非常容易!

bash 复制代码
cargo install --git https://github.com/rust-lang/mdBook.git mdbook

同样,请确保将 Cargo 的二进制目录添加到您的 PATH 环境变量中。

修改与贡献

如果您有兴趣对 mdBook 本身进行修改,请查看贡献指南以获取更多信息。

相关推荐
昕光xg3 小时前
Istio笔记04-基于Jaeger的分布式链路追踪
笔记·分布式·istio
学计算机的计算基4 小时前
操作系统内存管理全解:虚拟内存、页表、COW、malloc、OOM一篇搞定
java·笔记·算法
AOwhisky4 小时前
Python 学习笔记(第五期)——组合数据类型:列表、元组、集合与字典精讲——核心知识点自测与详解
开发语言·笔记·python·学习·云计算
砚凝霜4 小时前
软考网络工程师|第 2 章 信道延迟、传输介质、数据编码、数字调制、PCM 完整备考笔记
网络·笔记·pcm
程序员爱钓鱼4 小时前
Rust String 与 &str 详解:字符串所有权、借用与转换
前端·后端·rust
段一凡-华北理工大学16 小时前
向量数据库实战:选型、调优与落地~系列文章12:文本分块策略实战:chunk_size 怎么选?重叠多少?
开发语言·数据库·后端·oracle·rust·工业智能体·高炉智能化
遇乐的果园17 小时前
前端学习笔记-vue加载渲染优化
前端·笔记·学习
遇乐的果园18 小时前
前端学习笔记-vue状态管理优化
前端·笔记·学习
摇滚侠19 小时前
Java 全栈开发实战教程 课程笔记 29-33
笔记
茯苓gao19 小时前
嵌入式开发笔记:EtherCAT协议从硬件到软件完整配置指南——从零搭建一套EtherCAT通信系统
笔记·嵌入式硬件·学习