Skip to content
damios edited this page Dec 2, 2023 · 29 revisions

A post is a blog entry associated with a specific date. Posts are placed in the _posts directory and named according to the YEAR-MONTH-DAY-title.md format. Setting a date in the future allows scheduling posts (note: a rebuild of the site has be triggered after the scheduled date has arrived).

Example: 2021-07-20-devlog_25-super-cool-stuff.md

See the Pages wiki article for some general introduction into how Jekyll sites are structured.

Example

---
title: "libGDX 1.9.11"
classes: wide2
header:
  overlay_color: "#000"
  overlay_filter: "0.5"
  overlay_image: /assets/images/update.jpeg
  caption: "Photo credit: [**Markus Winkler**](https://unsplash.com/photos/cxoR55-bels)"
  teaser: /assets/images/update.jpeg
excerpt: "The time has come - libGDX 1.9.11 has been released!"

show_author: true
author_username: "crykn"
author_displayname: "damios"

tags:
  - changelog

categories: news
---

If you are looking for past changelogs, check out [this](/news/changelog/) page.
{: .notice--primary .no-top-margin }

The time has come - libGDX 1.9.11 has been released! It contains various different fixes and improvements. Furthermore, we're now also supporting to deploy Linux ARM builds, so Raspberry Pi: here we are!

![](/assets/images/posts/2020-07-22/rpi.png)

### A few notable changes:
- Update to [MobiVM 2.3.8](https://www.patreon.com/posts/mobivm-2-3-8-new-31697037)
- Update to [LWJGL 3.2.3](https://github.com/LWJGL/lwjgl3/releases/tag/3.2.3)

[...]

### Full changelog
Updating your Gradle project is straight-forward: Check out the instructions [on the wiki](/wiki/articles/updating-libgdx)! The latest version of dependencies can, as always, be found [here](/dev/versions/).
{: .notice--info}

[...]

This is basically the same as for pages. In additon:

  • Tags can be added, to group different articles (so far only used for changelogs and devlogs)
  • The category must be set as "news", so the generated links all have /news/ in front of them!
  • A teaser image is set in the header section. This image is used on the index to showcase the latest news.
  • Authors can be added:
    1. Set show_author: true
    2. Specify the author's GitHub username: author_username: "crykn". This is used to link to the author's profile on GitHub.
    3. Specify the name to display: author_displayname: "damios" (usually the authors name as displayed on his GitHub profile)

Specific Types of Posts

Changelogs

  • If you're adding a new changelog post, please don't forget to set the changelog tag. This is used to automatically update the link & text on the index page.
  • The excerpt in a changelog post must include a short description/introduction that is around 200 characters long. This is displayed on the index page.
  • The roadmap page has to be adapted as well. And don't forget to change the "Last updated" date at the bottom!
  • Furthermore, the setup tool download needs to be brought up to date.
  • The version data provided via the API (https://libgdx.com/service/versions.json) and shown on the versions page is fetched automatically, whenever the page is deployed.

Community Showcases

Game Jam Announcements

  • Game jam announcements can be generated via GitHub Actions. Open the Create Game Jam Post workflow, select Run wokflow at the top right and then fill in all the necessary details. Click the green Run workflow button to confirm.
  • Don't forget to also update the community/jams/ page.

Status Reports

  • Status Report posts must include the devlog tag.