If you have any questions about how to edit this wiki, please do not hesitate to ask! See our for more information.

Style

We use Markdown in this wiki. To learn your way around this, here is the official .

• Wiki links are made using and ] ] (without the spaces) with a | (pipe) to separate text from link. For example:

[[link text to simple game | A simple game]] renders this: link text to simple game

Do NOT use conventional []() syntax for wiki-links.

Links are done as follows: [ClassName](link to docs) [(code)](link to code) for example:

renders the following:

Don’t use non-alphabetic characters in Wiki page names, because not all operating systems can handle them when cloning Wiki as Git repository (for example, Windows doesn’t support “:”).

• Please note that there should be a space in between ClassName (Code) style formatting, in order to differentiate the two.
• If a link to documentation ends in a right paren ), it will mess up the markdown. take this as an example:

when using the markdown formatting of []() the end paren will mess up the link, so please remember to escape the ending paren ()) so for example, it should be :

without the escaped paren, a 404 is imminent!

Videos

Videos are not supported on GitHub :( so we use a small workaround by posting a screenshot of the video, which leads to a link to the youtube video. Here is the syntax:

Lets hope Github eventually supports embedded videos!

If you make a page, you will most likely want it to be displayed on the main libGDX wiki Table of contents and the sidebar Table of Contents. When you create an article, please create a second edit of the Home page with the appropriate positioning of your article. Mirror this change in the sidebar ToC, as to maintain likeness between the two.

Tables of Contents per page

Tables of contents have to be manually created on a per-page basis. For an example of how to do so outside of this section, please refer to our article.

When creating headers in markdown, we specify using a number of octothorpes (#) that define the header level. When we create a header in an article entitled Help Me the corresponding link would be help-me#comments-and-questionsconcerns

so when we go to make our table of contents, it would be in an unordered list, and using these qualified page fragment links. Please see the box2d article for more information.

Images need to be added manually through a desktop interface (A.K.A. not through the github web interface). Images are stored in the images/ of the libGDX wiki, which arent accessed through the libGDX wikis github interface. To add an image, you must clone the repo: $ git clone https://github.com/libgdx/libgdx.wiki.git add your images to the images folder using the appropriate naming scheme my-page-name# where # is the order of the picture displayed on the page (this can be ommitted if only one image is used in the page, but recommended). Images are linked to with the following syntax (assuming the image is stored in the images/ directory) (without the spaces in between brackets) which will display:

Large Multi-Page Edits

Github’s web interface is the only way that a non-contributor can easily edit a wiki. If a person is to make a large edit that spans multiple pages, it can be done via the web interface, but it is recommended to take the following steps:

• Fork the repo
• Clone your forked repo locally
• Make necessary changes
• Commit and push that to your forked repo
• Message a libGDX maintainer (who has commit rights) on our Discord to clone your repo and push it themselves.

Github wiki’s diff system is not as robust as the diff system for code. If you make a tiny change, in the commit message please say “Fixed typo alpa -> alpha” or something of the sort.