Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update translation links #371

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion _blog/2020-09-08-2.0.0 release.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,4 +23,4 @@ Version 2.0.0 is a big step forward for AntennaPod. We rewrote big parts of the

You can see the full, huge list of changes on our development platform, [GitHub](https://github.com/AntennaPod/AntennaPod/compare/1.8.1...2.0.1).

As of writing this, version 2.0.0 is rolled out to 100% of the Google Play users. At the same time, the first beta release of version 2.1.0 is rolled out to our beta testers. AntennaPod is developed by volunteers in our free-time. If you like AntennaPod and want to give something back to the community, consider contributing by helping other users in the [forum](https://forum.antennapod.org/), [translating](https://www.transifex.com/antennapod/antennapod/) or by [writing code](https://github.com/AntennaPod/AntennaPod).
As of writing this, version 2.0.0 is rolled out to 100% of the Google Play users. At the same time, the first beta release of version 2.1.0 is rolled out to our beta testers. AntennaPod is developed by volunteers in our free-time. If you like AntennaPod and want to give something back to the community, consider contributing by helping other users in the [forum](https://forum.antennapod.org/), [translating](https://hosted.weblate.org/projects/antennapod/app/) or by [writing code](https://github.com/AntennaPod/AntennaPod).
2 changes: 1 addition & 1 deletion _blog/2020-12-06-New website.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,6 @@ layout: blog
guid: https://antennapod.org/blog/2020/12/new-website
---

The old AntennaPod website was pretty basic. Its FAQ section was outdated and did not follow the design of the rest of the page. Additionally, the FAQ page was linked nowhere -- if you did not know where to look, you did not find it. Links to platforms for contribution ([GitHub](https://github.com/AntennaPod/AntennaPod/) for development, [Transifex](https://www.transifex.com/antennapod/antennapod/) for translations and the [forum](https://forum.antennapod.org/)) were hidden in a small footer menu. The website highlighted a few features but it did not describe how to use them. Additionally, the website was a plain html file, making it rather hard to update. You can find the old website on the [internet archive](https://web.archive.org/web/20200814004524/https://antennapod.org/).
The old AntennaPod website was pretty basic. Its FAQ section was outdated and did not follow the design of the rest of the page. Additionally, the FAQ page was linked nowhere -- if you did not know where to look, you did not find it. Links to platforms for contribution ([GitHub](https://github.com/AntennaPod/AntennaPod/) for development, [Weblate](https://hosted.weblate.org/projects/antennapod/app/) for translations and the [forum](https://forum.antennapod.org/)) were hidden in a small footer menu. The website highlighted a few features but it did not describe how to use them. Additionally, the website was a plain html file, making it rather hard to update. You can find the old website on the [internet archive](https://web.archive.org/web/20200814004524/https://antennapod.org/).

After noticing the awesome redesign of the website of [K-9 Mail](https://k9mail.app/) (open-source email app), I reached out to the designer of that website, [Anxhelo Lushka](https://github.com/AnXh3L0). Anxhelo offered to create a brand new website, specifically for AntennaPod! You are currently looking at our new website. It has more features, like a [documentation section](/documentation) and a [blog](/blog). The website is not completely finished yet. If you discover problems, just let us know on the [forum](https://forum.antennapod.org/)!
2 changes: 1 addition & 1 deletion _blog/2020-12-13-2.1.0 release.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,4 +18,4 @@ We are happy to announce version 2.1.0 of AntennaPod.
- Playback speed & filter dialogs (by @ByteHamster & @bws9000)
- Smooth sleep timer volume (by @olivoto)

AntennaPod is developed by volunteers in our free-time. If you like AntennaPod and want to give something back to the community, consider contributing by helping other users in the [forum](https://forum.antennapod.org/), [translating](https://www.transifex.com/antennapod/antennapod/) or by [writing code](https://github.com/AntennaPod/AntennaPod).
AntennaPod is developed by volunteers in our free-time. If you like AntennaPod and want to give something back to the community, consider contributing by helping other users in the [forum](https://forum.antennapod.org/), [translating](https://hosted.weblate.org/projects/antennapod/app/) or by [writing code](https://github.com/AntennaPod/AntennaPod).
2 changes: 1 addition & 1 deletion _blog/2021-05-09-2.2.0 release.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,4 +20,4 @@ We are happy to announce version 2.2.0 of AntennaPod.
- Fixed stuck notification (@a1291762)
- Player screen usability for visually impaired (@ByteHamster)

AntennaPod is developed by volunteers in our free-time. If you like AntennaPod and want to give something back to the community, consider contributing by helping other users in the [forum](https://forum.antennapod.org/), [translating](https://www.transifex.com/antennapod/antennapod/) or by [writing code](https://github.com/AntennaPod/AntennaPod).
AntennaPod is developed by volunteers in our free-time. If you like AntennaPod and want to give something back to the community, consider contributing by helping other users in the [forum](https://forum.antennapod.org/), [translating](https://hosted.weblate.org/projects/antennapod/app/) or by [writing code](https://github.com/AntennaPod/AntennaPod).
2 changes: 1 addition & 1 deletion _blog/2021-07-22-2.3.0 release.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,4 +22,4 @@ We are happy to announce version 2.3.0 of AntennaPod. Here is a list of notable
* Fix proxy support (#5151, @ByteHamster)
* New media player screen (#5075, @ueen, @jonasburian & @ByteHamster)

AntennaPod is developed by volunteers in our free-time. If you like AntennaPod and want to give something back to the community, consider contributing by helping other users in the [forum](https://forum.antennapod.org/), [translating](https://www.transifex.com/antennapod/antennapod/) or by [writing code](https://github.com/AntennaPod/AntennaPod).
AntennaPod is developed by volunteers in our free-time. If you like AntennaPod and want to give something back to the community, consider contributing by helping other users in the [forum](https://forum.antennapod.org/), [translating](https://hosted.weblate.org/projects/antennapod/app/) or by [writing code](https://github.com/AntennaPod/AntennaPod).
2 changes: 1 addition & 1 deletion _blog/2022-01-04-Website translations.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,5 +49,5 @@ Photo by [Daria Sannikova](https://www.pexels.com/@dariabuntaria).

Footnotes:

[^1]: See the [translation status of the app](https://www.transifex.com/antennapod/antennapod/) - we maintain a [threshold of 40% completion](https://github.com/AntennaPod/AntennaPod/pull/4112) for languages.
[^1]: See the [translation status of the app](https://hosted.weblate.org/projects/antennapod/app/) - we maintain a [threshold of 40% completion](https://github.com/AntennaPod/AntennaPod/pull/4112) for languages.
[^2]: According to the [EF English Proficiency Index](https://www.ef.com/wwen/epi/), only 44 countries have a (very) high proficiency in English. Making the project available in more languages, helps make it accessible to more people. Who of your family and friends would not feel comfortable reading the news, or using a tool in English?
50 changes: 6 additions & 44 deletions _i18n/en/contribute/translate.md
Original file line number Diff line number Diff line change
@@ -1,60 +1,22 @@
<!-- mdpo-disable -->

{% capture img-transifex %}
{% include image.html
alt="
<!-- mdpo-enable-next-line -->
Overview of resources in Transifex

"
loc="/assets/images/documentation"
file="translation-resources-transifex.png"
%}
{% endcapture %}

{% capture img-weblate %}
{% include image.html
alt="
<!-- mdpo-enable-next-line -->
Overview of components in Weblate

"
loc="/assets/images/documentation"
file="translation-components-weblate.png"
%}
{% endcapture %}

<!-- mdpo-enable -->

Out of the estimated [world population](https://en.wikipedia.org/wiki/World_population) of 7.9 billion people, 'only' 1.5 billion [speak English](https://www.ethnologue.com/insights/ethnologue200/). This may not mean much per se. But if anything, we can conclude that making AntennaPod available in more languages, makes the app accessible to more people. As a side benefit, localising the app also helps our project grow beyond the current main userbases (Germany and the US).

We therefore much appreciate your help!

# The app
To help translate the app, we ask you to contribute via [Transifex](https://www.transifex.com/antennapod/antennapod/). Anyone can sign up there and get started. Transifex has helpful guides to [get started on their platform](https://docs.transifex.com/getting-started-1/translators) and to [get familiar with the Web Editor interface](https://docs.transifex.com/translation/translating-with-the-web-editor).

Under the AntennaPod project you will find three 'resources':
- The app itself
- The short, one-sentence description for in app stores
- The more elaborate description for in app stores
To help translate the app, we ask you to contribute via [Weblate](https://hosted.weblate.org/projects/antennapod/app/). Anyone can sign up there and get started. In Weblate's documentation you'll find [everything you need to know to start translating](https://docs.weblate.org/en/latest/user/translating.html).

<!-- mdpo-disable-next-line -->
{{ img-transifex | strip }}
[![Translation status](https://hosted.weblate.org/widget/antennapod/horizontal-auto.svg)](https://hosted.weblate.org/engage/antennapod/)

The app is currently available in 34 languages. While there are more languages in Transifex, we don't include them in the app. We try to maintain a [threshold of 40% completion](https://github.com/AntennaPod/AntennaPod/pull/4112) for languages. If it goes below that, the app hardly provides a good user experience.
# The app
The app is currently available in more than 38 languages. While there are more languages in Weblate, we don't include them in the app. We try to maintain a threshold of 40% completion for languages. If it goes below that, the app hardly provides a good user experience.

New translations are pulled from Transifex to GitHub (the development platform) at least for every 'point release'. These are releases like 2.0, 2.5, etc that introduce new features. But we also release updates with bug fixes and new translations in between. On average, it might take a month or two before your work is available in a release.
New translations are pulled from Weblate to GitHub (the development platform) at least for every 'point release'. These are releases like 2.0, 2.5, etc that introduce new features. But we also release updates with bug fixes and new translations in between. On average, it might take a month or two before your work is available in a release.

Translation contributors will find themselves mentioned in the app with their Transifex username, under `Settings` » `About` » `Contributors`.
Translation contributors will find themselves mentioned in the app with their Weblate username, under `Settings` » `About` » `Contributors`.

# The website
For several reasons (outlined in a [blogpost on website translations](/blog/2022/01/website-translations)) we use a different translation system for our website: [Weblate](https://hosted.weblate.org/projects/antennapod/). Anyone can sign up there and start contributing. In Weblate's documentation you'll find [everything you need to know to start translating](https://docs.weblate.org/en/latest/user/translating.html).

In the AntennaPod project, you will find four 'components'. Each represents a part of the website. We encourage you to start with the components `General` and the `Short strings`, because these will be the first elements a user sees on the website. The component `Documentation` is a very close second priority, because this section is directly available via the app when people tap on Support. The `Contribute` component comes last, because a basic understanding of English is needed anyway to interact with the community.

<!-- mdpo-disable-next-line -->
{{ img-weblate | strip }}

New translations are pulled from Weblate to GitHub (the development platform) manually once in a while. When a language hits 90% translation (that's roughly the whole website minus the Contribute section), we can enable it on the live website. We always try to find a community member that can review a test version of the website, to improve the quality of translations.

# Other materials
Expand Down
2 changes: 1 addition & 1 deletion _i18n/en/documentation/bugs-first-aid/typo-translations.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
Did you find a spelling mistake, or something that sounds odd? It's always possible that we made a mistake in English (in which we make the app & website), or that something has not been translated correctly. Luckily these issues are often easily fixed.

# Do you want to fix it yourself?
If the issue is in any other language than English, you can update **app translations** on [Transifex](https://www.transifex.com/antennapod/antennapod/core-values/). Issue with the **website translations** can be fixed on [Weblate](https://hosted.weblate.org/projects/antennapod/). You can [find more information in our Contribute section](/contribute/translate).
If the issue is in any other language than English, you can update the translations on [Weblate](https://hosted.weblate.org/projects/antennapod/). You can [find more information in our Contribute section](/contribute/translate).

Is the issue with the **English texts**? Then you will need to be or get familiar with GitHub. You can send a Pull Request for [the app](https://github.com/AntennaPod/AntennaPod/) or for [the website](https://github.com/AntennaPod/antennapod.github.io).

Expand Down