/ovgu-canteen-gtk

Display the OvGU canteen menu in a small Gnome application

Primary LanguageRustGNU General Public License v3.0GPL-3.0

Welcome to OvGU Mensa 🥗


master release Lastest release License Sponsor Spacemacs PRs Welcome
Display the OvGU canteen menu in a small Gnome application

InstallationTranslatingBuilding the ProjectTroubleshootingAuthors


This app displays the canteens of the Studentenwerk Magdeburg, including UniCampus, Kellercafé Zschokestraße, Herrenkrug, Stendal, Wernigerode, and DomCafete Halberstadt.

Installation

Download on Flathub

The easiest way to install is by installing this App via one of the above App Stores.

Translating

In order to translate this extension you first need to install Poedit. You may use your distributions package manager to install it.

When finished, fork this project and clone like described in the linked guide.

Creating a new translation

Open Poedit and select File / New From POT/PO File... and select ovgu-canteen-gtk/po/template.pot. Select the language you want to translate to. Now start translating.

Edit or update an existing translation

Open Poedit and select Open. Navigate to the ovgu-canteen-gtk/po folder and select the language file (.po) you want to edit/update. Now select Catalog / Update from POT File... and select ovgu-canteen-gtk/po/template.pot. Now, you can start updating the translation.

Saving your work

When finished save the file into the po folder and push your changes to your fork. Now, you can create a pull request to make your translation available in the main OvGU Mensa installation.

Building the Project

Instead of installing via an app store, you can build the project yourself from source. First, you have to setup a Gnome development environment.

Ubuntu and Debian

$ sudo apt-get install build-essential libgtk-3-dev

Fedora

$ sudo dnf install @development-tools gettext-devel openssl-devel gtk3-devel

Arch

$ sudo pacman -Syy gnome-common base-devel intltool

Gentoo

You are good-to-go with the default/linux/amd64/17.0/desktop/gnome/systemd profile or similar.

View your current profile with:

# eselect profile list

Next, you need to setup a Rust toolchain. I recommend using rustup. When the latest Rust stable toolchain is successfully installed, you can clone the project:

$ git clone https://github.com/fin-ger/ovgu-canteen-gtk.git
$ cd ovgu-canteen-gtk

Build the project

$ make build

Install your custom build

$ make install PREFIX=/usr/local

The program will be installed to /usr/local/bin/ovgu-canteen-gtk as well as icons, desktop files, gsettings schemas, and localization files.

Running the application for development

If ~/.local/bin is in your PATH you can use\

$ make run

to build and run the application.

Troubleshooting

If you find any bugs/unexpected behaviour or you have a proposition for future changes open an issue describing the current behaviour and what you expected.

Authors

Fin Christensen

:octocat: @fin-ger
🐘 @fin_ger@weirder.earth
🐦 @fin_ger_github

Johannes Wünsche

:octocat: @jwuensche
🐘 @fredowald@mastodon.social
🐦 @Fredowald

Show your support

Give a ⭐ if this project helped you!