Introduction

全文字数：290

阅读时间：1 minute

本书使用mdbook构建，托管于github.io，以WSL环境为例，记录一下构建过程。

安装

安装WSL

略

打开WSL

安装Rust

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

验证安装是否成功：

rustc --version

安装mdbook

cargo install mdbook

构建并运行

创建mdbook项目

mdbook init paper

• 是否需要.gitignore文件：y
• 输入项目名称：paper_reading（后续可在book.toml中更改）

构建mdbook

在/paper目录下执行：

• 构建项目：

mdbook build

• 或是在浏览器中实时预览：

mdbook serve

部署

1. 新建Github仓库，将项目上传至仓库。
2. 在顶栏目录中找到Actions，搜索mdbook，点击Configure，自动生成.yml文件。点击Commit Changes提交。
3. 在顶栏目录中找到Settings，在侧边栏中找到Pages，在Build and deployment下找到Source，选择Github Actions。
4. 第二步会在/paper下创建./.github/workflows/mdbook.yml文件，在本地pull更改。
5. 之后本地修改内容后push到仓库，Github Actions会自动构建并部署。访问https://<username>.github.io/<reponame>/即可查看。

参考

• 安装Rust
• mdbook文档