2022-04-08 09:44:50 -05:00
|
|
|
Juniper Book
|
|
|
|
============
|
|
|
|
|
|
|
|
Book containing the [`juniper`](https://docs.rs/juniper) user guide.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Contributing
|
|
|
|
|
|
|
|
|
|
|
|
### Requirements
|
|
|
|
|
|
|
|
The Book is built with [mdBook](https://github.com/rust-lang/mdBook).
|
|
|
|
|
|
|
|
You may install it with:
|
|
|
|
```bash
|
|
|
|
cargo install mdbook
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
### Local test server
|
|
|
|
|
|
|
|
To launch a local test server that continually re-builds the Book and auto-reloads the page, run:
|
|
|
|
```bash
|
|
|
|
mdbook serve
|
|
|
|
|
|
|
|
# or from project root dir:
|
|
|
|
make book.serve
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
### Building
|
|
|
|
|
|
|
|
You may build the Book to rendered HTML with this command:
|
|
|
|
```bash
|
|
|
|
mdbook build
|
|
|
|
|
|
|
|
# or from project root dir:
|
|
|
|
make book
|
|
|
|
```
|
|
|
|
|
|
|
|
The output will be in the `_rendered/` directory.
|
|
|
|
|
|
|
|
|
|
|
|
### Testing
|
|
|
|
|
|
|
|
To run the tests validating all code examples in the book, run:
|
|
|
|
```bash
|
2022-07-20 05:37:58 -05:00
|
|
|
mdbook test -L ../target/debug/deps
|
2022-04-08 09:44:50 -05:00
|
|
|
|
|
|
|
# or via shortcut from project root dir:
|
|
|
|
make test.book
|
|
|
|
```
|