This issue is to track progress on setting up for translations into German.

Tasks:

  1. [DONE] - Add a new issue component for translations into this new language, by editing the Project page. The component should be called "DE translation".
  2. [DONE] Make a new source/de 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.
  3. [DONE] Add a new section to the attributions.txt file for the translation team management for this language. Template:
    ==== Translation into German
    
    The German translation of this guide was coordinated by:
    
    * https://www.drupal.org/u/person1[Person One]
    
    * https://www.drupal.org/u/person2[Person Two] of http://example.com[Company]
    
  4. [DONE] Make a separate issue for the screenshots. See Guidelines document for issue template.
    #2879097: [DE] German screenshots
  5. [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.
  6. [DONE] Make issues for translating each topic into the target language. There is a spreadsheet file scripts/bookmarks.fods that will aid in doing this.
  7. [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.
  8. [DONE] 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.

  9. [DONE] Add de to the build scripts in scripts/languages.txt, and verify that it builds without errors.
  10. [DONE] One of the leaders of the de translation group needs to subscribe to the email list used to notify translation groups of changes to the English source: https://groups.google.com/forum/#!forum/d8manual
  11. Optional but recommended steps:
    • [TODO] 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. NOTE: We will share the glossary that is already being used by the German localization team: https://docs.google.com/spreadsheets/d/1JGZWWUQGBsXg30aax-0-yQM_KW8vZs9n...
    • [NOT NEEDED]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:
      1. Open the Issues page for the project.
      2. Filter to the issue component for your translation. You'll see the first page of issues.
      3. Open a JavaScript console tool in your browser (usually by using the Inspect or Inspect Element context menu).
      4. 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/", "") + "]");
              }
        );
        
      5. Copy and paste the output into the issue summary.
      6. Go to the next page of issues and repeat the JavaScript, until all issues have been found.
  12. Start translating!

Comments

michaellenahan created an issue. See original summary.

michaellenahan’s picture

  • e46b090 committed on 8.x-2.x
    Issue #2879080 by michaellenahan: Set up for German translations
    
michaellenahan’s picture

TODO @michaellenahan

6. Make issues for translating each topic into the target language. There is a spreadsheet file scripts/bookmarks.fods that will aid in doing this.

10.1. 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.

10.2. 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.

joachim namyslo’s picture

Dear Michael,

If you take an educated guess. Will, this be done before Heidelberg or will everything be setup in early august more likely?

eojthebrave’s picture

Issue summary: View changes

Marking a couple of items in the summary as complete since I took care of them earlier. Adding a new maintainer and creating the "de" language component.

michaellenahan’s picture

The issues have now been created: https://www.drupal.org/project/issues/search/user_guide?project_issue_fo...

Many thanks to fisherman90 and loonyluna for the German translations of the issues.

Thanks also to @balu-ertl for your epic work in creating the issue-creation spreadsheet.

TODO:

11.1. 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.

The general German Drupal Glossary is here: https://docs.google.com/spreadsheets/d/1JGZWWUQGBsXg30aax-0-yQM_KW8vZs9n...

fisherman90 and loonyluna took this glossary into account when translating the issue texts.

The Userguide Glossary scripts/TermsToTranslate.fods needs to be merged with this. @darth_zwergal

11.2. 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.

darth_zwergal’s picture

@michmichaellenahan you should be able to access the German Glossary now ;)

jhodgdon’s picture

Component: Project management » DE translation
Issue summary: View changes

A belated welcome to the User Guide translation process!

Updating summary with [DONE] on the finished items. I wasn't sure on a couple of them, so left them blank. Also I moved this issue into the new DE component.

jhodgdon’s picture

Issue summary: View changes

On #2871873: Change process for notifying translation groups about source changes, we are modifying the procedures we will use for notifying translation groups when English source files have changed in ways that require translations to change. You can see the new procedure there, which is very close to being adopted. Basically:
- Issues changing English source in significant ways will have a "Translation updates needed" tag on them.
- When such an issue is finalized in English, we'll send out a notification to an email list (on Google Groups) to let translation groups know about the change.
- Each translation group will then take appropriate action, such as opening an issue to modify their translation, copying the new English source file to their language if it hasn't been translated yet, or maybe even doing nothing if they decide that's most appropriate.

The first such issue has just been finalized: #2874565: Better table structure for planning-data-types.txt -- so you'll want to copy the planning-data-types.txt file from EN to DE source.

Also, I'm adding a To Do to the list in this issue -- someone from the DE group needs to subscribe to the Google Group at
https://groups.google.com/forum/#!forum/d8manual

jhodgdon’s picture

Issue summary: View changes

Oh wait, I see that Michale Lenahan is already subscribed to the email list. Great! Marking this step as done.

michaellenahan’s picture

Issue summary: View changes
michaellenahan’s picture

Marked a couple more things as DONE.

Still TODO @michaellenahan

11.1 The Userguide Glossary scripts/TermsToTranslate.fods needs to be merged with the standard German-language glossary maintained by the German localization team. I will add the missing English strings, but will leave the German translations blank, because I am leaving the actual translation to the native speakers of German ;). Thanks to @darth_zwergal and @grienauer for assigning the edit rights.

11.2. 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.
--- hmm this is still to do but I'm not sure what such a progress tracking issue looks like --- can someone point me to one from one of the other languages? Then I will base the German one on that.

jhodgdon’s picture

Regarding the issue to track progress, I am not sure that it is necessary at all, since you can just go to the User Guide issues page and filter on component "DE translation" to see the status of all of your issues.

But if you want to make such an issue, here's an example (French):
https://www.drupal.org/node/2837749
Basically you'd want to make an issue summary that has lines like

[#1234567]

where 1234567 is an issue number.

Oh, actually this issue's summary has steps you can use to make the issue list.

michaellenahan’s picture

@jhodgdon - thanks for clarifying - I don't think we really need that progress tracking issue either.

michaellenahan’s picture

Issue summary: View changes

Balu Ertl credited jungle.

baluertl’s picture

Issue tags: +DrupalBCDays

As we agreed with Michael Lenahan, it still can be useful to track their progress even if it's not a not a separate issue but only here a comment:
#2879784: [DE] Übersetzung von: user-concept.txt
#2879730: [DE] Übersetzung von: understanding-themes.txt
#2879729: [DE] Übersetzung von: understanding-modules.txt
#2879728: [DE] Übersetzung von: understanding-drupal.txt
#2879839: [DE] Übersetzung von: copyright.txt
#2879726: [DE] Übersetzung von: preface-conventions.txt
#2879725: [DE] Übersetzung von: preface-reporting.txt
#2879724: [DE] Übersetzung von: preface-organization.txt
#2879723: [DE] Übersetzung von: preface-audience.txt
#2879727: [DE] Übersetzung von: preface-scenario.txt
#2879837: [DE] Übersetzung von: attributions.txt
#2879836: [DE] Übersetzung von: glossary.txt
#2879835: [DE] Übersetzung von: thoughts-learn-more.txt
#2879834: [DE] Übersetzung von: thoughts-support.txt
#2879833: [DE] Übersetzung von: thoughts-connecting.txt
#2879832: [DE] Übersetzung von: security-update-theme.txt
#2879831: [DE] Übersetzung von: security-update-module.txt
#2879830: [DE] Übersetzung von: security-update-core.txt
#2879829: [DE] Übersetzung von: security-announce.txt
#2879828: [DE] Übersetzung von: security-concept.txt
#2879826: [DE] Übersetzung von: security-cron.txt
#2879825: [DE] Übersetzung von: security-cron-concept.txt
#2879824: [DE] Übersetzung von: prevent-status.txt
#2879823: [DE] Übersetzung von: prevent-log.txt
#2879822: [DE] Übersetzung von: prevent-backups.txt
#2879821: [DE] Übersetzung von: prevent-cache-clear.txt
#2879820: [DE] Übersetzung von: prevent-cache.txt
#2879819: [DE] Übersetzung von: extend-config-versions.txt
#2879818: [DE] Übersetzung von: extend-deploy.txt
#2879817: [DE] Übersetzung von: install-composer.txt
#2879816: [DE] Übersetzung von: install-dev-making.txt
#2879815: [DE] Übersetzung von: install-dev-sites.txt
#2879814: [DE] Übersetzung von: extend-manual-install.txt
#2879813: [DE] Übersetzung von: extend-theme-install.txt
#2879811: [DE] Übersetzung von: extend-theme-find.txt
#2879810: [DE] Übersetzung von: extend-module-install.txt
#2879809: [DE] Übersetzung von: extend-maintenance.txt
#2879808: [DE] Übersetzung von: extend-module-find.txt
#2879807: [DE] Übersetzung von: language-config-translate.txt
#2879806: [DE] Übersetzung von: language-content-translate.txt
#2879805: [DE] Übersetzung von: language-content-config.txt
#2879802: [DE] Übersetzung von: language-add.txt
#2879801: [DE] Übersetzung von: language-concept.txt
#2879800: [DE] Übersetzung von: views-block.txt
#2879799: [DE] Übersetzung von: views-duplicate.txt
#2879798: [DE] Übersetzung von: views-create.txt
#2879797: [DE] Übersetzung von: views-parts.txt
#2879796: [DE] Übersetzung von: views-concept.txt
#2879795: [DE] Übersetzung von: block-place.txt
#2879794: [DE] Übersetzung von: block-create-custom.txt
#2879793: [DE] Übersetzung von: block-concept.txt
#2879792: [DE] Übersetzung von: user-content.txt
#2879789: [DE] Übersetzung von: user-roles.txt
#2879788: [DE] Übersetzung von: user-permissions.txt
#2879787: [DE] Übersetzung von: user-new-user.txt
#2879786: [DE] Übersetzung von: user-new-role.txt
#2879785: [DE] Übersetzung von: user-admin-account.txt
#2879783: [DE] Übersetzung von: structure-text-format-config.txt
#2879782: [DE] Übersetzung von: structure-text-formats.txt
#2879781: [DE] Übersetzung von: structure-image-responsive.txt
#2879780: [DE] Übersetzung von: structure-image-style-create.txt
#2879779: [DE] Übersetzung von: structure-image-styles.txt
#2879778: [DE] Übersetzung von: structure-content-display.txt
#2879777: [DE] Übersetzung von: structure-view-modes.txt
#2879776: [DE] Übersetzung von: structure-form-editing.txt
#2879775: [DE] Übersetzung von: structure-widgets.txt
#2879774: [DE] Übersetzung von: structure-adding-reference.txt
#2879772: [DE] Übersetzung von: structure-taxonomy-setup.txt
#2879771: [DE] Übersetzung von: structure-taxonomy.txt
#2879767: [DE] Übersetzung von: structure-reference-fields.txt
#2879766: [DE] Übersetzung von: structure-fields.txt
#2879765: [DE] Übersetzung von: structure-content-type-delete.txt
#2879763: [DE] Übersetzung von: structure-content-type.txt
#2879762: [DE] Übersetzung von: menu-reorder.txt
#2879760: [DE] Übersetzung von: menu-link-from-content.txt
#2879759: [DE] Übersetzung von: menu-concept.txt
#2879758: [DE] Übersetzung von: menu-home.txt
#2879756: [DE] Übersetzung von: content-in-place-edit.txt
#2879755: [DE] Übersetzung von: content-edit.txt
#2879754: [DE] Übersetzung von: content-create.txt
#2879753: [DE] Übersetzung von: content-paths.txt
#2879752: [DE] Übersetzung von: config-theme.txt
#2879751: [DE] Übersetzung von: config-user.txt
#2879750: [DE] Übersetzung von: config-uninstall.txt
#2879748: [DE] Übersetzung von: config-install.txt
#2879746: [DE] Übersetzung von: config-basic.txt
#2879745: [DE] Übersetzung von: config-overview.txt
#2879744: [DE] Übersetzung von: install-run.txt
#2879743: [DE] Übersetzung von: install-prepare.txt
#2879742: [DE] Übersetzung von: install-tools.txt
#2879741: [DE] Übersetzung von: install-requirements.txt
#2879740: [DE] Übersetzung von: planning-workflow.txt
#2879739: [DE] Übersetzung von: planning-structure.txt
#2879738: [DE] Übersetzung von: planning-modular.txt
#2879737: [DE] Übersetzung von: planning-data-types.txt
#2879736: [DE] Übersetzung von: planning-layout.txt
#2879735: [DE] Übersetzung von: block-regions.txt
#2879734: [DE] Übersetzung von: understanding-gpl.txt
#2879733: [DE] Übersetzung von: understanding-project.txt
#2879732: [DE] Übersetzung von: understanding-data.txt
#2879731: [DE] Übersetzung von: understanding-distributions.txt
#2879722: [DE] Übersetzung von: guide.txt

@jungle Thanks again for your JS-snippet shared in #2832894: Suggest creating an issue per language to track translation progress.

michaellenahan’s picture

Thanks @balu-ertl (and @jungle). I see the point of having a proper translation tracking issue now, so I've created one here: https://www.drupal.org/node/2917376

joachim namyslo’s picture

Status: Active » Fixed

Now that this issue is closed, please review the contribution record.

As a contributor, attribute any organization that helped you, or if you volunteered your own time.

Maintainers, please credit people who helped resolve this issue.

Status: Fixed » Closed (fixed)

Automatically closed - issue fixed for 2 weeks with no activity.