GutenMark
Download Page
Attractively formatting Project
Gutenberg texts
|
|
Contents
License
Downloading GutenMark
Installing GutenMark
Compiling GutenMark
Other Stuff You Might Want
License
GutenMark is freely available under the terms of the GNU General
Public License (GPL). You may view the text of the GPL here
, or you may visit the Free Software Foundation
for more explanation.
Downloading GutenMark
If you have one of the directly-supported platforms, choose the appropriate
"base package". The base package contains documentation, binary executable,
and configuration files, but it still can benefit from downloading additional
wordlists (see below). If you don't have one of the directly-supported
platforms, or if you would just like to have the source code, download
the source package instead. If you want the bleeding-edge source
code (rather than the released code), choose the "development" source package.
Software
The "wordlists" and "namelists" are optional files that you can download
or not, as you choose. The wordlists are categorized as highly
recommended, recommended , or available,
based on my own admittedly subjective experience. Click
here for an extended explanation of what wordlists do. If you
want to download several (or all) wordlists, you might prefer to use an
FTP client rather than your browser.
Wordlists and Namelists
Description
|
Version
|
Download
|
My own special English wordlist |
Nov. 29, 2001 |
1K |
U.S. namelist |
Nov. 10, 2001 |
348K |
U.S. place names (NEW) |
Dec. 18, 2001 |
144K |
French namelist |
Nov. 11, 2001 |
7K |
English wordlist |
Nov. 10, 2001 |
449K |
French wordlist |
Nov. 17, 2001 |
373K |
German wordlist |
Nov. 24, 2001 |
582K |
Older, smaller German wordlist |
Nov. 11, 2001 |
209K |
Latin wordlist |
Nov. 16, 2001 |
195K |
Italian wordlist |
Nov. 11, 2001 |
383K |
Spanish wordlist |
Nov. 11, 2001 |
322K |
Non-U.S. place names (NEW) |
Dec. 22, 2001 |
5992K
(Really really big!!) |
Norwegian wordlist |
Nov. 16, 2001 |
2078K
(Really big!) |
Gaelic wordlist |
Nov. 11, 2001 |
298K |
Danish wordlist |
Nov. 11, 2001 |
558K |
Swedish wordlist |
Nov. 11, 2001 |
254K |
Finnish wordlist |
Nov. 11, 2001 |
285K |
My own special non-English wordlist |
Nov. 24, 2001 |
1K |
browse ... |
all |
FTP |
Installing GutenMark
... on Win32
-
Unzip the base-package zip-file with WinZip, pkunzip, or whatever software
you have that's appropriate. This will create a directory called
"GutenMark-install" containing the executable file (GutenMark.exe) and
all of the documentation.
-
Add this directory to your PATH, or copy GutenMark.exe and GutenMark.cfg
to some directory that's already in your path.
-
If you download any of the optional wordlists or namelists, put them wherever
you put GutenMark.exe. Don't uncompress the wordlists.
-
Depending on the wordlists you've downloaded, the native languages of the
etexts you're interested in, and your own personal tastes, you may want
to reconfigure the software. : Prior to version 20020721, it was necessary
to edit the default configuration file so that it contained the exact pathnames
of the wordlists. In versions 20020721 and later, this inconvenient
step can be omitted.
-
You can read the documentation by looking at GutenMark-install\index.html
with your web browser.
... on Linux (Intel or PPC), Mac OS X, or FreeBSD
-
Expand the base-package tar-archive with gunzip and tar. For example:
gunzip GutenMark_MacOS-X_xxxxxxxx.tar.gz
tar -xf Gutenmark_MacOS-X_xxxxxxxx.tar
This will create a directory called "GutenMark-install" containing the
executable file (GutenMark) and all of the documentation.
-
Add this directory to your PATH, or copy GutenMark and GutenMark.cfg
to some directory that's already in your path.
-
If you download any of the optional wordlists or namelists, put them wherever
you put the executable (GutenMark). Don't uncompress the wordlists.
-
Depending on the wordlists you've downloaded, the native languages of the
etexts you're interested in, and your own personal tastes, you may want
to
reconfigure the software. : Prior to version 20020721, it was necessary
to edit the default configuration file so that it contained the exact pathnames
of the wordlists. In versions 20020721 and later, this inconvenient
step can be omitted.
-
You can read the documentation by looking at GutenMark-install/index.html
with your web browser.
-
If you download the optional man page (not included in the tar archive),
copy it wherever man pages go on your system. Sorry, but at this
point, I'm too stupid to know where that is supposed to be. Anyone
who know, feel free to tell me. If you don't know how to do that
either, you can read the man page like so:
man -l GutenMark.1 GutenMark
Compiling GutenMark
If you don't have any of the platforms for which an executable program
is supplied, or if you would like to modify the program, then you need
to compile GutenMark yourself. This is easy on any system
that has the GNU compiler gcc and the GNU make program.
You can obtain gcc and make for free from GNU
. When compiling for Win32, the version of gcc called mingw32
(see
Mumit
Khan's web site ) is used.
NOTE: In versions later than 20011113, support for Borland's
free C++ compiler (see Borland's
web site ) has been dropped, because it was just too much effort for
me without knowing if anyone was interested. If for some reason you
don't want to use mingw32, and if you figure out how to get other
C compilers such as Borland's or Microsoft's to work, tell
me ; I'll post the instructions here.
Requirements
You need to have the compression library zlib installed. This
can be obtained for free from www.zlib.org
, but is already present on every *NIX system I personally have tried.
For Win32, I've included a pre-compiled zlib library with the GutenMark
distribution, so you don't have to worry about it.
... on Win32
Unzip the source code, and change to the GutenMark-source directory from
the DOS command line. To compile with mingw32,
make GutenMark.exe
(This assumes that the name of the GNU make program that you got
with mingw32 is actually accessible by typing "make". If it
instead calls up some other make program, such as Microsoft's or
Borland's, then the software-build will not work properly.) In addition
to compiling GutenMark.exe, this will attempt to test the compilation by
running GutenMark.exe to produce sample HTML file (bldhb10.html) which
it compares to an equivalent HTML file (bldhb10.txt.html) provided with
the distribution.
... on *NIX
Expand the source-code archive with gunzip and tar, and (in a text console)
change to the GutenMark-source directory. To compile, simply run
make
(gmake in FreeBSD).
In addition to compiling GutenMark, this will attempt to test
the compilation by running GutenMark to produce sample HTML file
(bldhb10.html) which it compares to an equivalent HTML file (bldhb10.txt.html)
provided with the distribution.
Other Stuff You Might Want
The function of GutenMark is merely to convert the Project Gutenberg
etexts to marked-up HTML or LaTeX. If you intend to use LaTeX, I
won't offer you advice because you probably know much more about the available
utility software than I do. But if you intend to use HTML, I can
give you some hints.
If the HTML is all you want -- if you want to read the etext online,
or to set up a web site that displays PG texts in HTML, or if you're fine
with printing etexts from your browser, or if you want to use the HTML
as a starting point for further markup -- then you're all set!
If, on the other hand, you don't want to use LaTeX and you are looking
for an end-to-end solution that can produce attractive printable texts
like this sample,
then you need some better way of printing HTML than your browser can provide.
You could, of course, load the HTML into Microsoft Word or some other word
processing program, and manipulate the document format manually.
The solution I would choose instead is to use a utility program that
can convert HTML to Postscript printer language, or to PDF format.
Several such free utilities are available.
-
html2ps is
available for Linux systems (my SuSE Linux system installed it automatically),
and is the program I used to create the sample PDF file. Its only
drawbacks, as far as I know, are that it is slow and that it can leave
hanging section headings at the bottoms of pages. Also, if the font
size is too big (or the page size too small), it has occasional problems
right justifying text. Actually, html2ps only creates Postscript,
which can then be converted to PDF with ps2pdf . I don't have
personal experience with these options on Win32 systems, but html2ps
is written in Perl, and should therefore be available on Win32; Postscript
can be converted to PDF or printed on Win32 using Adobe
Acrobat (costs money) or with ghostscript
(for free). If you are interested in using html2ps with
GutenMark,
you may also be interested in various configuration files for html2ps
that I think work nicely with GutenMark HTML:
htmldoc is available
for either for Win32 or in source-code form (for Linux systems), and has
some very nice properties. I personally find it a little buggy, but
it's apparently under active development and can presumably only get better.
The main problem is that it is very bad at right justification (or at least,
I haven't figured it out), and so you need to use ragged-right text.
©2001-2002 Ronald S. Burkey. Last updated
07/22/02 by RSB. Contact me
.