2021-02-15 07:33:49 +00:00
|
|
|
The books in this folder were produced using [mdBook](https://github.com/rust-lang/mdBook) - see installation guide.
|
|
|
|
|
|
|
|
Some books also use [mdbook-toc](https://github.com/badboy/mdbook-toc) for tables of contents.
|
|
|
|
|
|
|
|
```bash
|
|
|
|
# Install or update tooling (make sure you add "~/.cargo/bin" to PATH):
|
2022-07-21 18:19:47 +00:00
|
|
|
cargo install mdbook --version 0.4.18
|
|
|
|
cargo install mdbook-toc --version 0.8.0
|
|
|
|
cargo install mdbook-open-on-gh --version 2.1.0
|
|
|
|
cargo install mdbook-admonish --version 1.7.0
|
2021-02-15 07:33:49 +00:00
|
|
|
|
|
|
|
# Work on the book locally - open "http://localhost:4000" for live version
|
|
|
|
cd docs/the_nimbus_book
|
|
|
|
mdbook serve -p 4000
|
|
|
|
|
2022-07-21 18:19:47 +00:00
|
|
|
# Create a local copy of the book
|
|
|
|
make book
|
|
|
|
|
2021-07-05 10:31:25 +00:00
|
|
|
# Publish book using makefile (in the top-level dir)
|
2021-02-15 07:33:49 +00:00
|
|
|
make publish-book
|
|
|
|
```
|