Translations: Difference between revisions

From Proxmox VE
Jump to navigation Jump to search
No edit summary
No edit summary
 
(8 intermediate revisions by 5 users not shown)
Line 1: Line 1:
== Version 4.x ==
{{Note| This article is not actively maintained, see the reference documentation for an up to date guide https://pve.proxmox.com/pve-docs/pve-admin-guide.html#translation|reminder}}


Language files are located at git repository:
== Translation Flow ==
[https://git.proxmox.com/?p=pve-manager.git;a=tree;f=po;h=d5a14531b7b572c0c79c3a70aafa8a3fac933dd4;hb=HEAD git.proxmox.com pve-manager]


* You can create new translation by coping messages.pot template file to new file named according your language code. Then use some gettext translation tool like Poedit, Lokalize, Gtranslator.
Language files are located in the [https://git.proxmox.com/?p=proxmox-i18n.git;a=tree git.proxmox.com proxmox-i18n] git repository, you can download them through the webinterface or clone the whole repository locally using git:
* Po file need to be translated to .js file by invoking script located at same directory:
<pre>./po_po2js.pl xx.po >pve-lang-xx.js</pre>


* You need to have installed some perl packages in your system. For Ubuntu:
git clone git://git.proxmox.com/git/proxmox-i18n.git
<pre>apt-get install perl liblocale-po-perl libjson-perl</pre>


* Resulted file '''pve-lang-xx.js''' copy to directory '''/usr/share/pve-manager/locale''' on your proxmox server.
You can then create new translation with (replace <LANG> with the language ID)
Then you need to add your new language to '''/usr/share/pve-manager/ext4/pvemanagerlib.js''' to '''language_map''' array and logout and login back to server web administration interface to reload available language list.


* You can send finished translation to proxmox team to office(at)proxmox.com with signed contributor licence agreement. See [[Developer Documentation]]
cd proxmox-i18n
make init-<LANG>.po


== Version 3.x ==
For testing your work in the web-interface you need to translate the PO files to a .js file by invoking script located at same directory.
First install all required dependencies for that script, for Ubuntu or Debian based system you would do that with:
apt install perl liblocale-po-perl libjson-perl


Language files are located at git repository:
Then run the script:
[https://git.proxmox.com/?p=pve-manager.git;a=tree;f=po;h=d5a14531b7b572c0c79c3a70aafa8a3fac933dd4;hb=HEAD git.proxmox.com pve-manager]
./po2js.pl -t pve xy.po >pve-lang-xy.js


* You can create new translation by coping messages.pot template file to new file named according your language code. Then use some gettext translation tool like Poedit, Lokalize, Gtranslator.
The resulting file <code>pve-lang-xx.js</code> should be copied to the <code>/usr/share/pve-i18n/</code> directory on your Proxmox VE server.
* Po file can be translated to .js file by invoking script located at same directory:
<pre>./po_po2js.pl lang.po>lang.js</pre>


* You need to have installed perl packaged in your system:
== How to Edit Translation Files ==
<pre>apt-get install perl liblocale-po-perl libjson-perl</pre>


* Resulted file lang.js move directory /usr/share/pve-manager/root on your proxmox server.
The translations can be done by using [http://www.poedit.net/ poedit], an easy-to-use editor specialized for PO files.
Then you need to add your new language to /usr/share/pve-manager/ext4/pvemanagerlib.js to language_map array and logout and login back to server web administration interface to reload refresh available language list.


* You can send finished translation to proxmox team to office(at)proxmox.com
You can also use a common text editor, for example: <code>vim</code>, <code>Emacs</code> or <code>Notepad</code>.


Proxmox VE 2.x management interface is also available in the following languages.
There is no programming knowledge necessary to translate.


=== Basque ===
== Submitting Updated or New Translations ==
*Maintainer: Xabier Isla
*Email: garapen(at)uharte.com
*Web: [http://www.uharte.com Uharte]


== Version 1.x ==
You can send finished translation to the Proxmox team by either using
* our git email patch work flow, see [[Developer Documentation#Preparing_Patches|Developer Documentation#Preparing_Patches]]
: Note that large patch emails are automatically queued for moderation, so it may take a bit until it shows up.
* the full updated <code>xy.po</code> file office(at)proxmox.com email address.


Proxmox VE 1.x management interface is available in the following languages.
Remember to include a signed contributor license agreement if not already present, see [[Developer Documentation#Software License and Copyright]] for details.
 
Where should the '''po''' files (or the compiled '''mo''' files) be placed?
 
===English===
*Maintainer: Proxmox support team
*Email: support(at)proxmox.com
*Web: [http://www.proxmox.com Proxmox]
 
===German===
*Maintainer: Proxmox support team
*Email: support(at)proxmox.com
*Web: [http://www.proxmox.com Proxmox]
 
===French===
*Maintainer: Yacine Kheddache
*Email: support(at)alyseo.com
*Web: [http://www.alyseo.com Alyseo]
 
===Italian===
*Maintainer: Angelo Volpato
*Email: angelov72(at)yahoo.it
 
===Hungarian===
*Maintainer: Pongracz Istvan
*Email: pongracz.istvan(at)startit.hu
*Web: [http://www.startit.hu StartIT]
 
===Dutch===
*Maintainer: Erwin de Brueijs
*Email: erwin(at)123xs.com
*Web: [http://www.123xs.com 123xs]
 
===Romanian===
*Maintainer: Nick Tiloi
*Email: nick.tiloi(at)gmail.com
*Web: [http://www.magica.ro MagicaIT]
   
===Spanish===
*Maintainer: Fabio Vasco Gomes
*Email: fvasco(at)gmail.com
*Web:
 
===Portuguese===
*Maintainer: Bruno Cacheira
*Email: bruno.cacheira(at)neoscopio.com
*Web: [http://www.neoscopio.com Neoscopio]
 
===Portuguese (br)===
*Maintainer: Fabio Vasco Gomes
*Email: fvasco(at)gmail.com
*Web:
 
===Russian===
*Maintainer: Antipov Dima
*Email: tdcmystere(at)gmail.com
*Web: [http://www.streamhost.biz Streamhost]
 
===Turkish===
*Maintainer: Sukru Emre Erim
*Email: emre(at)medyabim.com
*Web: [http://www.medyabim.com.tr Medyabim]
 
===Czech===
*Maintainer: Chronos
*Email: robie(at)centrum.cz
*Web:
 
===Japanese===
*Maintainer: Koichi MATSUMOTO
*Email: mzch(at)me.com
*Web: [http://maccoterie.com MacCoterie]
 
== How to translate into different languages ==
The translations can be done by using [http://www.poedit.net/ poedit], an easy to use editor or any other editor you prefer, e.g. Emacs. There is no programming knowledge necessary to translate. If you want to translate, just contact office(at)proxmox.com.
 
== PO files ==
All released translation file are available. All maintainers can pick these file if the translation needs rework.
 
* [ftp://download.proxmox.com/sources/po-files/ Proxmox VE translations]


[[Category: HOWTO]]
[[Category: HOWTO]]

Latest revision as of 07:29, 5 December 2022

Yellowpin.svg Note: This article is not actively maintained, see the reference documentation for an up to date guide https://pve.proxmox.com/pve-docs/pve-admin-guide.html#translation

Translation Flow

Language files are located in the git.proxmox.com proxmox-i18n git repository, you can download them through the webinterface or clone the whole repository locally using git:

git clone git://git.proxmox.com/git/proxmox-i18n.git

You can then create new translation with (replace <LANG> with the language ID)

cd proxmox-i18n
make init-<LANG>.po

For testing your work in the web-interface you need to translate the PO files to a .js file by invoking script located at same directory. First install all required dependencies for that script, for Ubuntu or Debian based system you would do that with:

apt install perl liblocale-po-perl libjson-perl

Then run the script:

./po2js.pl -t pve xy.po >pve-lang-xy.js

The resulting file pve-lang-xx.js should be copied to the /usr/share/pve-i18n/ directory on your Proxmox VE server.

How to Edit Translation Files

The translations can be done by using poedit, an easy-to-use editor specialized for PO files.

You can also use a common text editor, for example: vim, Emacs or Notepad.

There is no programming knowledge necessary to translate.

Submitting Updated or New Translations

You can send finished translation to the Proxmox team by either using

Note that large patch emails are automatically queued for moderation, so it may take a bit until it shows up.
  • the full updated xy.po file office(at)proxmox.com email address.

Remember to include a signed contributor license agreement if not already present, see Developer Documentation#Software License and Copyright for details.