[bt-devel] Dockbook - making the handbook in chunks
Fred Saalbach
bt-devel@crosswire.org
Sat, 20 Jan 2001 10:45:38 -0500
This is a multi-part message in MIME format.
--------------299FD01749C832B4F7B032A8
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
I was attempting to convert some of the pages on the bibletime website
and stumbled across an interesting way to separate the document into
physical chunks. The three files attached can be placed into one
directory and then run "kdb2html book.dockbook". The attachments should
run without errors.
The other files can not be run without a file containing the headers and
file pointers that are included in book.dockbook. These must be left
out of the other files. If you wanted to compile only the portion in
one of the files a book.dockbook file could be created that only points
to the desired file.
This would enable work on any portion of the handbook to be done without
disturbing concurrent work on other sections.
Fred Saalbach
--------------299FD01749C832B4F7B032A8
Content-Type: text/html; charset=us-ascii;
name="Sourcecode.dockbook"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline;
filename="Sourcecode.dockbook"
<chapter id=bibletime_download>
<title>Bibletime Downloads</title>
<para>The bibletime sources and binaries can be downloaded from this
chapter</para>
<section id=source_code
<title>Bibletime Sourcecode</title>
<section id=sourse_bt0_31_srpm>
<title>BibleTime 0.31 (Source RPM)</title>
<para>
<ulink url="http://www.bibletime/Download/0.31/bibletime-0.31-1.src.rpm">
www.bibletime.de</ulink> (HTTP)
</para>
</section>
<section id=sourse_bt0_31_gzip>
<title>Bibletime 0.31 gzip</title>
<para>
<ulink
url="http://www.bibletime/Download/0.31/bibletime-0.31.tar.gz">
www.bibletime.de</ulink> (HTTP) </para>
</section>
<section id=sourse_bt0_25_srpm>
<title>BibleTime 0.25 (Source RPM)</title>
<para>
<ulink url="http://www.bibletime/Download/0.25/bibletime-0.25-1.src.rpm">
www.bibletime.de</ulink> (HTTP)</para>
<section id=sourse_bt0_25_gzip>
<title>BibleTime 0.25 (packed with gzip)</title><para>
<ulink
url="http://www.bibletime/Download/0.25/bibletime-0.25.tar.gz">
www.bibletime.de </ulink> (HTTP) </para>
</section>
</section>
</section>
<section id=sourse_bibletime_binaries>
<title>Binary packages for Intel x86</title>
<section id=binary_rpm>
<title>RPM Packages</title>
<section id=source_bt_3_1suse7_0>
<title>Bibletime 0.31 for SuSE 7.0</title>
<para>RPM BibleTime 0.31 compiled on
SuSE 7.0 with KDE 2.01 RPM packages from SuSE Plain SuSE 7.0, staticallly
linked Sword 1.51a (you do not need the library). Install with <command>rpm -i
...</command><ulink
url="http://www.bibletime/Download/0.31/bibletime-0.31-1suse.i386.rpm ">
www.bibletime.de</ulink> (HTTP)</para></section>
<section id=source_bt_3_1mdk7_2>
<title>Bibletime 0.31 for Mandrake 7.2</title>
<para>RPM BibleTime 0.31 compiled on Mandrake 7.2
Plain Mandrake 7.2, staticallly linked Sword 1.51a (you do not need the
library). Install with <command>rpm -i ...</command>
<ulink url="/0.31/bibletime-0.31-mdk1.i586.rpm">www.bibletime.de</ulink>
(HTTP)</para></section>
<section id=source_bt_3_1suse6_4>
<title>Bibletime 0.31 for SuSE 6.4</title>
<para>RPM BibleTime 0.31 compiled on SuSE 6.4
Linux 2.2.x, GLIBC 2.1.x, KDE 2.0, QT 2.2.2, GCC 2.95.2.
Install with <command>rpm -i --nodeps --prefix=<KDE2 directory></command>.
Make sure you have libmng and working libs of KDE 2. Experimental! <ulink
url="http://www.bibletime/Download/0.31/bibletime-0.31-1.i386.rpm">
www.bibletime.de</ulink> (HTTP)</para>
</section>
<section id=source_bt_.25_1RH6_2>
<title>Bibletime 0.25 for Red Hat 6.2</title>
<para>RPM BibleTime 0.25 compiled on RedHat 6.2
Compiled on a clean RedHat system.
<ulink
url="http://www.bibletime/Download/0.25/bibletime-0.25-1_redhat.i386.rpm">
www.bibletime.de</ulink> (HTTP)</para></section>
<section id=source_bt_2_5suse6_4>
<title>Bibletime 0.25 for SuSE 6.4</title>
<para>RPM BibleTime 0.25 compiled on SuSE 6.4
Linux 2.2.x, GLIBC 2.1.x, KDE 1.1.x, QT 1.4x, GCC 2.95.2
<ulink url="http://www.bibletime/Download/0.25/bibletime-0.25-1.i386.rpm">
www.bibletime.de</ulink> (HTTP)</para>
</section>
</section>
<section id=source_binary_other>
<title>Other Binary Packages</title>
<section id=source_static_tarball>
<title>TAR.GZ BibleTime 0.24 STATICALLY LINKED</title>
<para>Statically linked with KDE 1.1.2, QT 1.44, libjpeg, libtiff, libpng and
libstdc++. Should run on every GLIBC 2 based system! <ulink
url="http://www.bibletime/Download/0.24/bibletimebase.tar.gz">
www.bibletime.de</ulink> (HTTP)</para>
</section>
<section id=source_sun_sparc_binary>
<title>Binary packages for Sun Sparc</title>
<para>
</para>
</section>
<section id=source_debian_binary>
<title>Debian</title>
<para>BibleTime compiled on Debian
Linux 2.2.x <ulink
url="http://homepage.ntlworld.com/danglassey/">
kde.tdyc.com/</ulink> (own page) </para>
<para>BibleTime 0.2-19991001 compiled on Debian
Linux 2.2.x <ulink
url="ftp://kde.tdyc.com/pub/kde/debian/dists/potato/contrib/bina
ry-sparc/misc/bibletime_0.2-19991001-1_sparc.deb">
kde.tdyc.com</ulink> (FTP)
</para>
</section></section></section>
<section id=source_contact>
<title>Contact</title>
<para>If you want to make a binary package of BibleTime please contact us at
<email>info@bibletime.de</email></para>
<para>If you want to mirror BibleTime please mail to
<email>info@bibletime.de</email></para>
</section> </chapter>
--------------299FD01749C832B4F7B032A8
Content-Type: text/html; charset=us-ascii;
name="book.dockbook"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline;
filename="book.dockbook"
<!DOCTYPE Book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
<!ENTITY chap1 SYSTEM "devl_install.dockbook">
<!ENTITY chap2 SYSTEM "Sourcecode.dockbook">
]>
<book lang="en" id="bibletime">
<bookinfo>
<title>Bibletime Help Dialog</title>
<authorgroup>
<author>
<firstname>Jeffrey</firstname>
<surname>Hoyt</surname>
</author>
<author>
<firstname>Joachim</firstname>
<surname>Ansorg</surname>
</author>
</authorgroup>
<date>01/14/2001</date>
<releaseinfo>BT 0.3.1 working draft </releaseinfo>
<abstract>
<para>
<application>BibleTime</application> is an application to aid in study of the
Bible. It provides an easy to use but powerful interface. </para>
</abstract>
<keywordset>
<keyword>BibleTime</keyword>
<keyword>Sword</keyword>
<keyword>Crosswire</keyword>
<keyword>help dialog</keyword>
</keywordset>
</bookinfo>
&chap1;
&chap2;
</book>
--------------299FD01749C832B4F7B032A8
Content-Type: text/html; charset=us-ascii;
name="devl_install.dockbook"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline;
filename="devl_install.dockbook"
<chapter id="devl_3_x">
<title>Bibletime Installation
</title>
<para>Bibletime is still under development. Versions 3.x or 2.x
are available and function acceptable on computers meeting the
requirements.</para>
<section id="devl_3_x_req"> <title> Requirements for
Bibletime Version 3.x Development Version</title>
<para>
This documents describes how to install BibleTime 0.3 as a user. If you
are a developer who wants to develop on BibleTime 0.3 or later please read the
page bt-0_3devel.shtml!
</para>
<table>
<title>
Packages required for installation of Bibletime 0.3 and later.
</title>
<tgroup cols=2>
<thead>
<row>
<entry>Package</entry>
<entry>Location</entry>
</row>
</thead>
<tbody>
<row>
<entry>
QT 2.2x
</entry>
<entry>
www.trolltech.com
</entry>
</row>
<row>
<entry>
KDE 2.0 (at least the libraries)
</entry>
<entry>
www.kde.org
</entry>
</row>
<row>
<entry>
SWORD 1.51a
</entry>
<entry>
www.crosswire.org/Download BibleTime's sources
</entry></row>
</tbody>
</tgroup>
</table>
</section>
<section id="development_source_install">
<title>Installation of development version from Sourcecode</title>
<para>Now download BibleTime's source. Browse to the download page to get a list
of available packages. If you downloaded BibleTime and the required packages
above go to the next step. Compile the libraries</para>
<para>First you have to compile the QT 2.2 sources. I assume the user has his QT
sources in <filename>/usr/lib/qt2</filename>, his KDE2 sources in
<filename>/usr/src/kde2/kdelibs</filename> and his KDE2 directory is
<filename>/usr/local/kde2</filename>, if you don't like it use your own settings
for this.</para>
<screen>
export QTDIR=/usr/lib/qt2
cd $QTDIR
./configure -sm -system-libpng -system-jpeg
make
</screen>
<para>
If you have enough RAM and a fast computer you can speedup the compile process
by adding <command>"-j2"</command> to the make options. For example
<command>"make -j2"</command>. After the compiling process is finished you have
to compile your KDE2 stuff. Please do something like this:</para>
<screen>
export QTDIR=/usr/lib/qt2
export KDEDIR=/usr/local/kde2
cd /usr/src/kde2/kdelibs
./configure
make
make install
</screen>
<para>The compilation of QT and KDE should finish without problems or errors.
It's possible to add <command>"-j2"</command> again to speed up the compiling
process if you have enough RAM and a fast PC. Installation of SWORD 1.51 </para>
<para>Please read SWORD's README file for information about it.
This part does already exist in the "Installation of 0.2x" page. Read it here.
Compile BibleTime 0.3</para>
<para>I assume you unpacked BibleTime's sources into
<filename>/usr/src/bibletime-0.3</filename>, if you use a beta release choose
the right path (e.g. <filename>/usr/src/bibletime-0.3beta1/</filename>) </para>
<screen>
export QTDIR=/usr/lib/qt2
export KDEDIR=/usr/local/kde2
cd /usr/src/bibletime-0.3
make -f Makefile.cvs
./configure
make
make install
</screen>
<para>Again: You can use the <command>-j2</command> option if you like it. Run
BibleTime 0.3</para>
<para>Now you should be able to run BibleTime 0.3. Do something like this:
<command>execkde2.sh bibletime</command> The command <command>execkde2</command>
is a script. Download it here. This script executes some required programs for
KDE2. Edit the script and change your KDE2 and QT2 directory. Copy the script to
<filename>/usr/local/bin/</filename> and make it executable. Now run the command
above! BibleTime should should run without problems. If there are problems
please contact us! </para>
</section>
<section id=development_sword>
<title>Installation of SWORD modules</title>
<para>Installation of Sword modules is required for any version of
bibletime to display texts. explained in "Installation of 0.2x" page. Read it
here.</para>
</section>
</chapter>
--------------299FD01749C832B4F7B032A8--