GutenMark Download Page
Attractively formatting Project Gutenberg texts
[home]   [download] [usage]

Contents

License
Downloading GutenMark
Installing GutenMark
Compiling GutenMark
Other Stuff You Might Want
Using GutenMark

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.
 
Item
Platform
Download
Zipped GutenMark, initial public release
Win32
  GutenMark-20011102.zip
Gzipped, tarred GutenMark, initial public release
Linux/BSD/UNIX/MacOS-X
 GutenMark-20011102.tar.gz


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.


Using GutenMark

Perhaps now that you've installed GutenMark, you'd like to know how to use it.  Click here.



Last updated 11/02/01 by RSB.  Contact me.