Difference between revisions of "Translations"
(rework and mention docs as primary, more up to date resource) |
|||
| (23 intermediate revisions by 11 users not shown) | |||
| Line 1: | Line 1: | ||
| − | + | {{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}} | |
| − | |||
| − | == | + | == Translation Flow == |
| − | |||
| − | |||
| − | |||
| − | + | 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: | |
| − | |||
| − | |||
| − | |||
| − | + | 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 xx.po >pve-lang-xx.js | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | + | 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. | |
| − | |||
| − | |||
| − | |||
| − | == | + | == How to Edit Translation Files == |
| − | |||
| − | |||
| − | |||
| − | + | The translations can be done by using [http://www.poedit.net/ poedit], an easy to use editor specialized for PO files. You can also use a common text editor, for example, <code>vim</code>, <code>Emacs</code> or <code>Notepad</code>. There is no programming knowledge necessary to translate. If you want to submit a new or updated translation, just contact office(at)proxmox.com. | |
| − | |||
| − | |||
| − | |||
| − | == | + | == Submitting Updated or New Translations == |
| − | |||
| − | |||
| − | |||
| − | + | You can send finished translation to the Proxmox team using the office(at)proxmox.com email address. Remember to include a signed contributor licence agreement if not already present, see [[Developer Documentation#Software License and Copyright]] for details. | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | [ | ||
[[Category: HOWTO]] | [[Category: HOWTO]] | ||
Revision as of 12:45, 25 August 2021
|
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 xx.po >pve-lang-xx.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. If you want to submit a new or updated translation, just contact office(at)proxmox.com.
Submitting Updated or New Translations
You can send finished translation to the Proxmox team using the office(at)proxmox.com email address. Remember to include a signed contributor licence agreement if not already present, see Developer Documentation#Software License and Copyright for details.