Contribute 20 new bahasa Indonesia translated messages to the file https://github.com/phpmyadmin/localized_docs/blob/master/po/id.po .
The task is assessed by reviewing commits by your GitHub username to that file, and counting new messages added.
Note: these commits do not currently meet the Besut Kode criteria for the
registration task,
as the localized_docs
project does not yet have 50 stars
(only 10 stars as of 29 September).
Read The Docs (RTD) is a commonly used service for hosting documentation.
It is free for Open Source Software, and also has a Commercial service.
It supports multiple languages.
The translated example provided in their documentation is phpMyAdmin.
Clicking on the “v: latest” at the bottom of phpMyAdmin shows phpMyAdmin has their documentation translated into the following languages:
The English documentation of phpMyAdmin is in the GitHub repository
phpmyadmin/phpmyadmin
in the subdirectory /doc,
and the translations are stored in GitHub repository
phpmyadmin/localized_docs
.
The translations are stored in .po gettext
files
in the subdirectory /po.
There is a bahasa Indonesia translation in the file /po/id.po, however it is mostly untranslated, so phpMyAdmin does not include bahasa Indonesia on their Read The Docs site.
This id.po
file is editable using a normal text editor, or with specialised applications.
There are a few cross-platform applications mentioned in the English Wikipedia article
about gettext
.
The syntax used throughout the .po
file format is very strict and obscure.
This task will require that you gain a basic understanding of the .po
file format.
There are also specialised libraries for manipulating .po
files, available for most
popular programming languages, that can be used to programmatically perform translation.
There are also GitHub services for translation of .po
files, providing a web application for
adding and updating translations.
The phpMyAdmin localized_docs
project is connected to the Weblate
service, where the bahasa Indonesian translation page
shows the documentation is 0.6% translated.
If you log into Weblate using your GitHub account, when you contribute translations in Weblate your changes will be lazy-committed to the GitHub repository, such as when someone else does a translation, and appear on your GitHub profile.
The phpMyAdmin project prefers translations are provided using Weblate, as it reduces the
workload for the committers since Weblate automatically commits changes.
Unless there is a very good reason to contribute directly to the repository, do not submit
a Pull Request to complete this task. An example reason for using a Pull Request is
programmatically translating a very large group of messages using one of the gettext
libraries.
Even with a good reason, it is not recommended to do this when there are a lot of contributors
to the same file, such as a group task like Besut Kode, as merge conflicts may occur.
Related StackOverflow tags: