<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd" [
 <!ENTITY kheisereg "<application>KHeiseReg</application>">
 <!ENTITY kappname "&kheisereg;">
 <!ENTITY KDE "<abbrev>KDE</abbrev>">
 <!ENTITY % addindex "IGNORE">
 <!ENTITY % German "INCLUDE">
]>

<book lang="&language;">

<bookinfo>
<title>Das &kheisereg;-Handbuch</title>
<authorgroup>
<author>
<firstname>Oliver</firstname><surname>Gantz</surname>
<affiliation><address><email>Oliver.Gantz@ePost.de</email></address>
</affiliation>
</author>
</authorgroup>

<copyright>
<year>2002</year>
<holder>Oliver Gantz</holder>
</copyright>

<legalnotice>&FDLNotice;</legalnotice>

<date>2002-04-08</date>
<releaseinfo>0.2</releaseinfo>

<abstract>
<para>
 Dieses Handbuch beschreibt &kheisereg; Version 0.2
</para>
</abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>KHeiseReg</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title>Einführung</title>

<para>Dies ist &kheisereg;, ein &KDE;-basiertes Programm zur Suche von Artikeln im
 Heise-Register.</para>

<sect1 id="kheisereg-revhistory">
<title>&kheisereg;-Versionsliste</title>
<para>
<itemizedlist>
<listitem><para>
 Version 0.1
 <itemizedlist>
 <listitem><para>Erste öffentliche Ausgabe.</para></listitem>
 </itemizedlist>
</para></listitem>
<listitem><para>
 Version 0.2
 <itemizedlist>
 <listitem><para>%kheisereg; wurde nach &KDE; 3 portiert.</para></listitem>
 </itemizedlist>
</para></listitem>
</itemizedlist>
</para>
</sect1>
</chapter>

<chapter id="installation">
<title>Installation</title>

<sect1 id="getting-kheisereg">
<title>Wie Sie &kheisereg; bekommen</title>

<para>Sie können die neueste Version von &kheisereg; von der
<ulink url="http://www.tu-bs.de/~y0000441/kheisereg/index.html">&kheisereg;-Seite</ulink> bekommen.</para>
</sect1>

<sect1 id="requirements">
<title>Anforderungen</title>

<para>Für die Installation und den Betrieb von &kheisereg; muß
 &KDE; 2.x auf Ihrem System richtig installiert sein.</para>

</sect1>

<sect1 id="compilation">
<title>Übersetzung und Installation</title>

<para>Um &kheisereg; auf Ihrem System zu übersetzen und zu installieren, geben Sie
 bitte folgendes im Basisverzeichnis der &kheisereg;-Distribution ein:
<screen width="40">
<prompt>%</prompt> <userinput>./configure</userinput>
<prompt>%</prompt> <userinput>make</userinput>
<prompt>%</prompt> <userinput>make install</userinput>
</screen>
</para>

<para>Da &kheisereg; <command>autoconf</command> und <command>automake</command>
 benutzt, sollten Sie keine Probleme bei der Übersetzung haben. Sollten Sie
 dennoch Probleme damit haben, sollten Sie diese dem Autor
 <ulink url="mailto:Oliver.Gantz@epost.de">Oliver Gantz</ulink> melden.</para>

</sect1>

</chapter>

<chapter id="main-window">
<title>Hauptfenster</title>

<para>Das Hauptfenster wird sichtbar, sobald Sie &kheisereg; starten.</para>

<sect1 id="main-dialog-elements">
<title>Dialogelemente</title>

<para>Das Hauptfenster enthält eine Menüleiste, eine Werkzeugleiste, eine Liste mit
 gefundenen Artikeln, einen Bereich mit den Details eines Artikels und eine
 Statusleiste.</para>

<para>Die Funktion der <guilabel>Menüleiste</guilabel> wird im
 <link linkend="main-menu-entries">Menüeinträge-Abschnitt</link> beschrieben.</para>
<para>Die <guilabel>Werkzeugleiste</guilabel> stellt einen schnellen Zugriff
 auf häufig benötigte Menükommandos zur Verfügung.</para>
<para>Die Liste zeigt nach einer Suche alle gefundenen Artikel an.</para>
<para>Im Fensterbereich darunter werden Details zu dem Artikel angezeigt, der gerade
 in der Liste darüber ausgewählt wurde.</para>

<para>Die <guilabel>Statusleiste</guilabel> gibt Ihnen kurze Hinweise darüber,
 was gerade vor sich geht.</para>

</sect1>

<sect1 id="main-menu-entries">
<title>Menüeinträge</title>

<!-- The File Menu -->
<sect2>
<title>Das <guimenu>Datei</guimenu>-Menü</title>

<para>
<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo><keycap>Strg</keycap><keycap>A</keycap></keycombo>
</shortcut>
<guimenu><accel>D</accel>atei</guimenu>
<guimenuitem>Registerdatei <accel>a</accel>nhängen</guimenuitem>
</menuchoice></term>
<listitem><para><action>
 Öffnet den Dialog zum Anhängen von Registerdateien.
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo><keycap>Strg</keycap><keycap>Q</keycap></keycombo>
</shortcut>
<guimenu><accel>D</accel>atei</guimenu>
<guimenuitem>B<accel>e</accel>enden</guimenuitem>
</menuchoice></term>
<listitem><para><action>
 Beendet &kheisereg;.
</action></para></listitem>
</varlistentry>

</variablelist>
</para>

</sect2>

<!-- The Search Menu -->
<sect2>
<title>Das <guimenu>Suchen</guimenu>-Menü</title>

<para>
<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo><keycap>Strg</keycap><keycap>F</keycap></keycombo>
</shortcut>
<guimenu><accel>S</accel>uchen</guimenu>
<guimenuitem><accel>S</accel>uchen</guimenuitem>
</menuchoice></term>
<listitem><para><action>
 Öffnet den Suchen-Dialog.
</action></para></listitem>
</varlistentry>

</variablelist>
</para>

</sect2>


<!-- The Settings Menu -->
<sect2>
<title>Das <guimenu>Einstellungen</guimenu>-Menü</title>

<para>
<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo><keycap>Strg</keycap><keycap>T</keycap></keycombo>
</shortcut>
<guimenu><accel>E</accel>instellungen</guimenu>
<guimenuitem><accel>W</accel>erkzeugleiste anzeigen</guimenuitem>
</menuchoice></term>
<listitem><para><action>
 Blendet die Werkzeugleiste ein oder aus.
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo><keycap>Strg</keycap><keycap>S</keycap></keycombo>
</shortcut>
<guimenu><accel>E</accel>instellungen</guimenu>
<guimenuitem><accel>S</accel>tatusleiste anzeigen</guimenuitem>
</menuchoice></term>
<listitem><para><action>
 Blendet die Statusleiste ein oder aus.
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>E</accel>instellungen</guimenu>
<guimenuitem>Einstellungen s<accel>p</accel>eichern</guimenuitem>
</menuchoice></term>
<listitem><para><action>
 Speichert die momentanen Fenstereinstellungen.
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>E</accel>instellungen</guimenu>
<guimenuitem>KHeiseReg <accel>e</accel>inrichten...</guimenuitem>
</menuchoice></term>
<listitem><para><action>
 Öffnet den Einrichten-Dialog.
</action></para></listitem>
</varlistentry>

</variablelist>
</para>

</sect2>


<!-- The Help Menu -->
<sect2>
<title>Das <guimenu>Hilfe</guimenu>-Menü</title>

<para>
<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycap>F1</keycap>
</shortcut>
<guimenu><accel>H</accel>ilfe</guimenu>
<guimenuitem>I<accel>n</accel>halt</guimenuitem>
</menuchoice></term>
<listitem><para><action>
 Startet das &KDE;-Hilfesystem und zeigt die &kheisereg;-Hilfeseiten an.
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo><keycap>Umschalt</keycap><keycap>F1</keycap></keycombo></shortcut>
<guimenu><accel>H</accel>ilfe</guimenu>
<guimenuitem>Was ist <accel>d</accel>as?</guimenuitem>
</menuchoice></term>
<listitem><para><action>
 Zeigt eine kurze Beschreibung von Dialogelementen an.
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>H</accel>ilfe</guimenu>
<guimenuitem>Be<accel>r</accel>ichten Sie Probleme oder Wünsche...</guimenuitem>
</menuchoice></term>
<listitem><para><action>
 Erstellen und Senden eines Fehlerberichts.
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>H</accel>ilfe</guimenu>
<guimenuitem><accel>Ü</accel>ber KHeiseReg</guimenuitem>
</menuchoice></term>
<listitem><para><action>
 Öffnet ein Fenster mit wesentlichen Informationen über &kheisereg;.
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>H</accel>ilfe</guimenu>
<guimenuitem>Über <accel>K</accel>DE</guimenuitem>
</menuchoice></term>
<listitem><para><action>
 Öffnet ein Fenster mit wesentlichen Informationen über &KDE;.
</action></para></listitem>
</varlistentry>

</variablelist>
</para>

</sect2>

</sect1>

<sect1 id="main-key-bindings">
<title>Tastenkürzel</title>

<para>
<variablelist>

<varlistentry>
<term>
<keycombo><keycap>Strg</keycap><keycap>A</keycap></keycombo>
</term>
<listitem><para><action>
 Öffnet den Dialog zum Anhängen von Registerdateien.
</action></para></listitem>
</varlistentry>

<varlistentry>
<term>
<keycombo><keycap>Strg</keycap><keycap>F</keycap></keycombo>
</term>
<listitem><para><action>
 Öffnet den Suchen-Dialog.
</action></para></listitem>
</varlistentry>

<varlistentry>
<term>
<keycombo><keycap>Strg</keycap><keycap>Q</keycap></keycombo>
</term>
<listitem><para><action>
 Beendet &kheisereg;.
</action></para></listitem>
</varlistentry>

<varlistentry>
<term>
<keycombo><keycap>Strg</keycap><keycap>S</keycap></keycombo>
</term>
<listitem><para><action>
 Blendet die Statusleiste ein oder aus.
</action></para></listitem>
</varlistentry>

<varlistentry>
<term>
<keycombo><keycap>Strg</keycap><keycap>T</keycap></keycombo>
</term>
<listitem><para><action>
 Blendet die Werkzeugleiste ein oder aus.
</action></para></listitem>
</varlistentry>

<varlistentry>
<term>
<keycap>F1</keycap>
</term>
<listitem><para><action>
 Startet das &KDE;-Hilfesystem und zeigt die &kheisereg;-Hilfeseiten an.
</action></para></listitem>
</varlistentry>

</variablelist>
</para>

</sect1>

</chapter>


<chapter id="append-dialog">
<title>Registerdatei anhängen-Dialog</title>
<anchor id="append-help"/>

<para>Sie können den Registerdatei anhängen-Dialog durch das Menükommando
 <menuchoice><guimenu>Datei</guimenu><guimenuitem>Registerdatei anhängen</guimenuitem></menuchoice>
 öffnen.</para>

<para>Dieser Dialog zeigt den Stand der internen Registerdatei-Datenbank an und
 ermöglicht es, zusätzliche Registerdateien an die Datenbank anzuhängen.</para>

<para>Unter <guilabel>Datenbank-Status</guilabel> sehen Sie nach Zeitschriften
 getrennt die Nummern der jeweils ersten und letzten Ausgabe in der Datenbank.
 Die Anzahl der enthaltenen Artikel wird ebenfalls angezeigt.</para>

<para>Durch Betätigung des Knopfes <guibutton>Anhängen</guibutton> öffnet sich
 ein Datei-Dialog, mit dem Sie eine neue Registerdatei im Verzeichnisbaum
 ausfindig machen und auswählen können. Die ausgewählte Registerdatei wird dann
 einer Prüfung unterzogen, ob es sich um eine gültige Heise-Registerdatei handelt.
 Außerdem wird geprüft, ob die neue Registerdatei keine Ausgaben einer Zeitschrift
 enthält, die bereits in der Registerdatei-Datenbank enthalten sind. Ist die
 Registerdatei fehlerfrei, wird sie an die Datenbank angehängt.</para>

</chapter>


<chapter id="search-dialog">
<title>Suchen-Dialog</title>
<anchor id="search-help"/>

<para>Sie können den Suchen-Dialog durch das Menükommando
 <menuchoice><guimenu>Suchen</guimenu><guimenuitem>Suchen</guimenuitem></menuchoice>
 öffnen.</para>

<para>In diesem Dialog können Sie die Parameter angeben, nach denen Artikel gesucht
 werden sollen.</para>

<para>Bei <guilabel>Schlagwörter</guilabel> können Sie Begriffe angeben, die mit
 den zu den Artikel gespeicherten Schlagwörtern sowie Titel und Untertitel der
 Artikel abgeglichen werden.</para>

<para>Bei <guilabel>Autoren</guilabel> können Sie die Namen von Autoren angeben.</para>

<para>Bei <guilabel>Redakteure</guilabel> können Sie die Kürzel von Redakteuren
 angeben. Diese Kürzel sind bis zu 3 Zeichen lang.</para>

<para>Für die Angaben bei <guilabel>Schlagwörter</guilabel>, <guilabel>Autoren</guilabel>
 und <guilabel>Redakteure</guilabel> gelten folgende Regeln:</para>

<table>
<title>Regeln für Suchbegriffe</title>
<tgroup cols="2">
<thead>
<row>
<entry>Suchbegriff</entry>
<entry>Ergebnis</entry>
</row>
</thead>

<tbody>

<row>
<entry><userinput>linux kde</userinput></entry>
<entry>Texte, in denen das Word &quot;linux&quot; <emphasis>oder</emphasis>
 &quot;kde&quot; vorkommt.</entry>
</row>

<row>
<entry><userinput>+linux +kde</userinput></entry>
<entry>Texte, in denen das Word &quot;linux&quot; <emphasis>und</emphasis>
 &quot;kde&quot; vorkommt.</entry>
</row>

<row>
<entry><userinput>linux -kde</userinput></entry>
<entry>Texte, in denen das Word &quot;linux&quot; <emphasis>aber nicht</emphasis>
 &quot;kde&quot; vorkommt.</entry>
</row>

<row>
<entry><userinput>linux &quot;kde 2.0&quot;</userinput></entry>
<entry>Texte, in denen das Word &quot;linux&quot; <emphasis>oder</emphasis>
 &quot;kde 2.0&quot; vorkommt.</entry>
</row>

</tbody>
</tgroup>
</table>

<para>Bei <guilabel>Ausgaben</guilabel> können Sie durch Leerzeichen getrennt
 eine Liste von Ausgabenummern angeben.</para>

<para>Bei <guilabel>Jahre</guilabel> könne Sie durch Leerzeichen getrennt eine
 Liste von Jahreszahlen angeben. Es werden sowohl zwei- als auch vierstellige
 Angaben akzeptiert.</para>

<para>Unter <guilabel>Zeitschriften</guilabel> können Sie die Zeitschriften
 auswählen, in denen nach Artikeln gesucht werden soll.</para>

<para>Wenn <guilabel>Gross-/Kleinschreibung</guilabel> aktiviert ist, werden
 Gross- und Kleinbuchstaben bei der Suche unterschieden, sonst nicht.</para>

<para>Wenn <guilabel>Unscharf</guilabel> aktiviert ist, wird eine fehlertolerante
 Suche durchgeführt. Den Grad der Übereinstimmung können Sie mit dem Schieberegler
 einstellen. Ein hoher Grad bedeutet eine geringe Fehlertoleranz, ein niedriger
 Grad eine hohe Fehlertoleranz. Ein niedriger Grad führt zu mehr Treffern.</para>

</chapter>



<chapter id="configure-dialog">
<title>Einrichten-Dialog</title>
<anchor id="configure-help"/>

<para>Sie können den Einrichten-Dialog durch das Menükommando
 <menuchoice><guimenu>Einstellungen</guimenu><guimenuitem>KHeiseReg einrichten</guimenuitem></menuchoice>
 öffnen.</para>

<sect1 id="configure-general-page">
<title>Allgemein-Seite</title>

<para>Diese Seite stellt einige allgemeine Einstellungen zur Verfügung.</para>
<para><guilabel>Zeige Kurzinfos</guilabel> aktiviert die Kurzinfos in den
 Dialogen.</para>

</sect1>

<sect1 id="configure-search-page">
<title>Suchen-Seite</title>

<para>Auf dieser Seite können Sie Voreinstellungen für den Suchen-Dialog eingeben.
 Diese Einstellungen werden beim Programmstart von &kheisereg; in den Suchen-Dialog
 übernommen oder wenn Sie im Suchen-Dialog den Knopf <guibutton>Voreinstellung</guibutton>
 betätigen.</para>

<para>Eine detailierte Beschreibung der einzelnen Angaben finden Sie unter
 <link linkend="search-dialog">Suchen-Dialog</link>.</para>

</sect1>

</chapter>


<chapter id="legal-information">
<title>Urheberrecht</title>

<sect1 id="legal-information-license">
<title>Lizenz</title>

<para>&kheisereg; - Ein &KDE;-basiertes Programm zur Suche von Artikeln im Heise
 Register.</para>

<para>Copyright &copy; 2002 Oliver Gantz <email>Oliver.Gantz@epost.de</email>.</para>

&underFDL;

&underGPL;

</sect1>

<sect1 id="legal-information-trademarks">
<title>Warenzeichen</title>

<para>Alle verwendeten Warenzeichen sind Eigentum ihrer jeweiligen Besitzer.</para>

</sect1>

</chapter>

&documentation.index;
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:
-->
