nannou-org / guide

A guide for nannou, including "Getting Started", "Tutorials" and more.

Home Page:https://guide.nannou.cc

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

NOTICE: the guide has been moved here.


the nannou guide Build Status

The one-stop-shop for everything someone might want to know about nannou!

Working on the Book

The easiest way to build, render and read the book is as follows:

  • Clone the repo.
    git clone https://github.com/nannou-org/guide
    cd guide
  • Install the Rust markdown book tool.
    cargo install mdbook
    
  • Make mdbook watch the repo, re-build on file changes and host at localhost:3000.
    mdbook serve
    
  • Open your browser and point it to localhost:3000 to find the rendered markdown book.

You should now have a hot-loading environment where you can edit the book markdown and see the results rendered in your browser each time you save a file.

Running Tests

To run the tests, do the following:

cd book-tests
cargo test

The build.rs will retrieve all rust code snippets from the markdown files and generate a test file so that they all may be tested during cargo test.

We do this rather than using the mdbook test as mdbook test does not support including remote dependencies.

License

Licensed under either of

at your option.

Contributions

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

About

A guide for nannou, including "Getting Started", "Tutorials" and more.

https://guide.nannou.cc

License:Other


Languages

Language:Rust 70.7%Language:Shell 29.3%