nimbus-eth2/docs/README.md

28 lines
830 B
Markdown
Raw Permalink Normal View History

# Documentation
2021-02-15 07:33:49 +00:00
## material for mkdocs
The Nimbus guide is generated using [Material for mkdocs](https://squidfunk.github.io/mkdocs-material/), and installed using a python VENV (see Makefile).
## mdbook
Some books in this folder were produced using [mdBook](https://github.com/rust-lang/mdBook) - see installation guide.
2021-02-15 07:33:49 +00:00
```bash
# Install or update tooling (make sure you add "~/.cargo/bin" to PATH):
2023-11-10 07:40:04 +00:00
cargo install mdbook --version 0.4.35
cargo install mdbook-toc --version 0.14.1
cargo install mdbook-open-on-gh --version 2.4.1
cargo install mdbook-admonish --version 1.13.1
2021-02-15 07:33:49 +00:00
# Work on the book locally - open "http://localhost:4000" for live version
2023-11-10 07:40:04 +00:00
cd docs/the_auditors_handbook
2021-02-15 07:33:49 +00:00
mdbook serve -p 4000
# Create a local copy of the book
make book
# Publish book using makefile (in the top-level dir)
2021-02-15 07:33:49 +00:00
make publish-book
```