Difference between revisions of "Translation from 4.2"

From Apache OpenOffice Wiki
Jump to: navigation, search
m
 
(18 intermediate revisions by 2 users not shown)
Line 2: Line 2:
 
== Description ==
 
== Description ==
  
This will be a brief documentation of the translation process
+
This will be a brief documentation of the translation process.
There are two steps doing at different time of the translation process.
+
There are two steps to be done at different times of the translation process.
  
 
== From GIT to Pootle Web Frontend ==
 
== From GIT to Pootle Web Frontend ==
Line 11: Line 11:
 
The following graphic shows it. Please click on it to get a larger one.
 
The following graphic shows it. Please click on it to get a larger one.
 
<gallery>
 
<gallery>
File:UebersetzungsProzess_Start.png|Graphical illustration of the technical workflow of the translation process
+
File:UpdateTranslation.png|Graphical illustration of the technical workflow of the update of the translation
 
</gallery>
 
</gallery>
  
Line 31: Line 31:
 
#*:
 
#*:
 
# Creating templates as POT-Files
 
# Creating templates as POT-Files
#* Detailed description using [http://docs.translatehouse.org/projects/translate-toolkit/en/latest/commands/oo2po.html oo2po]
+
#* Detailed description using [https://docs.translatehouse.org/projects/translate-toolkit/en/latest/commands/oo2po.html oo2po]
 
#* ''oo2po --progress=verbose --pot en-US.sdf PotFiles-UI''
 
#* ''oo2po --progress=verbose --pot en-US.sdf PotFiles-UI''
 
#* Now ''PotFiles-UI'' also contains ''helpcontent2''. This is the content for the [[Localization_for_developers#Upload|separate project]] ''Apache OpenOffice 4.x Help''. The subdirectory ''helpcontent2'' has to be moved into the directory ''PotFiles-HELP''.  
 
#* Now ''PotFiles-UI'' also contains ''helpcontent2''. This is the content for the [[Localization_for_developers#Upload|separate project]] ''Apache OpenOffice 4.x Help''. The subdirectory ''helpcontent2'' has to be moved into the directory ''PotFiles-HELP''.  
Line 37: Line 37:
 
# Updating the database with the template files (UI and HELP)
 
# Updating the database with the template files (UI and HELP)
 
#* Detailed description using [https://pootle.readthedocs.io/en/stable-2.5.1/server/commands.html#update-stores pootle update-stores]
 
#* Detailed description using [https://pootle.readthedocs.io/en/stable-2.5.1/server/commands.html#update-stores pootle update-stores]
 +
#* To be prepared for creating new languages
 
#*:
 
#*:
 
# Merge templates with existing PO-Files for each language (UI and HELP)
 
# Merge templates with existing PO-Files for each language (UI and HELP)
#* Detailed description using [https://pootle.readthedocs.io/en/stable-2.5.1/server/commands.html#update-against-templates pootle update-against-templates]
+
#* Detailed description using [https://docs.translatehouse.org/projects/translate-toolkit/en/latest/commands/pomerge.html?highlight=pomerge pomerge]
 
#*:
 
#*:
The steps on the Pootle server can be done with the script ''UpdateTranslation.sh''. This script will be published soon.
+
The steps on the Pootle server can be done with the script [[UpdateTranslation.sh|UpdateTranslation.sh]].  
  
 
# Copy the file ''en.US.sdf'' to the Pootle backend
 
# Copy the file ''en.US.sdf'' to the Pootle backend
Line 50: Line 51:
 
Now the teams can translate the [https://translate.apache.org/projects/aoo40 AOO UI] and the [https://translate.apache.org/projects/aoo40help AOO HELP].
 
Now the teams can translate the [https://translate.apache.org/projects/aoo40 AOO UI] and the [https://translate.apache.org/projects/aoo40help AOO HELP].
  
== From Pootle Web Frontend to SVN ==
+
== From Pootle Web Frontend to Git ==
  
<gallery>
+
[[File:UebersetzungsProzess_Finish.png|90%|Graphical illustration of the technical workflow of the translation process]]
File:UebersetzungsProzess_Finish.png|Graphical illustration of the technical workflow of the translation process
+
</gallery>
+
  
 
=== Steps to do it ===
 
=== Steps to do it ===
Line 62: Line 61:
 
#*:
 
#*:
 
# Create SDF from PO files
 
# Create SDF from PO files
#* Detailed description using [http://docs.translatehouse.org/projects/translate-toolkit/en/latest/commands/oo2po.html?highlight=po2oo po2oo]
+
#* Detailed description using [https://docs.translatehouse.org/projects/translate-toolkit/en/latest/commands/oo2po.html?highlight=po2oo po2oo]
 
#*:
 
#*:
 
# Test SDF files with ''gsicheck''
 
# Test SDF files with ''gsicheck''
Line 73: Line 72:
 
#*:
 
#*:
  
This can be done with scripts, too. the paths have to be adapt to the path
+
This can be done with scripts, too. The paths have to be adapted to the path
  
 
<!-- translation from/for? -->
 
<!-- translation from/for? -->
Line 79: Line 78:
 
[[Category:DE]] <!-- author language -->
 
[[Category:DE]] <!-- author language -->
 
[[Category:EN]] <!-- text language -->
 
[[Category:EN]] <!-- text language -->
 +
 +
[[Category:Localization]]

Latest revision as of 09:12, 23 June 2023

Description

This will be a brief documentation of the translation process. There are two steps to be done at different times of the translation process.

From GIT to Pootle Web Frontend

In this step you prepare the recent code strings for translation. You prepare a template file with all strings that need to be translated. They will be imported into Pootle then.

The following graphic shows it. Please click on it to get a larger one.

Steps to do it

  1. Create a build system
  2. Checkout the recent code base (normally the trunk branch)
  3. Build AOO successfully
  4. Repeat the first build preliminaries (autoconf, configure, bootstrap, source LinX86-64Env.Set.sh)
  5. Create the template as en-US.sdf
    • Command: localize -e -l en-US -f en-US.sdf
  6. Creating templates as POT-Files
    • Detailed description using oo2po
    • oo2po --progress=verbose --pot en-US.sdf PotFiles-UI
    • Now PotFiles-UI also contains helpcontent2. This is the content for the separate project Apache OpenOffice 4.x Help. The subdirectory helpcontent2 has to be moved into the directory PotFiles-HELP.
  7. Updating the database with the template files (UI and HELP)
  8. Merge templates with existing PO-Files for each language (UI and HELP)
    • Detailed description using pomerge

The steps on the Pootle server can be done with the script UpdateTranslation.sh.

  1. Copy the file en.US.sdf to the Pootle backend
    • You need an access to the Pootle server (translate-vm.apache.org)
    • The Pootle server runs under Ubuntu, so you have to be familiar with GNU/Linux.

Now the teams can translate the AOO UI and the AOO HELP.

From Pootle Web Frontend to Git

Graphical illustration of the technical workflow of the translation process

Steps to do it

  1. Synchronize translation database with PO-Files for each language (UI and HELP)
  2. Create SDF from PO files
    • Detailed description using po2oo
  3. Test SDF files with gsicheck
    • This has to be done in a build environment after a successful build
    • Detailed description using gsicheck
    • gsicheck -c -t -l ${Language} ${Language}/localize.sdf
  4. Commit new SDF files into the code

This can be done with scripts, too. The paths have to be adapted to the path

Personal tools