Initial commit

2011-03-29 21:51:22 +04:00
commit b5f9941788
422 changed files with 128744 additions and 0 deletions
@@ -0,0 +1,84 @@
+Translator Info
+---------------
+
+If you like phpPgAdmin, then why not translate it into your native language?
+
+Translation is slightly complicated in phpPgAdmin compared to other PHP
+software, since we support viewing database encodings that are different to
+your language encoding.
+
+Also, there are quite a large number of strings to be translated.  Partial
+translations are better than no translations at all, and a rough guide is that
+the strings are in the order from most important to least important in the
+language file.  You can ask the developers list if you don't know what a
+certain string means.
+
+To translate messages, you will need to install GNU Recode on your computer.
+
+GNU Recode: http://www.gnu.org/software/recode/recode.html
+
+Your favourite OS should have a GNU Recode package available. (See bottom for
+details.)
+
+Once you have Recode installed, these are the steps to creating a new
+translation:
+
+1. Go to the lang/ subdirectory
+
+2. Copy english.php to yourlanguage.php
+
+3. Update the comment at the top of the file.  Put yourself as the language 
+   maintainer. Edit the 'applang' variable and put your language's name in it,
+   in your language.
+  
+   Edit the 'appcharset' variable and put in the name of the encoding for your
+   language.
+
+4. Go through as much of the rest of the file as you wish, replacing the
+   English strings with strings in your native language.
+
+At this point, you can send the yourlanguage.php file to us and we will take
+care of testing and recoding the translation.  Please only do that if you 
+find the rest of these steps too difficult.
+
+5. Edit the Makefile in the lang/ directory and add an entry for your new
+   language.  Note that the parameter for Recode is "yourcharset..HTML".
+
+6. Run the Makefile by typing 'make yourlanguage'.  A recoded language file
+   will appear in the lang/recoded/ directory.  If the recoding fails, then
+   fix the error in your language file and try again.
+
+7. The HTML encoded language file is what phpPgAdmin actually uses to display
+   localised strings.  Have a look at the recoded file to see how the HTML
+   encoding works.  By encoding your language like this, we can display your
+   language's characters as well as the characters of the language in your
+   database.
+
+8. To add your language to phpPgAdmin, edit the lang/translations.php file
+   and add your language to the $appLangFiles array.
+   You must include the HTML encoded version of your language's name.  You can
+   get this from the recoded version of your translated strings file.
+   Also, add your language to the $availableLanguages array for
+   browser auto detection.
+
+9. Send your contribution to us.  We need the lib.inc.php entry as well as the
+   yourlanguage.php file in lang/.  We don't need the recoded file as we can
+   recode it ourselves before committing it.  Email to the developers list:
+   phppgadmin-devel@lists.sourceforge.net
+
+10. Thank you for your contribution!  You have just made phpPgAdmin accessible
+    to thousands more users!
+
+11. There exists a tool named 'langcheck' in the lang/ directory.  To run it,
+    just type 'php langcheck <language>'.  It will give you a report about
+    which strings are missing from your language file and which need to be
+    deleted.
+
+Appendix A: Ways to Get Recode
+------------------------------
+
+* FreeBSD: cd /usr/ports/converters/recode; make install clean
+* BSD: ftp.gnu.org/gnu/recode/
+* Red Hat: rpm -Uvh recode-3.6-6.i386.rpm
+* Debian: Available via apt-get
+* Win32: http://unxutils.sourceforge.net