English | Tiếng Việt | Español | Bahasa Indonesia | ภาษาไทย | 한국어 | 官话
osudroid-guide
A guide for osu!droid (and beyond)
Contribution Guide
For contributor with no programming background
You can suggest changes via the website and you will be redirected to that page’s editor. The editor should follow the Jekyll markdown format (see the cheatsheet here). After that if there is a big green button, just hit it until you have made a “Pull Request”. And you are done!
Simplified terminology:
- Fork: your copy of the site (your edit will be there first, obviously I can’t just allow you to straight up edit the site lol)
- Pull Request: your request to change the page with your change
Notes on dealing with linking image file:
- Remote image linking (something like
) should be avoided in favor of local linking, but if you don’t know how to do it, just use remote image linking for now, I will fix it later. - If you are translating a page, please copy the image link (something like
) EXACTLY into the translated version
Note on liquid template language:
- If you see stuff start with
{{ }}or{% %}, that is the Liquid template language. It is used to make the code more reusable. Please leave it as it is if you don’t know what you are doing.
For programmer with the know-how
Clone the repository and setup a local development environment for Github Pages (See the guide here).
Please note that the page directory is /docs and default baseurl is /osudroid-guide (need to be config to empty string whether by _config.yml or command args --baseurl=""). After gettingp the page run on your local environment go figure!
Notes on dealing with linking image file:
- Remote image linking should be avoided, please upload image to
/docs/assets/imagesand link it from there using{{site.baseurl}}/assets/images/<filename>.