【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 本身进行修改,请查看贡献指南以获取更多信息。

相关推荐
琳少_1 天前
java程序开发笔记
java·开发语言·数据库·笔记
xjz18421 天前
Rust 用 `&&`、`||`、`!` 把条件组合起来
rust
Z21-X2 天前
云原生运维学习笔记:Kubernetes Volume 与 Secret 实验
运维·笔记·学习·云原生·kubernetes
一只大鸽子2 天前
游戏开发笔记7-Godot RPG游戏基础-场景切换、全局脚本
笔记·游戏·godot
不积跬步无以至千里mmbb262 天前
Rust三大核心:Trait Crate Mod详解
linux·rust
吃我一窝jio2 天前
Docker+Jenkins+K8s全流程部署
java·开发语言·笔记·python
我超膨胀der.2 天前
关于如何完整转移LABVIEW源码
笔记·labview
国科安芯2 天前
FPGA上电偶发不启动:多轨电源时序、PGOOD与并联供电的FAE排查笔记——ASP4644S2B在星载智能处理板中的工程应用分析
笔记·单片机·嵌入式硬件·fpga开发·低轨卫星·抗辐射
SomeOtherTime2 天前
第 2 讲:借用检查器(Borrow Checker)的数学本质——读写锁的编译期化、非词法生命周期(NLL)与重借用(Reborrowing)
rust