18fc658db6
Some checks failed
github pages / deploy (push) Has been cancelled
Fix broken Code the Classics link |
||
---|---|---|
.github | ||
bin | ||
design | ||
src | ||
theme | ||
.gitignore | ||
book.toml | ||
CNAME | ||
Gemfile | ||
Gemfile.lock | ||
LICENSE.md | ||
README.md |
Building Games with DragonRuby
An open-source book by Brett Chalupa and the Dragon Rider Community that walks you through how to build games with DragonRuby Game Toolkit.
Play the game you'll be building, right in the browser.
Support the creation and expansion of this book.
Developing
The book is authored and published with mdBook. Follow the installation instructions to get the mdbook
binary installed.
Run mdbook serve
to boot up the web server that handles compiling everything.
When the code is pushed to the main
branch on GitHub, an action runs that deploys it to the gh-pages
branch.
Key Versions
- DragonRuby Game Toolkit: v3.x, v4.x, v5.x
- mdBook: v0.4.22
Running Samples
The repository contains complete games for each separate code sample to ensure the code works and runs.
Code samples live in src/code
and then are organized by chapter and then sections within a chapter.
Clone this book repository into a DragonRuby GTK engine directory and run the samples with:
./dragonruby book/src/code/chapter_03/01_input
Publishing
How to make a release:
- Merge the
main
branch intooffline
- Generate a new PDF via printing in Firefox, turning off the header and footer
- Generate an HTML version of the book and zip it up
- Create zips and upload them on itch.io
- Create tags and releases for the offline branch and the main branch
The 3D cover file is generated with https://diybookcovers.com/