summaryrefslogtreecommitdiff
path: root/docs/handbook/en/docbook/hdbk-config.docbook
diff options
context:
space:
mode:
Diffstat (limited to 'docs/handbook/en/docbook/hdbk-config.docbook')
-rw-r--r--docs/handbook/en/docbook/hdbk-config.docbook207
1 files changed, 207 insertions, 0 deletions
diff --git a/docs/handbook/en/docbook/hdbk-config.docbook b/docs/handbook/en/docbook/hdbk-config.docbook
new file mode 100644
index 0000000..e784e25
--- /dev/null
+++ b/docs/handbook/en/docbook/hdbk-config.docbook
@@ -0,0 +1,207 @@
+<chapter id="hdbk-config">
+ <title>Configuring &bibletime;</title>
+ <para>In this section you find an overview to configure &bibletime;,
+ which can be found under
+ <guimenu>Settings</guimenu> in the main menu.</para>
+ <sect1 id="hdbk-config-bt">
+ <title>Configure BibleTime Dialog</title>
+ <para>The &bibletime; user interface can be customized in many
+ ways depending on your needs. You can access the configuration
+ dialog by selecting
+ <menuchoice>
+ <guimenu>Settings</guimenu>
+ </menuchoice>
+ <guimenuitem>Configure &bibletime;</guimenuitem>.</para>
+ <sect2 id="hdbk-config-bt-display">
+ <title>
+ <guimenu>Display</guimenu>
+ </title>
+ <para>The startup behavior can be customized. Select from the
+ following options:
+ <itemizedlist>
+ <listitem>
+ <para>Show startup logo</para>
+ </listitem>
+ </itemizedlist></para>
+ <para>Display templates define the rendering of text (colors,
+ size etc.). Various built-in templates are available. If you
+ select one, you will see a preview on the right pane.</para>
+ </sect2>
+ <sect2 id="hdbk-config-bt-languages">
+ <title>
+ <guimenu>Languages</guimenu>
+ </title>
+ <para>Here you can specify which language should be used for the
+ biblical booknames. Set this to your native language, if it is
+ available, and you'll feel at home.</para>
+
+ <para>By default, &bibletime; uses the default system
+ display font. You
+ can override this font if necessary. Some languages require
+ special fonts to be displayed correctly, and this dialog allows
+ you to specify a custom font for each language.</para>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="ss_configfonts.png" format="PNG" />
+ </imageobject>
+ <textobject>
+ <phrase>Options Dialog - fonts</phrase>
+ </textobject>
+ <caption>
+ <para>The Options dialog - Fonts.</para>
+ </caption>
+ </mediaobject>
+ <para>&bibletime; can now use all supported fonts.
+ As long as the works you are interested in display correctly
+ nothing needs to be done here. If a work only displays as a
+ series of question marks (??????) or empty boxes, then you know
+ that the standard display font does not contain the
+ characters used in this work.</para>
+
+ <para>To correct this, choose this work's language from the drop
+ down menu. Select the use custom font checkbox. Now select a
+ font. For example, a font that supports many languages is
+ Code2000. If no installed font can display the work you are
+ interested in, try installing the localization package
+ for that language.</para>
+ <sect3 id="hdbk-config-bt-addfont">
+ <title>Installing fonts</title>
+ <para>Detailed font installation instructions are outside the
+ scope of this handbook. For further information you might want
+ to refer to the
+ <ulink url="http://www.linux.org/docs/ldp/howto/Unicode-HOWTO-2.html">
+ Unicode HOWTO</ulink>.</para>
+ <tip>
+ <para>If you use a small font like Clearlyu (about 22kb),
+ &bibletime; will run faster than with a large font like
+ <trademark class="registered">Bitstream
+ Cyberbit</trademark>(about 12Mb).</para>
+ </tip>
+ </sect3>
+ <sect3 id="hdbk-config-bt-ob-font">
+ <title>Obtaining Fonts</title>
+ <para>Fonts can be obtained from a number of sources:</para>
+ <itemizedlist>
+ <listitem>
+ <para>Your *nix distribution.</para>
+ </listitem>
+ <listitem>
+ <para>Your distribution's localization packages.</para>
+ </listitem>
+ <listitem>
+ <para>An existing
+ <trademark class="registered">Microsoft
+ Windows</trademark>installation on the same
+ computer.</para>
+ </listitem>
+ <listitem>
+ <para>A font collection, such as are available from Adobe
+ or Bitstream.</para>
+ </listitem>
+ <listitem>
+ <para>Online font collections.</para>
+ </listitem>
+ </itemizedlist>
+ <para>Unicode fonts support more characters than other fonts,
+ and some of these fonts are available at no charge. None of
+ available fonts includes all characters defined in the Unicode
+ standard, so you may want to use different fonts for different
+ languages.</para>
+ <table id="hdbk-config-unicode-fonts-table">
+ <title>Unicode Fonts</title>
+ <tgroup cols="2">
+ <tbody>
+ <row>
+ <entry>
+ <ulink url="http://code2000.net/CODE2000.ZIP">
+ Code2000</ulink>
+ </entry>
+ <entry>Perhaps the best free Unicode font, covering a
+ wide range of characters.</entry>
+ </row>
+ <row>
+ <entry>
+ <ulink url="http://scripts.sil.org/cms/scripts/page.php?site_id=nrsi&amp;cat_id=FontDownloads">
+ SIL unicode fonts</ulink>
+ </entry>
+ <entry>Excellent Unicode fonts from the Summer
+ Institute of Linguistics.</entry>
+ </row>
+ <row>
+ <entry>
+ <ulink url="http://www.nongnu.org/freefont/">
+ FreeFont</ulink>
+ </entry>
+ <entry>A new free Unicode font initiative.</entry>
+ </row>
+ <row>
+ <entry>
+ <ulink url="ftp://ftp.crosswire.org/pub/sword/iso/latest/FONTS">
+ Crosswire's font directory</ulink>
+ </entry>
+ <entry>Several fonts available from the Crosswire Bible
+ Society Ftp site.</entry>
+ </row>
+ <row>
+ <entry>
+ <ulink url="ftp://ftp.netscape.com/pub/communicator/extras/fonts/windows/">
+ Bitstream CyberBit</ulink>
+ </entry>
+ <entry>Covers almost the entire range of Unicode, but
+ might slow &bibletime; down because of its
+ size.</entry>
+ </row>
+ <row>
+ <entry>Clearlyu</entry>
+ <entry>Included in some distributions. Contains
+ European, Greek, Hebrew, Thai.</entry>
+ </row>
+ <row>
+ <entry>
+ <ulink url="http://fontforge.sourceforge.net/sfds/">
+ Caslon, Monospace, Cupola, Caliban</ulink>
+ </entry>
+ <entry>Partial coverage, see information on linked
+ site.</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ <para>There are good Unicode font lists on the net, as the one
+ by Christoph Singer (
+ <ulink url="http://www.slovo.info/unifonts.htm">Multilingual
+ Unicode TrueType Fonts in the Internet</ulink>), or the one by
+ Alan Wood (
+ <ulink url="http://www.alanwood.net/unicode/fontsbyrange.html">
+ Unicode character ranges and the Unicode fonts that support
+ them</ulink>).</para>
+ </sect3>
+ </sect2>
+ <sect2 id="hdbk-config-bt-desk">
+ <title>
+ <guimenu>Desk</guimenu>
+ </title>
+ <para>Many features provided by the Sword backend can now be
+ customized in &bibletime;. These features are documented
+ right in the dialog. You also have the possibility to specify
+ standard works that should be used when no specific work is
+ specified in a reference. An example: The standard Bible is used
+ to display the content of cross references in the Bible. When you
+ hover over then, the Mag will show the content of the verses
+ referred to, according to the standard Bible you
+ specified.</para>
+ </sect2>
+ <sect2 id="hdbk-config-bt-hotkeys">
+ <title>
+ <guimenu>HotKeys</guimenu>
+ </title>
+ <para>HotKeys are special key commands that can be used in the
+ place of the menu items and icons. A number of &bibletime;'s
+ commands have predefined HotKeys (see
+ <link linkend="hdbk-reference-hotkeys">this section</link> for a
+ complete listing). Most of &bibletime;'s commands can be
+ assigned HotKeys here. This is very helpful to quickly access the
+ functions that you need the most.</para>
+ </sect2>
+ </sect1>
+</chapter>