-
Notifications
You must be signed in to change notification settings - Fork 11
documents sort #83
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Open
seventhback777
wants to merge
10
commits into
thoth-tech:main
Choose a base branch
from
seventhback777:docs/arcrade-consolidation
base: main
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Open
documents sort #83
Changes from all commits
Commits
Show all changes
10 commits
Select commit
Hold shift + click to select a range
261fd1a
docs: 整合 Arcade 的所有说明文档
seventhback777 bc61786
Create Readme.md
RUNQILIU-123 9188f12
Merge pull request #1 from RUNQILIU-123/docs/arcrade-consolidation
seventhback777 585433b
update Readme.md
ZGT23 3a08377
Updated pre-requisites wording based on review suggestion
seventhback777 7e92e59
Merge branch 'docs/arcrade-consolidation' of https://github.com/seven…
seventhback777 96f8aae
Fixed CONTRIBUTING.md link path in README
seventhback777 92a3f7b
Updated pre-requisites wording based on review suggestion
seventhback777 a970080
Updated pre-requisites wording based on review suggestion
seventhback777 e45e6b8
Fix CONTRIBUTING.md link in docs/main/README.md
seventhback777 File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| contributors:Haoyu Liu,Runqi Liu.Wei Zhang | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,32 @@ | ||
| # arcade-machine | ||
| An application to showcase and execute Splashkit games | ||
|
|
||
| ## Pre-requisites (all operating systems) | ||
|
|
||
| + Install the [SplashKit](https://splashkit.io) SDK using the [guide](https://splashkit.io/articles/installation/) | ||
|
|
||
| ## Pre-requisites (Windows with mingw32 or mingw64) | ||
|
|
||
|
|
||
| + Install `make` using `pacman -S make` | ||
|
|
||
| ## Building arcade machine (using the Makefile) | ||
| Compiling Arcade Machine using the Makefile allows incremental building of changed objects. | ||
|
|
||
| ```bash | ||
| cd arcade-machine | ||
| make | ||
| ./ArcadeMachine | ||
| ``` | ||
| Subsequent builds (as you change code) can be completed by using just `make`. If you need to run a clean build again, you can use `make clean` first proceeded by `make`. | ||
|
|
||
| ## Building arcade machine (manually) | ||
| + Compile the application with the command ```skm clang++ src/* -Iinclude -lstdc++fs -o test``` | ||
| + Run the application ```./test``` | ||
|
|
||
| ## Contributing code and running the code formatter | ||
| Have a read of [CONTRIBUTING.md](../../../CONTRIBUTING.md) to see the general code style conventions followed throughout the project. | ||
|
|
||
| Automatic code formatting is supported using `clang-format` (you may need to install this if you want to use it). | ||
|
|
||
| To run the code formatter on the whole project, execute `make format`. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| You can place bundle scripts in this folder. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| SplashKit can create SQLite databases for you, they will appear in this folder. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| You can place fonts in this folder. Fonts can be otf or ttf files. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| Place images in this folder. SplashKit can work with png, jpeg, jpg, or tif files. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| You can place files in this folder for the webserver to return. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| You can place sound effects in this folder. SplashKit can play ogg, wav, mod, flac, and mp3 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,7 @@ | ||
| # arcade-machine | ||
| An application to showcase and execute Splashkit games | ||
| ## Install | ||
| + Install the [SplashKit](https://splashkit.io) SDK using the [guide](https://splashkit.io/articles/installation/) | ||
| ## Run | ||
| + Compile the application with the command ```skm clang++ program.cpp -o test -lstdc++fs``` | ||
| + Run the application ```./test``` |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| You can place bundle scripts in this folder. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| SplashKit can create SQLite databases for you, they will appear in this folder. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| You can place fonts in this folder. Fonts can be otf or ttf files. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| Place images in this folder. SplashKit can work with png, jpeg, jpg, or tif files. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| You can place files in this folder for the webserver to return. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| You can place sound effects in this folder. SplashKit can play ogg, wav, mod, flac, and mp3 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,7 @@ | ||
| # arcade-machine | ||
| An application to showcase and execute Splashkit games | ||
| ## Install | ||
| + Install the [SplashKit](https://splashkit.io) SDK using the [guide](https://splashkit.io/articles/installation/) | ||
| ## Run | ||
| + Compile the application with the command ```skm clang++ program.cpp -o test -lstdc++fs``` | ||
| + Run the application ```./test``` |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,3 @@ | ||
| You can place scripts for animations in this folder. | ||
|
|
||
| See http://www.splashkit.io/articles/guides/tags/animations/animation/ |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| You can place bundle scripts in this folder. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,38 @@ | ||
| #-- ARCADE MACHINE GAME CONFIG FILE --# | ||
| #-- For THOTH TECH - Splashkit Crew - Applications Team | ||
| #-------------------------------------------------------------------- | ||
| #-- File: config.txt | ||
| #-- Description: Configuration data for Arcade Machine games | ||
| #-------------------------------------------------------------------- | ||
| #-- Maintenance Log -- | ||
| #-------------------------------------------------------------------- | ||
| # Task | Who | Date | Comments | ||
| #-----------+---------+----------+----------------------------------- | ||
| # Sprint 1 | AGEORGE | 26032022 | Created | ||
| #-----------+---------+----------+----------------------------------- | ||
|
|
||
| # PLEASE ONLY EDIT CONTENT AFTER THE "=" SIGN FOR EACH CONFIGURATION SETTING | ||
|
|
||
| # Location of git repo (eg. https://github.com/studioant/arcade_game) | ||
| repository=https://github.com/studioant/gameOfNim.git | ||
|
|
||
| # Programmnig language the game is written in (eg. C++) | ||
| language=C++ | ||
|
|
||
| # Path to your game thumbnail image (eg. images/icon.png) | ||
| image=images/icon.png | ||
|
|
||
| # The title of your game (eg. Super Mario) | ||
| title=Game Of Nim | ||
|
|
||
| # The genre of your game (eg. Platformer) | ||
| genre=Board Game | ||
|
|
||
| # A classification rating to advise the nature of the content (eg. MA 15+) | ||
| rating=G | ||
|
|
||
| # The name of the author (eg. Jane Doe) | ||
| author=Anthony George | ||
|
|
||
| # Path to the executable (game.exe) | ||
| executable=nim.exe |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,38 @@ | ||
| #-- ARCADE MACHINE GAME CONFIG FILE --# | ||
| #-- For THOTH TECH - Splashkit Crew - Applications Team | ||
| #-------------------------------------------------------------------- | ||
| #-- File: config.txt | ||
| #-- Description: Configuration data for Arcade Machine games | ||
| #-------------------------------------------------------------------- | ||
| #-- Maintenance Log -- | ||
| #-------------------------------------------------------------------- | ||
| # Task | Who | Date | Comments | ||
| #-----------+---------+----------+----------------------------------- | ||
| # Sprint 1 | AGEORGE | 26032022 | Created | ||
| #-----------+---------+----------+----------------------------------- | ||
|
|
||
| # PLEASE ONLY EDIT CONTENT AFTER THE "=" SIGN FOR EACH CONFIGURATION SETTING | ||
|
|
||
| # Location of git repo (eg. https://github.com/studioant/arcade_game) | ||
| repository=https://github.com/thoth-tech/arcade-games | ||
|
|
||
| # Programmnig language the game is written in (eg. C++) | ||
| language=C# | ||
|
|
||
| # Path to your game thumbnail image (eg. images/icon.png) | ||
| image=images/icon.jpg | ||
|
|
||
| # The title of your game (eg. Super Mario) | ||
| title=Game 1 | ||
|
|
||
| # The genre of your game (eg. Platformer) | ||
| genre=Tile Based | ||
|
|
||
| # A classification rating to advise the nature of the content (eg. MA 15+) | ||
| rating=PG | ||
|
|
||
| # The name of the author (eg. Jane Doe) | ||
| author=Foo Bar | ||
|
|
||
| # Path to the executable (game.exe) | ||
| executable=game1.exe |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| SplashKit can create SQLite databases for you, they will appear in this folder. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| You can place fonts in this folder. Fonts can be otf or ttf files. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| Place images in this folder. SplashKit can work with png, jpeg, jpg, or tif files. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| You can place files in this folder for the webserver to return. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| You can place sound effects in this folder. SplashKit can play ogg, wav, mod, flac, and mp3 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,41 @@ | ||
| # Contributing | ||
|
|
||
| Contributing to the Arcade Machine code | ||
|
|
||
| ## Code Style/Naming Guidelines | ||
|
|
||
| ### Naming | ||
|
|
||
| - User-defined types (classes, structs) should use pascal case, e.g. `MyClass` | ||
| - Functions and variables should use camel case, e.g. `myFuction()`, `myVariable` | ||
| - Constants and #defines should be all uppercase with underscores denoting spaces, e.g. `MY_CONSTANT` | ||
| - Private data should be prefixed with `m_` for "member", e.g. `m_myPrivateVariable` | ||
|
|
||
| ### File names | ||
|
|
||
| - Each class should be declared in a header file named exactly after the class, e.g. `MyClass` is declared in MyClass.h | ||
| - Class declaration should stay in the .h file, definitions should be in a .cpp file, e.g. `MyClass` is defined in MyClass.cpp | ||
| - Only #include what is needed | ||
| - Use "" for including local files and <> for including library files | ||
|
|
||
| #### Namespaces | ||
| Don't use `using`, e.g. instead of: | ||
|
|
||
| ```cpp | ||
| using std | ||
| using std::vector | ||
|
|
||
| vector<Button> buttons | ||
| ``` | ||
|
|
||
| do this instead | ||
|
|
||
| ```cpp | ||
| #include <vector> | ||
|
|
||
| std::vector<Button> buttons | ||
| ``` | ||
|
|
||
| ### clang-format | ||
|
|
||
| Investigate use of clang-format to automate style checks |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,26 @@ | ||
| # arcade-machine | ||
| An application to showcase and execute Splashkit games | ||
|
|
||
| ## Pre-requisites (all operating systems) | ||
|
|
||
| + Install the [SplashKit](https://splashkit.io) SDK using the [guide](https://splashkit.io/articles/installation/) | ||
|
|
||
| ## Pre-requisites (Windows with mingw32 or mingw64) | ||
|
|
||
|
|
||
| + Install `make` using `pacman -S make` | ||
|
|
||
| ## Building arcade machine (using the Makefile) | ||
| Compiling Arcade Machine using the Makefile allows incremental building of changed objects. | ||
|
|
||
| ```bash | ||
| cd arcade-machine | ||
| make | ||
| ./ArcadeMachine | ||
| ``` | ||
|
|
||
| Subsequent builds (as you change code) can be completed by using just `make`. If you need to run a clean build again, you can use `make clean` first proceeded by `make`. | ||
|
|
||
| ## Building arcade machine (manually) | ||
| + Compile the application with the command ```skm clang++ src/* -Iinclude -lstdc++fs -o test``` | ||
| + Run the application ```./test``` |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| You can place bundle scripts in this folder. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| SplashKit can create SQLite databases for you, they will appear in this folder. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| You can place fonts in this folder. Fonts can be otf or ttf files. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| Place images in this folder. SplashKit can work with png, jpeg, jpg, or tif files. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| You can place files in this folder for the webserver to return. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| You can place sound effects in this folder. SplashKit can play ogg, wav, mod, flac, and mp3 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,7 @@ | ||
| # arcade-machine | ||
| An application to showcase and execute Splashkit games | ||
| ## Install | ||
| + Install the [SplashKit](https://splashkit.io) SDK using the [guide](https://splashkit.io/articles/installation/) | ||
| ## Run | ||
| + Compile the application with the command ```skm clang++ program.cpp -o test -lstdc++fs``` | ||
| + Run the application ```./test``` |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| You can place bundle scripts in this folder. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| SplashKit can create SQLite databases for you, they will appear in this folder. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| You can place fonts in this folder. Fonts can be otf or ttf files. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| Place images in this folder. SplashKit can work with png, jpeg, jpg, or tif files. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| You can place files in this folder for the webserver to return. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| You can place sound effects in this folder. SplashKit can play ogg, wav, mod, flac, and mp3 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,41 @@ | ||
| # Contributing | ||
|
|
||
| Contributing to the Arcade Machine code | ||
|
|
||
| ## Code Style/Naming Guidelines | ||
|
|
||
| ### Naming | ||
|
|
||
| - User-defined types (classes, structs) should use pascal case, e.g. `MyClass` | ||
| - Functions and variables should use camel case, e.g. `myFuction()`, `myVariable` | ||
| - Constants and #defines should be all uppercase with underscores denoting spaces, e.g. `MY_CONSTANT` | ||
| - Private data should be prefixed with `m_` for "member", e.g. `m_myPrivateVariable` | ||
|
|
||
| ### File names | ||
|
|
||
| - Each class should be declared in a header file named exactly after the class, e.g. `MyClass` is declared in MyClass.h | ||
| - Class declaration should stay in the .h file, definitions should be in a .cpp file, e.g. `MyClass` is defined in MyClass.cpp | ||
| - Only #include what is needed | ||
| - Use "" for including local files and <> for including library files | ||
|
|
||
| #### Namespaces | ||
| Don't use `using`, e.g. instead of: | ||
|
|
||
| ```cpp | ||
| using std | ||
| using std::vector | ||
|
|
||
| vector<Button> buttons | ||
| ``` | ||
|
|
||
| do this instead | ||
|
|
||
| ```cpp | ||
| #include <vector> | ||
|
|
||
| std::vector<Button> buttons | ||
| ``` | ||
|
|
||
| ### clang-format | ||
|
|
||
| Investigate use of clang-format to automate style checks |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,7 @@ | ||
| # arcade-machine | ||
| An application to showcase and execute Splashkit games | ||
| ## Install | ||
| + Install the [SplashKit](https://splashkit.io) SDK using the [guide](https://splashkit.io/articles/installation/) | ||
| ## Run | ||
| + Compile the application with the command ```skm clang++ Program.cpp -Iinclude -lstdc++fs -o test``` | ||
| + Run the application ```./test``` |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| You can place bundle scripts in this folder. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| SplashKit can create SQLite databases for you, they will appear in this folder. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| You can place fonts in this folder. Fonts can be otf or ttf files. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| Place images in this folder. SplashKit can work with png, jpeg, jpg, or tif files. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| You can place files in this folder for the webserver to return. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| You can place sound effects in this folder. SplashKit can play ogg, wav, mod, flac, and mp3 |
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Another thing with this file, in future, please can you change the name to a more descriptive name. This is probably something you should do in the next PR. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,26 @@ | ||
| # arcade-machine | ||
| An application to showcase and execute Splashkit games | ||
|
|
||
| ## Pre-requisites (all operating systems) | ||
|
|
||
| + Install the [SplashKit](https://splashkit.io) SDK using the [guide](https://splashkit.io/articles/installation/) | ||
|
|
||
| ## Pre-requisites (Windows with mingw32 or mingw64) | ||
|
|
||
|
|
||
| + Install `make` using `pacman -S make` | ||
|
|
||
| ## Building arcade machine (using the Makefile) | ||
| Compiling Arcade Machine using the Makefile allows incremental building of changed objects. | ||
|
|
||
| ```bash | ||
| cd arcade-machine | ||
| make | ||
| ./ArcadeMachine | ||
| ``` | ||
|
|
||
| Subsequent builds (as you change code) can be completed by using just `make`. If you need to run a clean build again, you can use `make clean` first proceeded by `make`. | ||
|
|
||
| ## Building arcade machine (manually) | ||
| + Compile the application with the command ```skm clang++ src/* -Iinclude -lstdc++fs -o test``` | ||
| + Run the application ```./test``` |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| You can place bundle scripts in this folder. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| SplashKit can create SQLite databases for you, they will appear in this folder. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| You can place fonts in this folder. Fonts can be otf or ttf files. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| Place images in this folder. SplashKit can work with png, jpeg, jpg, or tif files. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| You can place files in this folder for the webserver to return. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| You can place sound effects in this folder. SplashKit can play ogg, wav, mod, flac, and mp3 |
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Minor thing, I would change this to "documentation contributors"
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
thanks