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
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
|
GNU Typist 2.9.5 Installation instructions
This program is designed for UNIXes and Microsoft Windows, but it can
be compiled in various environments provided that there is a standard
compiler and required libraries.
Compilation under Unix
----------------------
In order to compile this program, you must have:
- A reasonably standard C compiler (and standard C library with
corresponding header files of course).
- The 'ncursesw' library (with wide-character support) with
corresponding header files installed in convenient places.
The instructions are general for most Unix software in source form:
* Uncompress the sources distribution:
$ tar jxvf gtypist-2.9.5.tar.bz2
or
$ tar zxvf gtypist-2.9.5.tar.gz
* Change to the sources directory:
$ cd gtypist-2.9.5
* Configure the package:
$ ./configure
This default configuration will probably be just fine. However, you
may add some configuration options to the end of that line. Run
configure with `--help' to get full list of them, like this:
$ ./configure --help
By default the program executable will be installed in
/usr/local/bin and the lessons and internationalization support
files in /usr/local/share/gtypist (you can change this with the
`--prefix' option). By default Native Language Support will be
installed (but you can disable this with the `--disable-nls'
option).
* Build the package:
$ make
* Get required permissions and install the package:
$ sudo make install
The sudo program will ask you for the root password to install
gtypist system-wide. If you do not have the root password, you will
not be able to install it system-wide. Instead, you should run
configure with something like '--prefix=~/opt' to install it in your
home directory.
* To test your installation type
$ gtypist
If you already had a version of gtypist installed on the system
before you installed this one,you may need to explicitly state which
one you want to run. So you may need to type:
$ /usr/local/bin/gtypist
Compilation under Windows NT/2000/XP
------------------------------------
First, please check to see if there is a Windows build of this version before
going through the trouble of compiling it yourself!
http://ftp.gnu.org/gnu/gtypist/w32_binaries/
If you're still here, then...
You must have:
- MinGW compiler package, available at
http://sourceforge.net/projects/mingw/files/
It is advised that you download the "Automated MinGW Installer"
package (ming-get-inst) if you are not familiar with MinGW. When
installing, make sure you turn on the options to install "MSYS
Basic System" and "MinGW Developer Toolkit".
If you don't use the atomated installer, note that you will also
need mingw32-make or MSYS.
More information about MinGW can be found at
http://www.mingw.org/
- A recent version of PDCurses, available at
http://pdcurses.sourceforge.net/
The current official binaries of gtypist are compiled using
PDCurses 3.4. We build a static version of the library with
Unicode and forced UTF-8 support. Although building PDCurses is
outside the scope of this document, here is a quick run-through of
what to do...
- copy the PDCurses-3.4.tar.gz file to C:\dev
- open a MinGW shell, co to C:\dev and unpack PDCurses
$ cd /c/dev
$ tar -xvf PDCurses-3.4.tar.gz
- cd to the win32 directory
$ cd PDCurses-3.4/win32
- there's a README in there if you need help
- build PDCurses
$ make -f mingwin32.mak WIDE=Y UTF8=Y
- rename the resulting pdcurses.a to libpdcurses.a
$ mv pdcurses.a libpdcurses.a
To build GNU Typist:
* Open a MinGW Shell (not a Windows command prompt), create a working
doirectory and change to it.
$ mkdir /c/dev
$ cd /c/dev
* In a file explorer window, copy gtypist-2.9.5.tar.xz to C:\dev
* Uncompress gtypist-2.9.5.tar.xz
$ tar -xvf gtypist-2.9.5.tar.xz
* Change to the gtypist directory and configure the build by running
configure-w32
$ cd gtypist-2.9.5
$ configure-w32
* If you are using PDCurses 3.4 and you unpacked it and built it in
the C:\dev\PDCurses-3.4 directory (as suggested in the instructions
above), you will not need to change the Makefile created by the
previous step. You can skip to the next step.
Otherwise, open the Makefile and specify the path to your PDCurses
directory as directed by the comments.
$ notepad Makefile
* Compile gtypist using make
$ make
* To install it, you should create a directory (in this example we
use C:\GTypist) and copy into it the lessons, documentation, UI
translations and the program itsself (gtypist.exe).
$ mkdir /c/gtypist
$ cp gtypist.exe /c/gtypist
$ mkdir /c/gtypist/{doc,lessons}
$ cp lessons/*.typ /c/gtypist/lessons
$ cp doc/*.html /c/gtypist/doc
$ cp -r locale /c/gtypist
* To use GNU Typist, go to the directory where you installed it and
run gtypist.exe. You can do this in a file explorer, or from the
MinGW shell, like this
$ cd /c/gtypist
$ gtypist
Problems and their solution
---------------------------
Configuration with Native Language Support under Unix:
* If you configured first without NLS and now you want NLS, go
to directory intl remove libintl.h and configure again.
* If your Unix doesn't have Native Language Support, the sources of
gtypist come with a limited version, to use it configure with:
./configure --with-included-gettext
And before running gtypist set the environment variable LC_ALL/LANG
to your language and country codes (LL_CC, as described in the
manual, node "Environment Variables"). See the manual for the list
of supported languages. Using this option it was possible to
compile and run gtypist under AIX.
Dvorak Keyboard under GNU/Linux (Ben Armstrong
<synrg@sanctuary.nslug.ns.ca>):
* To get Dvorak keymaps, run the 'loadkeys' command on the
appropriate keymap file. For example if your keymaps are at
/usr/share/keymaps
> loadkeys /usr/share/keymaps/i386/dvorak/dvorak.kmap.gz
* To switch to your default keyboard mappings, run loadkeys on the
default keymap file:
$ loadkeys /etc/console-tools/default.map.gz
* If you are in X, please visit the Dvorak home page at
http://www.mwbrooks.com/dvorak/ for more information.
Keyboard under Windows:
* You could experience some problems with the keyboard under
DOS/Windows. The [Return] key should now work, but the function
keys (F1, F2... F12) may not. However, this should not affect
usage for most users.
|
