BookmarkBridge User Manual |
![]() |
Since BookmarkBridge is a multi-platform program, the instructions for compiling from the source code differ a bit between platforms. Even though the procedure for compiling BookmarkBridge may differ between platforms, the source code itself is exactly the same, whether for Windows or Unix. All files necessary for compiling it for all supported platforms are present in the source distribution.
BookmarkBridge was written using a few open-source toolkits. Before compiling BookmarkBridge under Windows or Unix, you must ensure these development kits are available on your computer.
I developed the Windows portions of BookmarkBridge using Microsoft Visual Studio 6.0. The Qt 2.3.0 NC edition does not work with Visual Studio .NET 2002, which I also have. I have had limited success compiling BookmarkBridge under Visual Studio .NET and even got it to link once but BookmarkBridge seemed somewhat unstable. I make no promises that BookmarkBridge will work with VS .NET and probably will not be very helpful with questions or support for those who wish to try it.
As part of the source distribution I provide a .pro file. The easiest way to start a project in MSVC 6.0 is to use the Qt integration to import bookmarkbridge.pro. The .pro file is a project file describing BookmarkBridge's compilation procedure. For those wishing to compile BookmarkBridge from the command line, the tmake utility, included with the Qt development toolkit can read a .pro file and convert it to a Makefile suitable for use with Microsoft Nmake. Before compiling, either in the visual development environment or through the command line, you need to be sure the include path is set up correctly for Libxml2. If compiling from the command line, edit the bookmarkbridge.pro file and change the include path. If using the visual development environment, change your project settings (from the Project menu).
On Unix, BookmarkBridge uses the standard GNU build procedure. Just run the following commands at a shell prompt:
#: ./configure --enable-mt #: make #: make install
If you get this error message configure: error: Qt (>= 2.2.2) (headers and libraries) not found. Please check your installation! while running configure, it means that configure could not locate the Qt development files, discussed in the Development Pre-requisites section, above. You can tell configure where to find these files by typing:
#: ./configure --with-qt-dir=/usr/lib/qt2
In this case,
/usr/lib/qt2
is the directory where configure can expect to find the include directory and lib directory for Qt. If this still does not work, try adding
--enable-mt
to the command line for configure.
If you receive an error message during compilation that the file <libxml/parser.h> is missing, then you can tell configure where to find the files. As discussed in the Development Pre-requisites section above, you must have the development files for libxml2 installed. The default is /usr/include/libxml2, but you can use the following:
#: ./configure --with-libxml2-include=/usr/local/include/libxml2
Is this case,
/usr/local/include/libxml2
is the directory where the compiler can expect to find the libxml directory containing the include files for libxml2.
Table of Contents Previous: Theory of Operation Next: Source Code Roadmap