1
<chapter id="hdbk-config"><title>Configuring &bibletime;</title>
3
<para>In this section you find a description of the different possibilities
4
to configure &bibletime;: The <link linkend="hdbk-config-bt">Configure BibleTime Dialog
5
</link> and the <link linkend="hdbk-config-toolbar">Configure Toolbars</link>
6
dialog. Both can be accessed under <guimenu>Settings</guimenu> in the main menu.</para>
8
<sect1 id="hdbk-config-bt"><title>Configure BibleTime Dialog</title>
10
<para>The &bibletime; user interface can be customized in many ways
11
depending on your needs. You can access the configuration dialog by
12
selecting <menuchoice><guimenu>Settings</guimenu></menuchoice>
13
<guimenuitem>Configure &bibletime;</guimenuitem>.</para>
15
<sect2 id="hdbk-config-bt-display"><title><guimenu>Display</guimenu></title>
17
<para>The startup behavior can be customized. Select from the following options:
19
<listitem><para>Show tip of the day</para></listitem>
20
<listitem><para>Show startup logo</para></listitem>
23
<para>Display templates define the rendering of text (colors, size etc.). Various built-in templates are available.
24
If you select one, you will see a preview on the right pane.</para>
28
<sect2 id="hdbk-config-bt-languages"><title><guimenu>Languages</guimenu></title>
30
<para>Here you can specify which language should be used for the biblical booknames. Set
31
this to your native language, if it is available, and you'll feel at home.</para>
33
<para>By default, &bibletime; uses the &kde; general display font which can
34
be specified in the &kcontrolcenter;. You can override this font if neccessary.
35
Some languages require special fonts to be displayed correctly, and this dialog
36
allows you to specify a custom font for each language.</para>
38
<mediaobject><imageobject>
39
<imagedata fileref="ss_configfonts.png" format="PNG"/>
41
<textobject><phrase>Options Dialog - fonts</phrase></textobject>
42
<caption><para>The Options dialog - Fonts.</para></caption>
45
<para>&bibletime; can now use all fonts supported by KDE/QT.
46
As long as the works you are interested in display correctly nothing
47
needs to be done here. If a work only displays as a series
48
of question marks (??????) or empty boxes, then you know that the standard
49
KDE display font does not contain the characters used in this work.</para>
51
<para>To correct this, choose this work's language from the drop down menu.
52
Select the use custom font checkbox. Now select a font. For example, a font
53
that supports many languages is Code2000. If no installed font can display
54
the work you are interested in, try installing the &kde; localization
55
package for that language.</para>
57
<sect3 id="hdbk-config-bt-addfont"><title>Installing fonts</title>
58
<para>Detailed font installation instructions are outside the scope of this handbook.
59
&kde;'s <ulink url="help:/kcontrol/index.html">KControl Center</ulink> contains
60
an excellent and easy to use font installation module.
61
Please read <ulink url="help:/kcontrol/kcmfontinst/index.html">
62
its documentation</ulink>. For further information you might want to refer to the
63
<ulink url="http://www.ibiblio.org/pub/Linux/docs/HOWTO/other-formats/html_single/Unicode-HOWTO.html#toc4">
64
Unicode HOWTO</ulink>.</para>
66
<tip><para>If you use a small font like Clearlyu (about 22kb), &bibletime;
67
will run faster than with a large font like <trademark class="registered">
68
Bitstream Cyberbit</trademark> (about 12Mb).</para></tip>
71
<sect3 id="hdbk-config-bt-ob-font"><title>Obtaining Fonts</title>
72
<para>Fonts can be obtained from a number of sources:</para>
74
<listitem><para>Your Linux distribution.</para></listitem>
75
<listitem><para>Your distribution's localization packages.</para></listitem>
76
<listitem><para>An existing <trademark class="registered">Microsoft Windows</trademark> installation on the same computer.</para></listitem>
77
<listitem><para>A font collection, such as are available from Adobe or Bitstream.</para></listitem>
78
<listitem><para>Online font collections.</para></listitem>
81
<para>Unicode fonts support more characters than other fonts, and some of these fonts are
82
available at no charge. None of available fonts includes all characters
83
defined in the Unicode standard, so you may want to use different fonts for different
87
<title>Unicode Fonts</title>
91
<row><entry><ulink url="http://home.att.net/~jameskass/CODE2000.ZIP">Code2000</ulink></entry>
92
<entry>Perhaps the best free Unicode font, covering a wide range of characters.</entry></row>
94
<row><entry><ulink url="http://scripts.sil.org/cms/scripts/page.php?site_id=nrsi&cat_id=FontDownloads">
95
SIL unicode fonts</ulink></entry>
96
<entry>Excellent unicode fonts from the Summer Institute of Linguistics.</entry></row>
98
<row><entry><ulink url="http://www.nongnu.org/freefont/">FreeFont</ulink></entry>
99
<entry>A new free unicode font initiative.</entry></row>
101
<row><entry><ulink url="ftp://ftp.crosswire.org/pub/sword/iso/latest/FONTS">Crosswire's font directory</ulink></entry>
102
<entry>Several fonts available from the Crosswire Bible Society Ftp site.</entry></row>
104
<row><entry><ulink url="ftp://ftp.netscape.com/pub/communicator/extras/fonts/windows/">Bitstream CyberBit</ulink></entry>
105
<entry>Covers almost the entire range of Unicode, but might slow &bibletime; down because of its size.</entry></row>
107
<row><entry>Clearlyu</entry>
108
<entry>Included in some distributions. Contains European, Greek, Hebrew, Thai.</entry></row>
110
<row><entry><ulink url="http://bibliofile.mc.duke.edu/gww/fonts/Unicode.html">Caslon, Monospace, Cupola, Caliban</ulink></entry>
111
<entry>Partial coverage, see information on linked site.</entry></row>
116
<para>There are good Unicode font lists on the net, as the one by Christoph Singer
117
(<ulink url="http://www.slovo.info/unifonts.htm">Multilingual Unicode TrueType Fonts
118
in the Internet</ulink>), or the one by Alan Wood
119
(<ulink url="http://www.alanwood.net/unicode/fontsbyrange.html">
120
Unicode character ranges and the Unicode fonts that support them</ulink>).
127
<sect2 id="hdbk-config-bt-desk"><title><guimenu>Desk</guimenu></title>
129
<para>Many features provided by the Sword backend can now be customized in
130
&bibletime;. These features are documented right in the dialog. You also have
131
the possibility to specify standard works that should be used when no specific work
132
is specified in a reference. An example: The standard Bible is used to display the content of
133
crossreferences in the Bible. When you hover over then, the Mag will show the content of the verses
134
referred to, according to the standard Bible you specified.</para>
138
<sect2 id="hdbk-config-bt-hotkeys"><title><guimenu>HotKeys</guimenu></title>
140
<para>HotKeys are special key commands that can be used in the place of
141
the menu items and icons. A number of &bibletime;'s commands have
142
predefined HotKeys (see <link linkend="hdbk-reference-hotkeys">this section</link>
143
for a complete listing). Most of &bibletime;'s commands can be assigned
144
HotKeys here. This is very helpful to quickly access the functions that you need the most.</para>
151
<sect1 id="hdbk-config-toolbar"><title>Configure Toolbars dialog</title>
152
<para>You can adapt the toolbar to your needs. Please use the following entry in the main menu:
157
<inlinemediaobject><imageobject>
158
<imagedata fileref="i_configuretoolbars.png" format="PNG"/></imageobject>
159
</inlinemediaobject>Settings
161
<guimenuitem>Configure toolbars</guimenuitem></menuchoice></term>
162
<listitem><para>Configure toolbars</para></listitem>
166
<para>You will see this dialog, which allows adding and removing buttons from
167
the main toolbar of &bibletime;. The order of the buttons can also be changed.
171
<imagedata fileref="ss_configtoolbar.png" format="PNG"/>
173
<textobject><phrase>Toolbar configuration dialog</phrase></textobject>
174
<caption><para>The Toolbar configuration dialog.</para></caption>
176
<para>Use the 4 buttons in the middle of the window to move buttons to the toolbar,
177
away from the toolbar or to sort them on the toolbar according to your preference.
179
<para>Please see <link linkend="hdbk-reference-menus-settings-toolbars">this section</link> for further information.</para>