GutenMark Obsolete Download Page But still may some useful info home features download usage FAQ changes bugs links developer

Contents

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

License

Downloading GutenMark

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.

Installing GutenMark

... on Win32

1. 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.
2. Add this directory to your PATH, or copy GutenMark.exe and GutenMark.cfg to some directory that's already in your path.
3. If you download any of the optional wordlists or namelists, put them wherever you put GutenMark.exe.  Don't uncompress the wordlists.
4. 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. Important note :  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.
5. 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

1. 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.
2. Add this directory to your PATH, or copy GutenMark and GutenMark.cfg to some directory that's already in your path.
3. If you download any of the optional wordlists or namelists, put them wherever you put the executable (GutenMark).  Don't uncompress the wordlists.
4. 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. Important note :  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.
5. You can read the documentation by looking at GutenMark-install/index.html with your web browser.
6. If you download the optional man page (not included in the tar archive), copy it wherever man pages go on your system.  You can find out where that is by using the command "man --where tail", and seeing the directory used for installation of the "tail" man-page.  (Thanks to Dave Mitchell for this tip.)  Or you can simply read the man-page in place, like so:
man -l GutenMark.1 GutenMark

Compiling GutenMark

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

... on Win32

make GutenMark.exe

... on *NIX

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.

If you have a Linux version of the MinGW compiler installed, the build will actually create both Linux and Win32 versions of each executable.  In other words, you'll get a file called "GutenMark" (for Linux) and a file called "GutenMark.exe" (for Windows).  However, I'm fully aware that most people won't have a MinGW cross-compiler installed, so don't worry:  you'll still be able to build the Linux executables without difficulty.

GutenSplit

Other Stuff You Might Want

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.