What is this?
This one tracks the state of the ecosystem for Game Development in Rust.
Navigate to whichever folder in
/contentbest fits your project.
Edit that folder's
data.tomlfile in any plain text editor or straight through GitHub's editor.
Create a new entry, following the schema described below. Note that all entries should be sorted alphabetically by the
namefield, ignoring case. There is a CI check to ensure this is done correctly - you can use the
sort_data.pyscript to automatically fix a file.
All done! We do greatly appreciate PRs, but if you're not comfortable with this process, you're welcome to open an issue requesting the addition of your project instead.
[[items]] # The name of the item. Mandatory. name = "My crate" # A short description of the item. Optional, but recommended. description = "My extremely cool Rust crate" # The categories that your item should be assigned to. Mandatory. categories = ["2drendering", "engines"] # An image representing the item. Files should be checked in to # /static/assets/img/, and the path should be absolute. # Optional, but highly recommended for games!. image = "/assets/img/logo.png" # A link to the item's page on Crates.io. Optional. crate_url = "https://crates.io/crates/mycrate" # A link to the item's VCS repository. Optional. repository_url = "https://github.com/username/repo" # A link to the item's homepage. Optional. homepage_url = "https://mycrate.com" # A link to the item's Gitter chat. Optional. gitter_url = "https://gitter.im/mycrate"
You can also tell the site to pull data directly from an external source:
[[items]] # Pull data from Crates.io: name = "mycratename" source = "crates" categories = ["mycategory"] [[items]] # Pull data from GitHub: name = "username/repo" source = "github" categories = ["mycategory"]
Extra keys can be added to items that are pulled from external data (e.g. to add a homepage URL, or override some of the fetched data).
Enhance this website
If you're comfortable with semantic-ui and Zola please reach out to us in the Issues with your enhancement ideas or just to state your willingness to contribute.
It's very likely there are mistakes around, if you find one please file an issue.
Thanks for helping us map the Rust game development ecosystem!