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

Add / update the documentation to translate NVDA's interface (nvda.po) #16656

Closed
CyrilleB79 opened this issue Jun 5, 2024 · 1 comment · Fixed by #16718
Closed

Add / update the documentation to translate NVDA's interface (nvda.po) #16656

CyrilleB79 opened this issue Jun 5, 2024 · 1 comment · Fixed by #16718
Labels
p3 https://github.com/nvaccess/nvda/blob/master/projectDocs/issues/triage.md#priority triaged Has been triaged, issue is waiting for implementation.

Comments

@CyrilleB79
Copy link
Collaborator

Detailed description of the issue

New translators need guidance on how to translate the interface. Currently, there are many translators for new languages or abandoned ones, but they do not seem to go forward and some of them have explicitly asked for help on the translators mailing list.

For now, we have an outdated wiki as well as messages on the mailing list. For someone who has not followed the discussion during the transition, it is hard to know the current process to translate the interface as well as having tips on how to use Crodin.

I was about to write a wiki on how to translate the interface, when #16627 has been opened. Also I am not very comfortable with Crowdin.

Why are the other templates not appropriate in this case?

It is documentation only.

Have you asked for advice on how to report this issue via a community discussion? If so, please link to the discussion

No

Steps to reproduce or illustrate the issue (if applicable)

N/A

Expected outcome or behaviour (if applicable)

N/A

Screenshots, logs, and other attachments (if applicable)

N/A

System configuration or software environment (if applicable)

N/A

Additional information (if applicable)

N/A

@Adriani90
Copy link
Collaborator

I don't know why people are so confused about translating the interface. Actually, there are tons of possibilities to translate strings in a po file, it doesn't have to be crowdin or poedit or what ever.
I am concerned that people expect the NVDA project to give a translating guide for Crowding or Poedit interface, but there are tons of other ways where people can upload the po file and translate it.
The process is as easy as this:
Either:

  1. Log in to the Crowdin NVDA project
  2. Translate the strings of your language in the crowdin interface
  3. Let people with approval rights approve your translations
  4. Done.

Or

  1. Login to the Crowdin NVDA project
  2. Download the .po file of your language from Crowdin NVDA project
  3. Search for the po editor of your choice, or any other website which you are confortable with and make yourself familliar with its interface
  4. Load the downloaded po file into that interface
  5. Translate the strings
  6. Save the file locally
  7. If you don't have approval rights in the Crowdin project, send the translated file to a person from your language translation community who has approval rights
  8. If you have approval rights, upload the translated .po file back to crowdin into your language and enable the checkbox to approve all changes
  9. Done.

I think also Crowdin has a really comprehensive user guide and documentation. In my view the NVDA project should not be responsible for giving people a full user guide for an external interface.
We can give recommendations, and explain the NVDA translation process. But explaining the Crowdin or Poedit interface should not be in scope of the guide.

cc: @michaelDCurran

@seanbudd seanbudd added this to the 2024.3 milestone Jun 6, 2024
@seanbudd seanbudd added triaged Has been triaged, issue is waiting for implementation. p3 https://github.com/nvaccess/nvda/blob/master/projectDocs/issues/triage.md#priority labels Jun 10, 2024
@seanbudd seanbudd removed this from the 2024.3 milestone Jun 26, 2024
seanbudd added a commit that referenced this issue Jul 2, 2024
Closes #16656

Summary of the issue:
NV Access is intending to move most of the wiki into the repository, so changes are tracked better and easier to propose.
The documentation for translating NVDA is very dated, particularly since the update of the translation system.

Description of user facing changes
This wiki page was moved and updated in the project docs

Translating the interface
The following changes were made to update the contents:

grammar and formatting fixes
add reference to user guide commands for PoEdit
remove section on translating using a text editor
added information on:
on using Crowdin and proofreader status
plural forms
pgettext (context/tags)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
p3 https://github.com/nvaccess/nvda/blob/master/projectDocs/issues/triage.md#priority triaged Has been triaged, issue is waiting for implementation.
Projects
None yet
Development

Successfully merging a pull request may close this issue.

3 participants