Difference between revisions of "Translation from 4.2"

From Apache OpenOffice Wiki
Jump to: navigation, search
(→‎Steps to do it)
m
 
(21 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 SVN 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 are imported into Pootle.
+
== 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.
 
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 20: Line 21:
 
#*:
 
#*:
 
# Checkout the recent code base (normally the trunk branch)
 
# Checkout the recent code base (normally the trunk branch)
−
#* ''svn co https://svn.apache.org/repos/asf/openoffice/trunk aoo''
+
#* ''git clone https://gitbox.apache.org/repos/asf/openoffice.git'' #(Since 2019-08.03)
−
:  ''git clone https://gitbox.apache.org/repos/asf/openoffice.git'' #(Since 2019-08.03)
+
 
#*:
 
#*:
 
# Build AOO successfully
 
# Build AOO successfully
 +
#*:
 +
# Repeat the first build preliminaries (autoconf, configure, bootstrap, source LinX86-64Env.Set.sh)
 
#*:
 
#*:
 
# Create the template as ''en-US.sdf''
 
# Create the template as ''en-US.sdf''
−
#* Detailed description using [[Localization_for_developers#Extraction|solenv/bin/localize]]
 
 
#* Command: ''localize -e -l en-US -f en-US.sdf''
 
#* Command: ''localize -e -l en-US -f en-US.sdf''
−
#*:
 
−
# Copy the file ''en.US.sdf'' to the Pootle backend
 
−
#* You need an access to the Pootle server ([https://translate-vm.apache.org translate-vm.apache.org])
 
−
#* The Pootle server runs under Ubuntu, so you have to be familiar with GNU/Linux.
 
 
#*:
 
#*:
 
# 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 40: 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|UpdateTranslation.sh]].
 +
 
 +
# Copy the file ''en.US.sdf'' to the Pootle backend
 +
#* You need an access to the Pootle server ([https://translate-vm.apache.org translate-vm.apache.org])
 +
#* The Pootle server runs under Ubuntu, so you have to be familiar with GNU/Linux.
 
#*:
 
#*:
−
The steps on the Pootle server can be done with the script ''UpdateTranslation.sh''. This script will be published soon.
 
  
 
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 60: 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 71: 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 77: 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.

  • Graphical illustration of the technical workflow of the update of the translation

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

Retrieved from "https://wiki.openoffice.org/w/index.php?title=Translation_from_4.2&oldid=256835"
Personal tools