Basics

If you want to become a translator for phpVirtualBox, join the Google Group phpvbox-translate located at: http://groups.google.com/group/phpvbox-translate

phpVirtualBox uses VirtualBox's translations for most of its text. This reduces the amount of text one must translate for phpVirtualBox to less than 60 items. As a result, only languages available to VirtualBox may be translated for phpVirtualBox:

• ﺎﻠﻋﺮﺒﻳﺓ ar
• Български (България) bg
• Català ca
• Català (valencià) ca_VA
• Čeština cs
• Dansk da
• Deutsch de
• Ελληνικά el
• Español es
• Euskara eu
• Suomi (Suomi) fi
• Français fr
• Galego (España) gl_ES
• Magyar hu
• Bahasa Indonesia id
• Italiano it
• 日本語 ja
• ខ្មែរ km_KH
• 한국어 ko
• Lietuvių lt
• Nederlands nl
• Polski pl
• Português (Brasil) pt_BR
• Português pt
• Română ro
• Русский ru
• Slovenčina sk
• Српски sr
• Svenska sv
• Türkçe tr
• Українська uk
• 简体中文 (中国) zh_CN
• 正體中文 (臺灣) zh_TW

Languages crossed out above have already been translated for phpVirtualBox.

To translate phpVirtualBox, locate a language XML file in phpVirtualBox's languages folder. For instance, de.xml. The file will have entries that look similar to:

<?xml version="1.0" encoding="utf-8"?>
<language>
	<context>
		<name>phpVirtualBox</name>
		<message>
			<source>Warning: A VirtualBox internal operation is in progress. Closing this window or navigating away from this web page may cause unexpected and undesirable results. Please wait for the operation to complete.</source>
			<translation>Warnung: Interne Aktion läuft. Wenn Sie dieses Fenster schließen oder diese Seite verlassen, kann das zu unerwünschten oder unbeabsichtigten Effekten führen. Bitte warten Sie bis die Aktion abgeschlossen ist.</translation>
		</message>
		<message>
			<source>Operation Canceled</source>
			<translation>Aktion abgebrochen</translation>
		</message>
                 ......

You will see translation messages such as:

<message>
   <source>Operation Canceled</source>
   <translation>Aktion abgebrochen</translation>
</message>

Text within the <source> tag is the text that is to be translated. The translated text goes in the <translation> tag. E.g.

<message>
   <source>Operation Canceled</source>
   <translation>Your translation of "Operation Canceled" goes here...</translation>
</message>

Translate the file, then send it to the mailing list. It should appear in the next version of phpVirtualBox.

Character Encoding

All translations should use UTF-8 encoding.

• Using Notepad in Windows, you may select UTF-8 encoding in the Save as... dialog.
• Using vi, you may enter the command :set enc=utf-8

Other text editors should have some way to change / set the encoding used.