Skip to content

Commit

Permalink
Deploying to gh-pages from @ f00cc83 🚀
Browse files Browse the repository at this point in the history
  • Loading branch information
ByteHamster committed Nov 17, 2024
1 parent 1410878 commit c247f0d
Show file tree
Hide file tree
Showing 129 changed files with 352 additions and 394 deletions.
2 changes: 1 addition & 1 deletion assets/datasets/documentation_index.json
Original file line number Diff line number Diff line change
Expand Up @@ -88,7 +88,7 @@
{
"title" : "I found a typo or spelling mistake",
"url" : "/documentation/bugs-first-aid/typo-translations",
"content" : "I found a typo or spelling mistakeDid 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. Issue with the website translations can be fixed on Weblate. You can find more information in our Contribute section.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 or for the website.Do you just want to inform us?You can create a post in the translations section on our forum. To do so you need to create an account (if you don’t have one already) or simply log in via Google."
"content" : "I found a typo or spelling mistakeDid 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 the translations on Weblate. You can find more information in our Contribute section.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 or for the website.Do you just want to inform us?You can create a post in the translations section on our forum. To do so you need to create an account (if you don’t have one already) or simply log in via Google."
} ,


Expand Down
Binary file not shown.
Binary file not shown.
2 changes: 1 addition & 1 deletion blog/2020/09/2-0-0-release.html
Original file line number Diff line number Diff line change
Expand Up @@ -338,7 +338,7 @@ <h1 class="size-36 weight-700 color-gray-900">2.0.0 release</h1>

<p>You can see the full, huge list of changes on our development platform, <a href="https://github.com/AntennaPod/AntennaPod/compare/1.8.1...2.0.1">GitHub</a>.</p>

<p>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 <a href="https://forum.antennapod.org/">forum</a>, <a href="https://www.transifex.com/antennapod/antennapod/">translating</a> or by <a href="https://github.com/AntennaPod/AntennaPod">writing code</a>.</p>
<p>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 <a href="https://forum.antennapod.org/">forum</a>, <a href="https://hosted.weblate.org/projects/antennapod/app/">translating</a> or by <a href="https://github.com/AntennaPod/AntennaPod">writing code</a>.</p>

</article>
</div>
Expand Down
2 changes: 1 addition & 1 deletion blog/2020/12/2-1-0-release.html
Original file line number Diff line number Diff line change
Expand Up @@ -333,7 +333,7 @@ <h1 class="size-36 weight-700 color-gray-900">2.1.0 release</h1>
<li>Smooth sleep timer volume (by <a href="https://github.com/olivoto" class="user-mention">@olivoto</a>)</li>
</ul>

<p>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 <a href="https://forum.antennapod.org/">forum</a>, <a href="https://www.transifex.com/antennapod/antennapod/">translating</a> or by <a href="https://github.com/AntennaPod/AntennaPod">writing code</a>.</p>
<p>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 <a href="https://forum.antennapod.org/">forum</a>, <a href="https://hosted.weblate.org/projects/antennapod/app/">translating</a> or by <a href="https://github.com/AntennaPod/AntennaPod">writing code</a>.</p>

</article>
</div>
Expand Down
2 changes: 1 addition & 1 deletion blog/2020/12/new-website.html
Original file line number Diff line number Diff line change
Expand Up @@ -321,7 +321,7 @@ <h1 class="size-36 weight-700 color-gray-900">New website</h1>
<div class="row no-gutters justify-content-center pb-4">
<div class="col-lg-9">
<article class="post-content pb-3">
<p>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 (<a href="https://github.com/AntennaPod/AntennaPod/">GitHub</a> for development, <a href="https://www.transifex.com/antennapod/antennapod/">Transifex</a> for translations and the <a href="https://forum.antennapod.org/">forum</a>) 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 <a href="https://web.archive.org/web/20200814004524/https://antennapod.org/">internet archive</a>.</p>
<p>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 (<a href="https://github.com/AntennaPod/AntennaPod/">GitHub</a> for development, <a href="https://hosted.weblate.org/projects/antennapod/app/">Weblate</a> for translations and the <a href="https://forum.antennapod.org/">forum</a>) 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 <a href="https://web.archive.org/web/20200814004524/https://antennapod.org/">internet archive</a>.</p>

<p>After noticing the awesome redesign of the website of <a href="https://k9mail.app/">K-9 Mail</a> (open-source email app), I reached out to the designer of that website, <a href="https://github.com/AnXh3L0">Anxhelo Lushka</a>. 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 <a href="/documentation">documentation section</a> and a <a href="/blog">blog</a>. The website is not completely finished yet. If you discover problems, just let us know on the <a href="https://forum.antennapod.org/">forum</a>!</p>

Expand Down
2 changes: 1 addition & 1 deletion blog/2021/05/2-2-0-release.html
Original file line number Diff line number Diff line change
Expand Up @@ -335,7 +335,7 @@ <h1 class="size-36 weight-700 color-gray-900">2.2.0 release</h1>
<li>Player screen usability for visually impaired (<a href="https://github.com/ByteHamster" class="user-mention">@ByteHamster</a>)</li>
</ul>

<p>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 <a href="https://forum.antennapod.org/">forum</a>, <a href="https://www.transifex.com/antennapod/antennapod/">translating</a> or by <a href="https://github.com/AntennaPod/AntennaPod">writing code</a>.</p>
<p>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 <a href="https://forum.antennapod.org/">forum</a>, <a href="https://hosted.weblate.org/projects/antennapod/app/">translating</a> or by <a href="https://github.com/AntennaPod/AntennaPod">writing code</a>.</p>

</article>
</div>
Expand Down
2 changes: 1 addition & 1 deletion blog/2021/07/2-3-0-release.html
Original file line number Diff line number Diff line change
Expand Up @@ -337,7 +337,7 @@ <h1 class="size-36 weight-700 color-gray-900">2.3.0 release</h1>
<li>New media player screen (<a href="https://github.com/AntennaPod/AntennaPod/issues/5075">#5075</a>, <a href="https://github.com/ueen" class="user-mention">@ueen</a>, <a href="https://github.com/jonasburian" class="user-mention">@jonasburian</a> &amp; <a href="https://github.com/ByteHamster" class="user-mention">@ByteHamster</a>)</li>
</ul>

<p>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 <a href="https://forum.antennapod.org/">forum</a>, <a href="https://www.transifex.com/antennapod/antennapod/">translating</a> or by <a href="https://github.com/AntennaPod/AntennaPod">writing code</a>.</p>
<p>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 <a href="https://forum.antennapod.org/">forum</a>, <a href="https://hosted.weblate.org/projects/antennapod/app/">translating</a> or by <a href="https://github.com/AntennaPod/AntennaPod">writing code</a>.</p>

</article>
</div>
Expand Down
2 changes: 1 addition & 1 deletion blog/2022/01/website-translations.html
Original file line number Diff line number Diff line change
Expand Up @@ -365,7 +365,7 @@ <h1 id="an-educational-experience">An educational experience</h1>
<div class="footnotes" role="doc-endnotes">
<ol>
<li id="fn:1" role="doc-endnote">
<p>See the <a href="https://www.transifex.com/antennapod/antennapod/">translation status of the app</a> - we maintain a <a href="https://github.com/AntennaPod/AntennaPod/pull/4112">threshold of 40% completion</a> for languages. <a href="#fnref:1" class="reversefootnote" role="doc-backlink"></a></p>
<p>See the <a href="https://hosted.weblate.org/projects/antennapod/app/">translation status of the app</a> - we maintain a <a href="https://github.com/AntennaPod/AntennaPod/pull/4112">threshold of 40% completion</a> for languages. <a href="#fnref:1" class="reversefootnote" role="doc-backlink"></a></p>
</li>
<li id="fn:2" role="doc-endnote">
<p>According to the <a href="https://www.ef.com/wwen/epi/">EF English Proficiency Index</a>, 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? <a href="#fnref:2" class="reversefootnote" role="doc-backlink"></a></p>
Expand Down
56 changes: 7 additions & 49 deletions contribute/translate.html
Original file line number Diff line number Diff line change
Expand Up @@ -276,67 +276,25 @@ <h1 class="color-gray-800 weight-700">Translate</h1>
<div class="row justify-content-center">
<div class="col-lg-12">
<article class="post-content">




<p>Out of the estimated <a href="https://en.wikipedia.org/wiki/World_population">world population</a> of 7.9 billion people, ‘only’ 1.5 billion <a href="https://www.ethnologue.com/insights/ethnologue200/">speak English</a>. 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).</p>
<p>Out of the estimated <a href="https://en.wikipedia.org/wiki/World_population">world population</a> of 7.9 billion people, ‘only’ 1.5 billion <a href="https://www.ethnologue.com/insights/ethnologue200/">speak English</a>. 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).</p>

<p>We therefore much appreciate your help!</p>

<h1 id="the-app">The app</h1>
<p>To help translate the app, we ask you to contribute via <a href="https://www.transifex.com/antennapod/antennapod/">Transifex</a>. Anyone can sign up there and get started. Transifex has helpful guides to <a href="https://docs.transifex.com/getting-started-1/translators">get started on their platform</a> and to <a href="https://docs.transifex.com/translation/translating-with-the-web-editor">get familiar with the Web Editor interface</a>.</p>

<p>Under the AntennaPod project you will find three ‘resources’:</p>
<ul>
<li>The app itself</li>
<li>The short, one-sentence description for in app stores</li>
<li>The more elaborate description for in app stores</li>
</ul>
<p>To help translate the app, we ask you to contribute via <a href="https://hosted.weblate.org/projects/antennapod/app/">Weblate</a>. Anyone can sign up there and get started. In Weblate’s documentation you’ll find <a href="https://docs.weblate.org/en/latest/user/translating.html">everything you need to know to start translating</a>.</p>


<p><a data-toggle="modal" data-target="#imgModaltranslation-resources-transifexpng" style="cursor: pointer;">
<img src="/assets/images/documentation/en/translation-resources-transifex.png" alt="Overview of resources in Transifex" style="" class="rounded mt-2 ">
</a></p>

<div class="modal fade" id="imgModaltranslation-resources-transifexpng" tabindex="-1" role="dialog" aria-labelledby="imgModalLabel" aria-hidden="true">
<div class="modal-dialog modal-dialog-centered modal-lg" role="document">
<div class="modal-content rounded">
<button type="button" class="close" data-dismiss="modal" aria-label="Close" style="position: absolute; top: 1rem; right: 1rem;">
<i class="fas fa-times-circle"></i>
</button>
<img src="/assets/images/documentation/en/translation-resources-transifex.png" alt="Overview of resources in Transifex" width="100%" class="rounded">
</div>
</div>
</div>
<p><a href="https://hosted.weblate.org/engage/antennapod/"><img src="https://hosted.weblate.org/widget/antennapod/horizontal-auto.svg" alt="Translation status"></a></p>

<p>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 <a href="https://github.com/AntennaPod/AntennaPod/pull/4112">threshold of 40% completion</a> for languages. If it goes below that, the app hardly provides a good user experience.</p>
<h1 id="the-app">The app</h1>
<p>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.</p>

<p>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.</p>
<p>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.</p>

<p>Translation contributors will find themselves mentioned in the app with their Transifex username, under <code class="language-plaintext highlighter-rouge">Settings</code> » <code class="language-plaintext highlighter-rouge">About</code> » <code class="language-plaintext highlighter-rouge">Contributors</code>.</p>
<p>Translation contributors will find themselves mentioned in the app with their Weblate username, under <code class="language-plaintext highlighter-rouge">Settings</code> » <code class="language-plaintext highlighter-rouge">About</code> » <code class="language-plaintext highlighter-rouge">Contributors</code>.</p>

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

<p>In the AntennaPod project, you will find four ‘components’. Each represents a part of the website. We encourage you to start with the components <code class="language-plaintext highlighter-rouge">General</code> and the <code class="language-plaintext highlighter-rouge">Short strings</code>, because these will be the first elements a user sees on the website. The component <code class="language-plaintext highlighter-rouge">Documentation</code> is a very close second priority, because this section is directly available via the app when people tap on Support. The <code class="language-plaintext highlighter-rouge">Contribute</code> component comes last, because a basic understanding of English is needed anyway to interact with the community.</p>


<p><a data-toggle="modal" data-target="#imgModaltranslation-components-weblatepng" style="cursor: pointer;">
<img src="/assets/images/documentation/en/translation-components-weblate.png" alt="Overview of components in Weblate" style="" class="rounded mt-2 ">
</a></p>

<div class="modal fade" id="imgModaltranslation-components-weblatepng" tabindex="-1" role="dialog" aria-labelledby="imgModalLabel" aria-hidden="true">
<div class="modal-dialog modal-dialog-centered modal-lg" role="document">
<div class="modal-content rounded">
<button type="button" class="close" data-dismiss="modal" aria-label="Close" style="position: absolute; top: 1rem; right: 1rem;">
<i class="fas fa-times-circle"></i>
</button>
<img src="/assets/images/documentation/en/translation-components-weblate.png" alt="Overview of components in Weblate" width="100%" class="rounded">
</div>
</div>
</div>

<p>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.</p>

<h1 id="other-materials">Other materials</h1>
Expand Down
Loading

0 comments on commit c247f0d

Please sign in to comment.