• Introduction
• What is Airtime?
• Rights and royalties
• Using Airtime
• On air in 60 seconds!
• Getting started
• Smartphone journalism
• The System menu
• Users
• Preferences
• Media folders
• Stream settings
• Support feedback
• Status
• Playout history
• Listener stats
• The main menus
• Now playing
• Add media
• Library
• Calendar
• Listen
• Help
• Airtime in the studio
• Recording shows
• Live shows with Mixxx
• Icecast and SHOUTcast
• Installation
• Preparing the server
• Easy setup
• Automated installation
• Manual installation
• Setting the server time
• Administration
• Preparing media for ingest
• Using the airtime-import script
• The airtime-log command
• Backing up the server
• Upgrading
• Troubleshooting
• Using Monit
• Advanced configuration
• Automated file import
• Icecast handover
• Promoting your station
• Stream player for your website
• Exporting the schedule
• Interface customization
• Interface localization
• Host configuration
• Appendix
• Expert install
• HD Audio Models
• About this manual

Interface localization

Beginning with Airtime 2.3.0, the administration interface can be localized using the standard GNU gettext method. Using GitHub for this task means you don't have to tackle the whole of a localization yourself; just as much as you can manage.

First, you should check if a localization is already under way for your locale of choice. The best way to do this is to take a look at the GitHub repository for Airtime at https://github.com/sourcefabric/Airtime/tree/devel. You can also ask in the Airtime development forum at http://forum.sourcefabric.org/categories/airtime-development, where you might find community members who can help you with the translation.

GNU gettext means using a .po file for each language or dialect, a specially formatted plain text file with groups of three or more lines, like this example from Airtime's Korean localization:

#: airtime_mvc/application/configs/navigation.php:57
msgid "Media Folders"
msgstr "미디어 폴더"

The first of these three lines starts with the hash symbol, and references where this string of text is found in the source code by its file name and line number. If this string is found more than once in the source code, you will see other reference lines here. The second line contains the msgid, which is the original version of the string. The third line contains the msgstr, which is the translation of that string for the localization that this particular .po file relates to.

If you use the cross-platform program Poedit (http://www.poedit.net/) to edit the .po file, this formatting of the text is hidden by an easy-to-use GUI. The poedit package can be installed on most GNU/Linux distributions using the standard software installer. Versions of Poedit for Mac and Windows are available for free download from the project's homepage.

Before manually translating strings in Poedit from scratch, you should take a look at the online translation services available which can fill in many of the msgstr's for you, such as Google's Translation Toolkit (http://translate.google.com/toolkit/) which supports gettext .po files. You can then use Poedit to fine-tune the localization and fix any formatting errors produced by the automatic translation.

If you don't already have a GitHub account, you can sign up at https://github.com/signup/free. Once you have a GitHub account, you can fork a copy (https://help.github.com/articles/fork-a-repo) of the Airtime project. Work for the next major version of the software is done in the devel branch of each project, so that's the branch to checkout after you have made the initial git clone.

In the locale code de_DE, de represents the German language and the suffix _DE indicates the dialect spoken in the country of Germany. Some languages have a wide variety of dialect localizations, which can be differentiated with a suffix in this way. You should update the header information in the .po file, which includes the language code and a country code, using one of the existing .po files as a guide.

After forking the Airtime git repository, make sure you're in the devel branch:

git branch
* devel
  master

Create a new locale directory (e.g. airtime_mvc/locale/de_DE/LC_MESSAGES/ for German as spoken in Germany):

mkdir -p airtime_mvc/locale/de_DE/LC_MESSAGES/

Copy the template airtime.po file into the directory you just created:

cp airtime_mvc_locale/template/airtime.po airtime_mvc/locale/de_DE/LC_MESSAGES

and update the header information in the new copy of the airtime.po file using the nano editor:

nano airtime_mvc/locale/de_DE/LC_MESSAGES/airtime.po

For the example of German, the header of the file should now look like this:

# GERMAN (de_DE) translation for Airtime.
# Copyright (C) 2012 Sourcefabric
# This file is distributed under the same license as the Airtime package.
# Sourcefabric <contact@sourcefabric.org>, 2012.
#
msgid ""
msgstr ""
"Project-Id-Version: Airtime 2.3\n"
"Report-Msgid-Bugs-To: http://forum.sourcefabric.org/\n"

After using an online translation tool to begin a new localization, you can load the exported .po file into Poedit and complete your translation there. Enter the localization team's contact information and language into Poedit's Edit -> Preferences and Catalog -> Settings dialogs, which will be added to the .po file. When you save a .po file in Poedit, the corresponding binary .mo file will be compiled automatically.

Finally, git add, git commit and git push these new .mo and .po files to your GitHub fork of the project, and send a git pull request (https://help.github.com/articles/using-pull-requests) to the Airtime developers. The localization can then be added to a forthcoming Airtime release.

If you don't want to work with git, that's no problem - download a copy of the .po template file, edit the header, run it through an automatic translator and check it with Poedit. Then email your contribution to the Airtime team as an attachment - it will be very welcome! However, learning to use git is a good idea, because it means you can work directly on the source code, share the localization work with the Airtime community, and avoid duplicated effort.