NOTE: Consult the manpage for info on using bk2site
If you dont want to install the manpage just do:
groff -man -Tascii bk2site.1
The following is an email that might help if you are having trouble compiling in an older system.
From: ObiTuarY <obituary@linuxbe.org>
Subject: [Bk2site-dev] Problems compiling bk2site 1.1.8 (and solution)
To: "Jose M. Vidal" <bk2site-dev@lists.sourceforge.net> Date: Sun, 30
Dec 2001 13:34:09 +0100
Hello,
I'm using bk2site for my personal web server. Until yesterday I was still using bk2site 1.1.6. But I had this "floating point exception" problem, that 1.1.8 fixed now (thanks!). Bk2site 1.1.8 compiles fine with glibc 2.2.x but it's missing the include file "sstream" (in reference.H) when you try to compile it with glibc 2.1.x. The quickfix is to get a copy of the sstream file in /usr/include/g++-3 on a glibc 2.2.x system and put it into your /usr/include/g++-2 (glibc 2.1.x). After that it compiles fine and works fine also. Maybe it would be useful to include "sstream" into the distribution with a few #ifdefs just in case someone else wants to compile it with an older glibc. Well, I know, you're supose to use the latest stuff, but sometime it's a hastle to have to reinstall a system you have tailored to your needs over time. BTW, thanks for this nice program!
Programmer's guide: (classes are in "quotes")
bk2site.C
The main(). Reads and parses the .bk2siterc files.
reference.C
The bookmarks are converted into a "referenTree" object. A referenceTree
contains a vector of "reference". A reference object is either a url
(leaf) or a folder (non-leaf). references that are folders have a
pointer (children) to a referenceTree which contains all their
children.
element.C
An "element" represents one of the begin--end blocks found in the base
files. A "fileview" contains all the elements in some base file. A
fileview object is given some channels and other vector<reference> and
can output the html file.
Its the model-view-controller pattern:
referenceTree is the model.
fileview is the view
no controller.
iwebstream.C
Is given an url and provides a single interface for reading from
it. Handles files and http. It also does some SGML-type-tag parsing.
channel.C
A "channel" simply stores the parsed channel file, its a
vector<reference>. A "channelContainer" has a vector<channel>.