GitHub - godot-rust/book: Documentation and tutorials for gdext, the Rust bindings for Godot 4 (original) (raw)
The godot-rust book
The godot-rust book is a user guide for gdext, the Rust bindings to Godot 4. It covers a large part of the concepts and complements the API docs. There is also gdnative-book for Godot 3.
Local setup
The book is built with mdBook and the plugins mdbook-toc and mdbook-admonish. To install them and build the book locally, you can run:
cargo install mdbook mdbook-toc mdbook-admonish mdbook build
To run a local server with automatic updates while editing the book, use:
Formatting and linting
markdownlint enforces a consistent style across the Markdown files. It is automatically run during CI, but if you have the npm
toolchain, you can also run it locally:
npm install --global markdownlint-cli2 ./lint.sh
To fix certain errors directly:
./lint.sh fix
Oxipng
We use oxipng to optimize image file size. You can install it with cargo install oxipng
and then run it as follows:
oxipng --strip safe --alpha -r src
Contributing
This repository is for documentation only. For changes in the library itself, please open pull requests and issues in the main repo, and read the contributing guidelines.
License
Like gdext itself, the gdext book is licensed under MPL 2.0.