-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
180 lines (135 loc) · 5.14 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
Fonty Python
Copyright (C) 2006,2007,2008,2009,2016,2017 Donn.C.Ingle
donn.ingle@gmail.com
Fonty Python comes with ABSOLUTELY NO WARRANTY; for details
see the COPYING file. This is free software, and you are welcome
to redistribute it under certain conditions; see the COPYING file
for details.
TICKETS
=======
https://savannah.nongnu.org/bugs/?group=fontypython
Future maintainers
==================
Please read DEVNOTES.
UPDATED DEC 2017
A Note on Python 3
==============
I want to move to Python 3, but my toolkit (wxPython) has not released
their Python 3 compatible wxPython 4.x for Linux. This means I am stuck
on Python 2.x for an unknown span.
I hear that Python 2.x is being discontinued in 2020. I don't know what
that means. If the distros drop Python 2.x at that point, then Fonty
will die right there.
Let's see.
NB: Try to remove the old version BEFORE you install FP.
==============
You can find the path by:
locate fontypythonmodules
If that does not work, then you must update your locate database:
As root run: locate -u
Go make coffee. Then run the locate command above again.
This will give you a directory something like:
/usr/lib/python2.5/site-packages/fontypythonmodules
Use your root account to remove that folder:
cd /usr/lib/python2.5/site-packages
sudo rm -fr fontypythonmodules
(Be *very* careful what you type!)
You should be good to go now.
How to install
==============
Please see the end of this file if your install fails, there are
certain files that FP relies upon.
I assume you have extracted the "tarball" already.
Change to the directory it created.
As the root user enter this command:
python setup.py install --force
You might need to use sudo:
sudo python setup.py install --force
* Please do use the --force flag, or there may be old
files from the last version of Fonty that can cause bugs.
This will create a program called 'fontypython'
Alternative installation
========================
Move the entire extracted folder to a folder that
is in your PATH, like ~/bin
Make a link to the fontypython script like this: (for e.g.)
tar -s ~/bin/fontypython-x.x.x/fontypython .
Make it executable:
chmod u+x fontypython
Now you should be good to go.
If it does not work, try closing your console and
starting it again.
Refreshing the icon cache
=========================
I found that Fonty's icons don't appear at first.
To refresh the cache (on Ubuntu, at least) try:
sudo update-icon-caches /usr/share/icons/*
(There's also: gtk-update-icon-cache)
Running the program
===================
To get started on the console:
fontypython -h
For exmaples ('e'):
fontypython -h e
For the gui, run fontypython
(Hit F1 for in-app help)
Troubleshooting the installation
================================
Fonty Python depends on several other libraries:
( These are minimum version numbers )
1. python2.4 to python2.7 (Not python3)
2. python-dev (odd one this. See notes below)
3. python-pil (The "Pillow" module has replaced the old PIL one.)
4. python-wxgtk3.0 (Not 4.x, which is unreleased.)
Items 1 and 3 are usually pre-installed on Gnu\Linux distros.
Item 2 is a new twist. I am not sure why it's required for FP
(yes - I don't know everything :)) but some users have had
problems and installing python2.4-dev fixed them.
(replace 2.4 with the actual version of python you are using.)
On *buntu:
sudo apt-get install python2.4-dev
If you cannot install item 2 - try the alternative
installation instructions above.
Item 3 - python-imaging is known as the PILLOW library.
It should be available in your repo. I used vers 3.1.2 to
develop. Make that the min.
Item 4 may be installed, or it may be in your distro's
main repository.To install item 4, try the following:
On *buntu/Debian:
apt-cache search python-wxgtk
Find the latest version in the list, then:
sudo apt-get install python-wxgtkX.Y
(replacing X.Y with the results of your search)
After this has all installed, try to run fontypython again.
If you still do not come right, then I advise you
to go to the following web sites for help directly
from the horse's mouth:
http://wxpython.org
https://python-pillow.org/
Or open a ticket on our site:
https://savannah.nongnu.org/bugs/?group=fontypython
LOCALIZATION TIPS
=================
Make sure your LANG variable is set properly.
To run under a locale, do something like this:
LANG=en_ZA.utf8
./fontypython
You can find your locales by:
locale -a
If localization is not working it could be that there is no
translation for your language yet, it can also be a
problem with missing packages in your distro.
This is what I installed on my system (Kubuntu 7.10 as of
December 2007) while I was developing:
language-support-fr
language-support-en
language-pack-gnome-fr (*)
(*) This one is VERY important, it has many stock translations for GTK. Without it
you likely not see buttons and widgets in the right language.
Substitute your language code as you please.
TRANSLATION TIPS
================
If you want to help translate, please contact us via the
fontypython list: fontypython@googlegroups.com
I have included the pot files that I have. Look at fontypythonmodules/pofiles/README
(Translation stuff is messy. Headers are all wrong and versions all over the place.)