fvilers / gb-asm-tutorial

Learn to create games for the Game Boy using Assembly

Home Page:http://gbdev.io/gb-asm-tutorial/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

GB ASM tutorial (v2)

Re-doing GB ASM Tutorial, and this time, until the end.

Translating

To help translate the tutorial, join the project on Crowdin.

Contributing

Contributing is really easy, fork this repo and edit the files in the src directory. Then, you can send your PR.

To deploy gb-asm-tutorial locally:

  1. Install Rust and mdBook. mdBook powers the book itself, Rust is used for some custom plugins.
$ cargo install mdbook
  1. Within a terminal pointed at the directory book.toml is in, run mdBook (mdbook build / mdbook watch / mdbook serve).
  2. The HTML files are in book/custom/.

⚠️ book/html/ contains only partially processed files. This folder is what gets served when running mdbook serve, so you may see some custom markup missing if using that. As a workaround, you can manually open the files in the book/custom/ folder in your browser, they just won't auto-refresh on changes.

License

Different parts of gb-asm-tutorial are subject to different licenses:

  • All the code contained within the tutorial itself is licensed under CC0. To the extent possible under law, all copyright and related or neighboring rights to code presented within GB ASM Tutorial have been waived. This work is published from France.
  • The contents (prose, images, etc.) of this tutorial are licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.
  • Code used to display and format the site is licensed under the MIT License unless otherwise specified.
  • The code related to the i18n support is originally from Google's Comprehensive Rust and is released under the Apache License 2.0.

About

Learn to create games for the Game Boy using Assembly

http://gbdev.io/gb-asm-tutorial/

License:MIT License


Languages

Language:Assembly 68.0%Language:Rust 13.1%Language:JavaScript 9.8%Language:Handlebars 5.6%Language:CSS 1.8%Language:Makefile 1.2%Language:C 0.5%