Upstream 0.2.23
[gonvert] / doc / INSTALL
1 gonvert
2 =======
3 Any problems, suggestions, features or comments please contact me: 
4         anthony@unihedron.com
5
6
7 Requirements
8 ============
9         RH7.0 has everything you need.
10
11         Otherwise make sure that you have:
12                 Python >= 1.5.2         http://python.org
13                 PyGTK >= 0.6.6          ftp://ftp.daa.com.au/pub/james/python/
14                 pygnome                 ftp://ftp.daa.com.au/pub/james/python/
15                 Libglade >= 0.13        http://freshmeat.net/redir/libglade/5651/url_homepage/
16                 gnome-libs >= 1.2.4     http://www.helixcode.com/desktop/packages.php3
17                 
18         If you want to do GUI development then you will need:
19                 glade                   http://www.helixcode.com/desktop/packages.php3
20
21
22 Installation Notes
23 ==================
24 gonvert has been tested on RedHat 7.0 (python 1.5.2, libglade 0.14, pygtk 0.6.6)
25
26 1) Extract the tar archive.
27
28
29 2) cd into the gonvert-x.y.z directory
30
31
32 3a)If you just want to test the program as a user then:
33
34         ./gonvert
35
36
37 3b) If you want to install the program then:
38
39         su -c "make install"
40         
41
42
43 Uninstall the program:
44 ======================  
45
46         su -c "make uninstall"
47
48 ================================================
49 Translation:
50 To make translations to other languages, follow these steps:
51
52 1. Use the following to extract the raw message catalog
53      pygettext gonvert
54      edit messages.txt to CHARSET=utf-8
55
56 2, Give the messages.pot file to the translater person
57     See http://www.unicode.org/charts/ for unicode translations
58     To get a defined character, use  \N{Character_name}, for example:
59          \N{SKULL AND CROSSBONES}
60             or 
61          u'\u2620'
62
63 3. Get the files back from the translator person:
64      pl_messages.po   the translated message file
65      pl_messages.gmo  the compiled translation, which was compiled with something like:
66                          msgfmt gonvert.po
67
68 4. Install the .gmo file in /usr/share/locale/xx/LC_MESSAGES using:
69    # make install_pl
70
71 5. To update a translation use the following:
72      msgmerge -U i18n/pl_messages.po messages.pot
73    Merged results go into the source file.
74    Compile the new translation
75      msgfmt i18n/pl_messages.po -oi18n/pl_messages.gmo
76
77 7. Test by setting the LANGUAGE variable appropriately, then run gonvert.
78    LANGUAGE=pl
79       or
80    LANGUAGE=en
81 ================================================