I want to start the process and a team for translating the User Guide to Ukrainian, along with podarok, Ukrainian localization team manager. Our localization team is Drupal translation leader and was first, which fully translated Drupal 8 core.
This issue is to track progress on setting up for translations into Ukrainian.
Tasks:
- [DONE] Add a new issue component for translations into this new language, by editing the Project page. The component should be called "UK translation".
- [DONE] Make a new source/uk directory. Copy all of the source (English) files, including the images subdirectory, into the new directory. Keep the file names and IDs the same as they were in English.
- [DONE] Add a new section to the _attributions.txt_ file for the translation team management for this language. Template:
==== Translation into Ukrainian The Ukrainian translation of this guide was coordinated by: * https://www.drupal.org/u/podarok[Andrii Podanenko] * https://www.drupal.org/u/anprok[Andrii Prokopenko] - [DONE] Make a separate issue for the screenshots. See Guidelines document for issue template.
- [DONE] Grant issue maintainer and VCS commit permissions to the manager or managers of the language team for the new language, by editing the Maintainers page for the project. Note: Language team managers will need to re-clone their Git repositories using "Maintainer" mode after receiving this permission, in order to be able to commit to the repository.
- []Make issues for translating each topic into the target language. There is a spreadsheet file scripts/bookmarks.fods that will aid in doing this. You will need to translate the guide-docinfo.xml file, as well as all of the .txt files in the source directory.
- At least one leader of the translation group needs to subscribe to the email list the project uses for notifications about updates to the English source that require translations to be updated. This is at: [EMAIL_LIST]
- [DONE - there was a file for Ukrainian, so translations are done] Copy the English configuration file scripts/lang-en.conf to file name lang-lc.conf, where lc is the language code. Optionally, check https://github.com/asciidoc/asciidoc to see if there is an existing language configuration file for that language, and copy the three lines we need in our language configuration file from there, so that they are translated already.
- [Status: the files have been edited so the headers are in Ukrainian already. You should still probably add this note to the guide.txt and glossary.txt issues when they are created.] Add notes to the guide.txt and glossary.txt file translation issues, that when the chapter headers for the Preface, Index, and Glossary sections are translated, the lang-lc.conf file translations of these same words need to be done at the same time. Suggested note:
When this translation is done, make sure to update the scripts/lang-lc.conf (for your language code) at the same time so the chapter headings for Preface, Index, and Glossary in that file match what is in the source file for this issue.However, if you found an existing lang-lc.conf file on Github, you should instead edit the guide.txt and glossary.txt files so that these headings match the translations you put in.
- [DONE] Add langcode to the build scripts in scripts/languages.txt, and verify that it builds without errors.
- Decide whether your team wants to use translation memory software or not. You can read more about this in the Translation Memory section of the User Guide Contributor Guidelines - Project Management page.
- Optional but recommended steps:
- Make a translation glossary for this language. File scripts/TermsToTranslate.fods is a good starting point. This should be located in a place that the language team normally uses for communication, such as on localize.drupal.org.
- Create an issue to track translation progress. It should list the individual translation issues, providing a place to look to see which are done and which still need to be done. You can make a list of the issues in the issue summary by following these steps:
- Open the Issues page for the project.
- Filter to the issue component for your translation. You'll see the first page of issues.
- Open a JavaScript console tool in your browser (usually by using the Inspect or Inspect Element context menu).
- Execute this JavaScript code to make a list of the issue numbers shown on this page:
jQuery("tbody .views-field-title a").each( function(){ console.log("[#" + jQuery(this).attr("href").replace("/node/", "") + "]"); } ); - Copy and paste the output into the issue summary.
- Go to the next page of issues and repeat the JavaScript, until all issues have been found.
- Start translating!
Comments
Comment #2
jhodgdonHi anprok! Three quick questions before we get started:
1. Are you coordinating with the other members of the Ukranian translation team on localize.drupal.org , or are you one of the Ukranian team leaders?
2. Do you have any Git experience, or experience with managing projects on drupal.org? I don't see anything on your profile about that. We need to have someone to lead the team who is comfortable making Git commits.
3. I was going to ask if Drupal Core was translated into Ukranian, but localize.drupal.org says it is 100% translated, so that is excellent. :)
Comment #3
anprok commentedRe:
Comment #4
podarokHi @jhodgdon
re:
1 I'm translation team manager and asked Andrii to help with this issue, so yes to your question
2 yes
3 yes, and it is going to be such in a future )))
Comment #5
podarokSo, in regards to the issue itself, would be awesome to get all the needed infrastructure set up and running for Ukrainian team.
We are going to make progress as soon as it is ready.
Any help and guides would be appreciated @jhodgdon
Comment #6
jhodgdonYes, I'll get started on this shortly... should be able to take care of my parts today... Who should we add to the project maintainers list to make commits then, podarok or anprok?
Comment #7
jhodgdonI have taken care of several of the items... you can start making issues. See also #6... Also I added a couple of steps (also marked Done), which are part of the process but the Project Managers Guide on drupal.org hasn't yet been updated to include them (it's in the source but hasn't been updated on drupal.org yet, should be shortly).
Comment #9
anprok commentedComment #10
jhodgdonSo... Who will be making commits to Git for the Ukranian team -- podarok or anprok? Or both?
Comment #11
anprok commentedComment #12
anprok commentedLets both will be making commit for Ukrainian team.
Thanks
Comment #13
podarokHey @jhodgdon
Thanks a lot for initial steps
If you need only one name - use Andrii Podanenko @podarok there
But if it is possible to add both of us - add Andriy Prokopenko @anprok as well
Thank you
Comment #14
jhodgdonI've added you both as maintainers, with permission to commit to Git and maintain/assign issues in the project.
I think your only remaining step here is to make your individual "translate each topic" issues, and start translating. I do definitely also recommend maintaining a glossary list for common terms (see issue summary), which you may want to put on localize.drupal.org or wherever your group communicates.
Welcome, and happy translating!
Comment #15
podarok@jhodgdon thank you so much!
Comment #16
jhodgdonUpdating the issue summary: rather than using a spreadsheet to track progress, we are now recommending an issue instead (see last step in summary).
Comment #17
jhodgdontypo
Comment #18
anprok commentedComment #19
jhodgdonAdding related issue for the Screenshots issue, which was created a few months ago.
Comment #20
anprok commentedComment #21
anprok commentedComment #22
jhodgdonI'm happy to see the recent updates on the Ukranian translation -- let me know if I can be of any help or if you have any questions (you can post questions on this issue).