Skip to content

Commit

Permalink
Update translation guidance (#791)
Browse files Browse the repository at this point in the history
* Update Translation Sitemaps guidance

* Translation Guidance: explicit we welcome new subtitles
  • Loading branch information
remibetin authored Aug 13, 2024
1 parent abf6169 commit 4bb876e
Show file tree
Hide file tree
Showing 2 changed files with 42 additions and 30 deletions.
14 changes: 9 additions & 5 deletions pages/about/translating/resources.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "Step-by-Step Guide to Translating WAI Resources"
nav_title: Translating WAI Resources
lang: en
last_updated: 2024-05-27
last_updated: 2024-08-13
description: Help make the Web accessible to people with disabilities around the world. We appreciate your contributions to translating W3C WAI accessibility resources.

permalink: /about/translating/resources/
Expand All @@ -14,7 +14,7 @@ image: /content-images/about/social-translations.png
feedbackmail: [email protected]

footer: |
<p><strong>Date:</strong> Updated 27 May 2024.</p>
<p><strong>Date:</strong> Updated 13 August 2024.</p>
<p><strong>Editors:</strong> <a href="https://www.w3.org/People/Shawn/">Shawn Lawton Henry</a> and Rémi Bétin.</p>
<p>Developed as part of the <a href="https://www.w3.org/WAI/about/projects/wai-coop/">WAI-CooP project</a>, co-funded by the European Commission.</p>
---
Expand Down Expand Up @@ -101,9 +101,13 @@ You are welcome to translate any current WAI resource that you think would be us

The easiest way to find a resource to translate is to head over to the dedicated [translations sitemap for your language](/about/translating/sitemaps/).

Translations sitemaps display the structure of WAI website, and indicate for each page:
- If a translation in this language has been published, and its current status ({% include_cached icon.html name="check-circle" %} Up-to-date or {% include_cached icon.html name="warning" %} Needs update);
- If a page has no translation available in this language, and therefore welcomes a volunteer translation.
### We welcome new subtitles!

If you do not have the time to translate a resource, how about adding new subtitles to our videos?

[Video Introduction](/videos/standards-and-benefits/), [Perspective Videos](/perspective-videos/), [Stories of Web Users](/people-use-web/user-stories/), etc. We have many videos to choose from.

You are very welcome to [create new subtitles](/about/translating/resources/subtitles/) in your language, even if you do not intend to translate the page content.

{% include excol.html type="end" %}

Expand Down
58 changes: 33 additions & 25 deletions pages/about/translating/translations-sitemaps.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "Translations Sitemaps"
nav_title: Translations Sitemaps
lang: en
last_updated: 2024-07-09
last_updated: 2024-08-13
description: Help make the Web accessible to people with disabilities around the world. We appreciate your contributions to translating W3C WAI accessibility resources.

permalink: /about/translating/sitemaps/
Expand All @@ -12,7 +12,7 @@ image: /content-images/about/social-translations.png
feedbackmail: [email protected]

footer: |
<p><strong>Date:</strong> Updated 9 July 2024.</p>
<p><strong>Date:</strong> Updated 13 August 2024.</p>
<p><strong>Editors:</strong> Rémi Bétin and <a href="https://www.w3.org/People/Shawn/">Shawn Lawton Henry</a>.</p>
<p>Developed as part of the <a href="https://www.w3.org/WAI/about/projects/wai-coop/">WAI-CooP project</a>, co-funded by the European Commission.</p>
---
Expand Down Expand Up @@ -47,6 +47,31 @@ We currently have [{{ site.translations-sitemaps.size }} translations sitemaps](

_If you are a new volunteer_, please [send us an e-mail to express your interest](/about/translating/resources/#intent) first.

## List of Translations Sitemaps {#list}

_Languages are listed alphabetically by their English names._

{::nomarkdown}
<ul>
{% for sitemap in site.translations-sitemaps %}
{% assign langname=site.data.lang[sitemap.tlang].name %}
{% assign langnativename=site.data.lang[sitemap.tlang].nativeName %}
<li><a href="{{ sitemap.permalink | relative_url }}"><span lang="sitemap.tlang" style="text-transform: capitalize;">{{ langnativename }}</span> ({{ langname }})</a></li>
{% endfor %}
</ul>
{:/}

{::nomarkdown}
{% include box.html type="start" title="Note" class="simple" %}
{:/}

Translations sitemaps are generated for languages with an active volunteer community.\
If you are an active volunteer and wish to use this feature, feel free to contact us at [[email protected]](mailto:[email protected]).

{::nomarkdown}
{% include box.html type="end" %}
{:/}

## How to use a translation sitemap {#how-to-use}

### Browse the list {#browse}
Expand All @@ -65,33 +90,16 @@ Some WAI Resources are not listed in Translations Sitemaps. That may be because
{:/}

For each resource listed, you can see:
- "WAI Resource" column: the name and URL of the resource, in English;
- "Translation Status" column: the status of the translation
- <p>{% include_cached icon.html name="check-circle" %} Up-to-date + the title and URL of the translation.</p>
- <p>{%- include_cached icon.html name="warning" -%} Translation needs update + the title and URL of the translation. We welcome a volunteer translation update.</p>
- The name and URL of the resource (in English), in the "WAI Resource" column: ;
- The status of the translation, in the "Translation Status" column:
- <p>{% include_cached icon.html name="check-circle" %} Up-to-date. A URL points to the translation.</p>
- <p>{%- include_cached icon.html name="warning" -%} Translation needs update. We welcome a volunteer translation update.</p>
- <p>{% include_cached icon.html name="ex-circle" %} No translation. We welcome a volunteer translation.</p>

### Volunteer to translate a page or to update a translation {#volunteer}

If a resource has not been translated in this language, or if a translation needs update, a link is displayed in the "Translation status" column. For example, "Volunteer to translate this page".

Clicking on this link allows you to declare your intent, by pre-filling a GitHub issue in the [_wai-translations_ repository {% include_cached external.html %}](https://github.com/w3c/wai-translations/).

**After submitting your intent, please always wait for a reply from WAI team**. We will check that the file is not currently being translated by someone else, and that it is not about to be updated.

## List of Translations Sitemaps {#list}

Translations sitemaps are generated for languages with an active volunteer community.\
If you are an active volunteer and wish to use this feature, feel free to contact us at [[email protected]](mailto:[email protected]).

_Languages are listed alphabetically by their English names._
Clicking on this link allows you to declare your intent, by pre-filling a GitHub issue in the [wai-translations repository {% include_cached external.html %}](https://github.com/w3c/wai-translations/).

{::nomarkdown}
<ul>
{% for sitemap in site.translations-sitemaps %}
{% assign langname=site.data.lang[sitemap.tlang].name %}
{% assign langnativename=site.data.lang[sitemap.tlang].nativeName %}
<li><a href="{{ sitemap.permalink | relative_url }}"><span lang="sitemap.tlang" style="text-transform: capitalize;">{{ langnativename }}</span> ({{ langname }})</a></li>
{% endfor %}
</ul>
{:/}
**After submitting your intent, please always wait for a reply from WAI team**. We will check that the file is not currently being translated by someone else, and that it is not about to be updated.

0 comments on commit 4bb876e

Please sign in to comment.