cuprate/books
hinto-janai d21160868c
books: add skeleton and docs (#141)
* update `books/`

* update CONTRIBUTING.md

* .gitignore: ignore built books

* add dummy `books/architecture/`

* remove some changes from CONTRIBUTING.md

out of scope, will be in another PR

* add docs/books to LICENSE

* formatting
2024-05-30 01:19:46 +01:00
..
architecture books: add skeleton and docs (#141) 2024-05-30 01:19:46 +01:00
protocol books: add skeleton and docs (#141) 2024-05-30 01:19:46 +01:00
README.md books: add skeleton and docs (#141) 2024-05-30 01:19:46 +01:00

Books

This directory contains the source files for Cuprate's various books.

The source files are edited here, and published in other repositories, see:

Build tools

Building the book(s) requires Rust's cargo tool and mdBook.

After installing cargo, install mdbook with:

cargo install mdbook

Building

To build a book, go into a book's directory and build:

# This build Cuprate's architecture book.
cd architecture/
mdbook build

The output will be in the book subdirectory (architecture/book for the above example). To open the book, you can open it in your web browser like so:

mdbook build --open