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
To save messing about, GutenMark is distributed as a single archive
file containing documentation, source code, and executable programs for
all directly-supported platforms (Win32, Linux-Intel, Linux-PPC,
Mac OS X, and FreeBSD). Simply choose the archive format most suitable
for your particular platform.
Currrent Version
Older Versions
Installing GutenMark
... on Win32
Unzip the archive with WinZip, pkunzip, or whatever you have that's appropriate.
You'll find GutenMark.exe under the GutenMark\Win32 directory. Add
this directory to your PATH, or copy GutenMark.exe to some directory that's
already in your path.
... on Linux (Intel or PPC), Mac OS X, or FreeBSD
From the command prompt:
gunzip GutenMark-xxxxxxxx.tar.gz
tar -xf GutenMark-xxxxxxxx.tar
You'll find the GutenMark executable under GutenMark/LinuxIntel, GutenMark/LinuxPPC,
GutenMark/MacOS-X, or GutenMark/FreeBSD. Add this directory
to your path, or copy the executable to some directory that's already in
your path.
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 quite 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 website) and Borland's free C++ compiler (see Borland's
website) have both been used. [If for some reason you don't want
to use these compilers -- perhaps they're too free for you -- you can probably
get GutenMark to compile with other C-language compilers, such as
Microsoft C. Very likely, you just have to replace the references
to bcc32 in the Makefile with the name of the compiler you want
to use, and then use the Borland instructions below. If you figure
it out, send me a "howto", and I'll post it here.]
... on Win32
Unzip the source code, and change to the GutenMark/src 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 this
calls up some other make program, such as Microsoft's or Borland's,
then this won't work properly.)
To compile with Borland C++:
make -f Makefile Borland
(This assumes that the Borland make program can be accessed by typing
"make". If this instead calls up some other make program,
like Microsoft's or GNU's, I have no idea whether it will work.)
In either case, when you're finished, you'll want to copy GutenMark.exe
to some directory contained in your PATH.
... on Linux, BSD, UNIX, Mac OS X, etc.
gunzip GutenMark-xxxxxxxx.tar.gz
tar -xf GutenMark-xxxxxxxx.tar
cd GutenMark/src
make
On FreeBSD, the GNU make program is actually called gmake.
When you're finished compiling, place the GutenMark executable some
place in your PATH.
Other Stuff You Might Want
The function of GutenMark is merely to convert the Project Gutenberg
etexts to HTML. If that's all you want -- if you want to read the
etext online, or to set up a website 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 are looking for an end-to-end solution that
can produce attractive printable texts like this sample,
then you need some more 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.
-
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.
-
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. 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. 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 (cost$) or with ghostscript
(for free).
Last updated 11/13/01 by RSB. Contact me.