# The &tdeio_sword; Handbook

Luke Plant

    L.Plant.98@cantab.net

2004-2006 Luke Plant
2006-12-16
0.3.0

&tdeio_sword; is a Bible reading tool written for the TDE environment. It is a front-end for the SWORD Bible system, and enables you to view, browse and search your SWORD modules from the web browser (Konqueror).

KDE tdeio_sword tdeio-sword Kio-Sword kiosword sword SWORD Bible tdeio

## Introduction

&tdeio_sword; is a Bible reading tool written for the TDE environment. It is a front-end for the SWORD Bible system, and enables you to view, browse and search your SWORD modules from the web browser (Konqueror). It is intended to be a lightweight companion to programs like BibleTime (for the TDE environment) and other SWORD programs.

Please report any problems or feature requests to the Trinity Desktop dev team.

## Using &tdeio_sword;

To start using &tdeio_sword; simply type sword:/ in the location bar in Konqueror, and start browsing your SWORD modules. To go directly to a section of a module, use a URL like this: `sword:/[modulename]/[reference]`

Examples

`sword:/KJV/Hebrews 1:3`

  Takes you straight to Hebrews 1:3 in the King James Version

`sword:/StrongsGreek/01234`

  Returns the information about the Strongs Number 01234 (Greek)

`sword:John 3:16`

  Redirects to John 3:16 in your default Bible

You can specify other options in the URL. See sword:/?settings.

## Questions and Answers

&reporting.bugs; &updating.documentation;

I get the message 'No modules installed!'

&tdeio_sword; uses the SWORD modules already installed on your system. You need to install some modules from Crosswire.org or use a SWORD frontend such as BibleTime to install the modules you want. You may need to edit your sword configuration in ~/.sword/ or /etc/sword as per the instructions on crosswire.org

## Credits and License

Program and documentation copyright 2004-2006 Luke Plant L.Plant.98@cantab.net

&underGPL;

The code also draws ideas, methods and some code from BibleTime Diatheke (included in the SWORD source distribution) and the SWORD libraries themselves (all of which are GPL software). See also the AUTHORS file distributed with &tdeio_sword; for other contributions.

This &tdeio_sword; handbook is part of &tdeio_sword; and is licensed under the same terms.

## Installation

### How to obtain &tdeio_sword;

Download from The &tdeio_sword; home page

### Requirements

The following libraries are required:

SWORD 1.5.8 or greater

TDE libraries

You can find a list of changes at https://mirror.git.trinitydesktop.org/gitea/TDE/tdeio-sword.

### Compilation and Installation

In order to compile and install &kappname; on your system, first unpack the source code. Then type the following in the base directory of the &kappname; distribution:

    	% mkdir -p build
    	% cd build
    	% cmake ../
    	# make install

You will need the header files from the tdelibs library and SWORD installed on your system. Please take a look at the INSTALL file for more cmake options.

You will need to be root before doing the 'make install' step.

Since &kappname; uses `cmake` you should have no trouble compiling it. Should you run into problems please report them to the TDE dev team.

### Configuration

You will need to install SWORD modules before using &tdeio_sword;.

User settings can be saved via the 'Settings' page.

&documentation.index;