<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN">
<book lang="de">
<bookinfo>
<title>Das Handbuch zu KiKbd</title>
<authorgroup>
<author>
<firstname>Alexander</firstname>
<surname>Budnik</surname>
<affiliation><address><email><ulink url="mailto:budnik@linserv.jinr.ru">budnik@linserv.jinr.ru</ulink></email></address></affiliation>
</author>
<author>
<firstname>Dimitrios</firstname>
<othername>P.</othername>
<surname>Bouras</surname>
<affiliation><address><email><ulink url="mailto:dbouras@hol.gr">dbouras@hol.gr</ulink></email></address></affiliation>
</author>
</authorgroup>
<date>v1.0b4, 24. M&auml;rz 1999</date>
<releaseinfo><!-- information about this particular version --></releaseinfo>
<revhistory>
<revision>
<revnumber></revnumber>
<date></date>
</revision>
</revhistory>
<abstract>
<para>Dieses Dokument beschreibt KiKbd Version 1.0b4</para>
<para>Programm zur Unterstützung länderspezifischer Tastaturen</para><!-- Merge this with the previous paragraph; it comes from <META NAME="description" CONTENT="..."> --></abstract>
<keywordset>
<keyword>keyboard</keyword>
<keyword>international</keyword>
<keyword>tastatur</keyword>
<keyword>länderspezifisch</keyword>
<keyword>national</keyword>
<keyword>umlaut</keyword>
<keyword>zeichensatz</keyword>
<keyword>zeichensätze</keyword>
</keywordset>
</bookinfo>

<chapter id="Einfuumlhrung">
<title>Einf&uuml;hrung</title>

<para>KiKbd wurde entwickelt, um die Eingabe l&auml;nderspezifischer Zeichen
(z.B. Umlaute)
zu erleichtern.</para>

<para>KiKbd bietet Unterst&uuml;tzung f&uuml;r l&auml;nderspezifische
Tastaturbelegungen, die andere Zeichens&auml;tze als Latin-1 verwenden.
Die <emphasis remap="it">klassische</emphasis> L&ouml;sung f&uuml;r diese Aufgabe ist es,
X Window Tastaturbelegungen (X keyboard maps) und Kombinationstasten zu
verwenden (bzw. seit X11R6.1 XKB-Dateien und -regeln). KiKbd kann
mehrere Tastaturbelegungen verwalten und dynamisch zwischen ihnen
umschalten.</para>

<para>KiKbd verwendet den Xmodmap-Mechanismus, um l&auml;nderspezifische
Tastaturbelegungen f&uuml;r X11-Anwendungen bereitzustellen. Es kann
aber dar&uuml;ber hinaus dynamisch zwischen mehreren Tastaturbelegungen
umschalten und dadurch mehrere Sprachen gleichzeitig unterst&uuml;tzen.</para>

<para>Au&szlig;erdem kann KiKbd einzelnen Anwendungen oder sogar einzelnen
Fenstern Tastaturbelegungen zuweisen. Dazu werden die Modi namens
<emphasis remap="it">Fenster</emphasis> bzw. <emphasis remap="it">Klassen</emphasis> verwendet</para>
</chapter>

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

<para>Installation vom Quellcode (wie &uuml;blich):</para>

<para><programlisting>% ./configure
% make
% make install</programlisting>
</para>

<para>Um KiKbd zu kompilieren, wird KDE 1.0 oder h&ouml;her ben&ouml;tigt.</para>

<para>Seit KDE Version 1.1 ist KiKbd Bestandteil des
<emphasis remap="it">kdebase</emphasis> Pakets.</para>
</chapter>

<chapter id="LaumlnderspezifischeTastaturbelegungen">
<title>L&auml;nderspezifische Tastaturbelegungen</title>

<para>KiKbd unterst&uuml;tzt sprachspezifische bzw. l&auml;nderspezifische
Tastaturbelegungen und bietet dabei bis zu vier Zeichen pro Taste. Zum
Beispiel gibt es bei einer russischen Tastatur vier Zeichen f&uuml;r
die Q-Taste: kurzes i, gro&szlig;geschriebenes kurzes I, kleines q und
gro&szlig;es Q. Die ersten beiden Zeichen geh&ouml;ren zum russischen
Zeichensatz, die beiden anderen sind als alternative Zeichen vorhanden.</para>

<para>In der KiKbd Konfiguration l&auml;&szlig;t sich eine spezielle Taste als
Alternativ-Taste bestimmen. Details finden sich im Abschnitt
<link linkend="config">Einstellungen</link>. Bei einem einfachen Tastendruck
wird das erste der vier m&ouml;glichen Zeichen benutzt. Das zweite der
zugeordneten Zeichen erscheint, wenn gleichzeitig die Shift-Taste
festgehalten wird. Das dritte Zeichen wird erzeugt, wenn bei der
Tastenbet&auml;tigung die Alternativ-Taste festgehalten wird, und
schlie&szlig;lich das vierte, wenn gleichzeitig Shift- und
Alternativ-Taste festgehalten werden.</para>

<para>Zum Zeitpunkt der Erstellung dieser Dokumentation waren bereits mehr
als zwanzig l&auml;nderspezifische Tastaturbelegungen als Teil des
KiKbd Pakets verf&uuml;gbar.</para>

<para>Sollte eine von Ihnen ben&ouml;tigte Tastaturbelegung fehlen, so kann
Ihnen der Abschnitt <link linkend="create">Erstellen einer neuen Tastaturbelegung</link> weiterhelfen.</para>
</chapter>

<chapter id="config">
<title>Einstellungen</title>

<para>Mit dem Programm kcmikbd lassen sich alle Laufzeit-Einstellungen
vornehmen. Beim ersten Start des Programms wird es zun&auml;chst die
Standardkonfiguration &uuml;bernehmen. Darauf basierend k&ouml;nnen Sie
die von Ihnen gew&uuml;nschten &Auml;nderungen vornehmen.</para>

<sect1 id="einstellungen">
<title>Allgemeine Einstellungen</title>

<para><graphic fileref="general.png"></graphic></para>

<sect2>
<title>Tastaturbelegungen</title>

<para>Mit den Kn&ouml;pfen <emphasis remap="it">Hinzuf&uuml;gen</emphasis> und <emphasis remap="it">L&ouml;schen</emphasis>
l&auml;&szlig;t sich Ihre Liste von Tastaturbelegungen bearbeiten. KiKbd
startet mit der ersten Tastaturbelegung in der Liste. (Im Bild w&auml;re
das die englische Tastaturbelegung <emphasis remap="it">En</emphasis>.)</para>

<para>Werden mehr als zwei Tastaturbelegungen verwendet, so ist es hilfreich
die Option <emphasis remap="it">Hotlist verwenden</emphasis> zu aktivieren. Dann kann man mit
den Wechsel-Tasten zwischen der <emphasis remap="it">hot (=hei&szlig;en)</emphasis>
Tastaturbelegung und der Voreinstellung hin- und herschalten. Welche
Tastaturbelegung <emphasis remap="it">hot</emphasis> ist, l&auml;&szlig;t sich mit KiKbd
Popup-Men&uuml; ausw&auml;hlen.</para>
</sect2>

<sect2>
<title>Wechseln und Alt-Wechseln</title>

<para>Die Option &quot;Wechseln&quot; bestimmt welche Taste (bzw. welche
Tastenkombination) zum Umschalten zwischen Tastaturbelegungen benutzt
werden kann (im Bild wird die Kombination Rechts-Strg und Rechts-Shift
verwendet).</para>

<para>Um kurzzeitig die Funktion der Tasten zu wechseln wird die
Alternativ-Taste verwendet. Unter &quot;Alt-Wechseln&quot;
l&auml;&szlig;t sich die Taste (bzw. Tastenkombination) f&uuml;r die
Alternativ-Taste ausw&auml;hlen (im Bild wird Rechts-Alt verwendet).</para>
</sect2>

<sect2>
<title>Ton</title>

<para>Wenn diese Option gew&auml;hlt wird, so erzeugt KiKbd ein akustisches
Signal beim Wechseln der Tastaturbelegung.</para>
</sect2>
</sect1>
<sect1 id="advanced">
<title>Erweiterte Einstellungen</title>

<para><graphic fileref="advanced.png"></graphic></para>

<sect2>
<title>Weltmen&uuml;</title>

<para>Wird diese Option aktiviert, so steht in jedem Fenster ein
Popup-Men&uuml; zur Verf&uuml;gung. Es erscheint wenn die Wechsel-Tasten
f&uuml;r eine ausreichend lange Zeit gedr&uuml;ckt werden. (In der
Standardeinstellung erscheint das Men&uuml; wenn Rechts-Strg und
Rechts-Shift ausreichend lange festgehalten werden.)</para>
</sect2>

<sect2>
<title>Emuliere CapsLock</title>

<para>F&uuml;r manche Tastaturbelegungen (z.B. russisch oder griechisch) ist
das &uuml;bliche CapsLock ungeeignet. KiKbd kann CapsLock auf geeignete
Weise emulieren. Ob CapsLock aktiviert ist, oder nicht, wird dann nicht
&uuml;ber die Tastatur-LED sondern &uuml;ber die Farbe des
KiKbd-Schalters angezeigt.</para>
</sect2>

<sect2>
<title>Eingabe-Modus</title>

<para>Folgende Eingabe-Modi stehen zur Verf&uuml;gung:</para>

<para><itemizedlist>
<listitem>
<para>Global - &quot;Standard&quot;: Die ausgew&auml;hlte Tastaturbelegung
wird in allen Fenstern verwendet.</para>
</listitem>
<listitem>
<para>Fenster - &quot;Erweitert&quot;: KiKbd merkt sich die Tastaturbelegung
f&uuml;r jedes Fenster.</para>
</listitem>
<listitem>
<para>Klasse - &quot;Anwendungsspezifisch&quot;: KiKbd merkt sich die
Tastaturbelegung f&uuml;r jede Anwendungsklasse. Z.B. wird in einem
Kedit-Fenster auf russisch umgestellt, dann wird automatisch in allen
anderen Kedit-Fenstern auch russisch verwendet.</para>
</listitem>
</itemizedlist>
</para>
</sect2>

<sect2>
<title>Klassen speichern</title>

<para>Ist als Eingabe-Modus &quot;Klasse&quot; ausgew&auml;hlt worden, dann
l&auml;&szlig;t sich diese Option ausw&auml;hlen. Wird sie aktiviert, so
wird die Assoziation zwischen Tastaturbelegung und Anwendungsklasse
beim Beenden von KDE automatisch gespeichert. Ist vor dem Beenden der
KDE Sitzung in Kedit beispielsweise die russische Tastaturbelegung
ausgew&auml;hlt worden, so wird sie beim n&auml;chsten Start von KDE
automatisch wiederhergestellt.</para>
</sect2>
</sect1>

<sect1 id="stil">
<title>Stil</title>

<para>Der Zeichensatz und die Farben des KiKbd-Schalters lassen sich frei
w&auml;hlen:</para>

<para><graphic fileref="style.png"></graphic></para>

<sect2>
<title>Vordergrund</title>

<para>Die Farbe des Schaltertexts.</para>
</sect2>

<sect2>
<title>Hintergrund</title>

<para>Hintergrundfarbe des Schaltertexts.</para>
</sect2>

<sect2>
<title>Mit CapsLock</title>

<para>Hintergrundfarbe des Schaltertexts, wenn CapsLock-Emulation aktiv
ist und CapsLock eingeschaltet wurde.</para>
</sect2>

<sect2>
<title>Mit Alternieren</title>

<para>Hintergrundfarbe des Schaltertexts, wenn die Alternativ-Taste
festgehalten wird.</para>
</sect2>

<sect2>
<title>Schalter-Schriftart</title>

<para>Erlaubt die Auswahl einer Schriftart f&uuml;r den KiKbd-Schalter, die
von den KDE Einstellungen abweicht.</para>
</sect2>
</sect1>

<sect1 id="programmstart">
<title>Programmstart</title>

<para><graphic fileref="startup.png"></graphic></para>

<sect2>
<title>Autostart</title>

<para>Wenn diese Einstellung gew&auml;hlt ist, dann wird KiKbd
bei Beginn der KDE Sitzung automatisch gestartet.</para>
</sect2>

<sect2>
<title>Eingebunden in Kontrolleiste</title>

<para>Wenn diese Einstellung gew&auml;hlt ist, dann wird KiKbd in die
Kontrolleiste eingebunden.</para>
</sect2>

<sect2>
<title>Plazieren</title>

<para>Wenn Sie KiKbd nicht in die Kontrolleiste einbinden wollen,
so k&ouml;nnen Sie es statt dessen in einer der vier Bildschirmecken
plazieren.</para>
</sect2>
</sect1>
</chapter>

<chapter id="create">
<title>Erstellen einer neuen Tastaturbelegung</title>

<para>Alle systemweit bekannten Tastaturbelegungsdateien sind in
<emphasis remap="it">&dollar;KDEDIR/share/apps/kikbd</emphasis> und alle benutzerspezifischen
in <emphasis remap="it">&dollar;HOME/.kde/share/apps/kikbd</emphasis> untergebracht. Alle
Tastaturbelegungsdateien haben die Endung <emphasis remap="it">.kimap</emphasis>. Existiert
eine benutzerspezifische Tastaturbelegung mit dem gleichen Dateinamen
wie eine systemweite, so wird die systemweite durch die
benutzerspezifische verdeckt.</para>

<para>Um eine neue Tastaturbelegung zu erstellen, empfiehlt es sich, eine
bereits existierendes <emphasis remap="it">.kimap</emphasis>-Datei als Vorlage zu verwenden.
Diese Dateien sind in zwei Abschnitte gegliedert:</para>

<variablelist>
<varlistentry>
<term>International Keyboard</term>
<listitem>
<para>In diesem Abschnitt sind die folgenden Eintr&auml;ge untergebracht:</para>
<para><itemizedlist>
<listitem>
<para>Authors - Liste der Autoren (Eintr&auml;ge sind durch Kommas
getrennt). Die Autoren werden in der Form &quot;Vorname Nachname &lt;Email-Adresse&gt;&quot; angegeben;</para>
</listitem>
<listitem>
<para>Comment** - Kommentar zu dieser Tastaturbelegung;</para>
</listitem>
<listitem>
<para>Language** - Sprache, f&uuml;r die diese Tastaturbelegung gedacht
ist;</para>
</listitem>
<listitem>
<para>Charset - Zeichensatz f&uuml;r diese Tastaturbelegung;</para>
</listitem>
<listitem>
<para>Locale - Land/Region, f&uuml;r die diese Tastaturbelegung gedacht
ist;</para>
</listitem>
<listitem>
<para>Label* - Eintrag zur Identifikation dieser Tastaturbelegung.</para>
</listitem>
</itemizedlist>
</para>

<para>* - zwingend erforderlicher Eintrag
** - diese Eintr&auml;ge k&ouml;nnen f&uuml;r mehrere Sprachen angegeben
werden</para>
</listitem>
</varlistentry>
<varlistentry>
<term>KeyboardMap</term>
<listitem>
<para>Dieser Abschnitt definiert die Zuordnung der Tasten zu 2-4 Zeichen.
Dabei wird folgendes Format verwendet:</para>

<para><literal remap="verb">keysym&lt;num&gt; = &lt;default sym&gt;,&lt;sym1&gt;,&lt;sym2&gt;,&lt;sym3&gt;,&lt;sym4&gt;,</literal></para>

<para>oder dieses Format (Tastatur-Codes zu Zeichen):</para>

<para><literal remap="verb">keycode&lt;num&gt; = &lt;key code&gt;,&lt;sym1&gt;,&lt;sym2&gt;,&lt;sym3&gt;,&lt;sym4&gt;,</literal></para>

<para>Dabei steht <emphasis remap="it">num</emphasis> f&uuml;r eine eindeutige Zahl, <emphasis remap="it">sym</emphasis>
steht f&uuml;r ein Zeichen (=Symbol) entweder in hexadezimaler Form oder
mit einem von X11 interpretierbaren Namen. <emphasis remap="it">key code</emphasis> steht
f&uuml;r eine Dezimalzahl und <emphasis remap="it">default sym</emphasis> steht f&uuml;r das
voreingestellte Zeichen f&uuml;r diese Taste (das Zeichen, das der Taste
zugeordnet w&uuml;rde, wenn KiKbd nicht eingeschaltet w&auml;re).</para>

<para>Die beiden ersten Zeichen <emphasis remap="it">sym1, sym2</emphasis> sind die
<emphasis remap="it">l&auml;nderspezifischen</emphasis> Zeichen, <emphasis remap="it">sym3, sym4</emphasis> sind die
alternativen Zeichen. Der Autor empfiehlt, ausschlie&szlig;lich das
<emphasis remap="it">keysym</emphasis>-Format zu verwenden.</para>

<para>Au&szlig;erdem k&ouml;nnen in diesem Abschnitt <emphasis remap="it">CapsSymbols</emphasis>
definiert werden. Dies sind die Zeichen, die w&auml;hrend der
CapsLock-Emulation aktiv sein sollen. Das Format ist eine Reihe von
durch Komma getrennten Zeichen des Latin-Zeichensatzes.</para>
</listitem>
</varlistentry>
</variablelist>

<para>Sollten Sie eine neue Tasturbelegung erstellt und getestet haben, so
w&uuml;rden wir uns freuen, wenn Sie sie den Autoren (bzw. Verwaltern)
von KiKbd zur Verf&uuml;gung stellen.</para>
</chapter>

<chapter id="ProblemeundLoumlsungen">
<title>Probleme und L&ouml;sungen</title>

<sect1 id="fehlermeldung">
<title>Fehlermeldung: &quot;Can not find symbol&quot;</title>

<para>Diese Fehlermeldung kann erscheinen, wenn Ihr X-Server vor dem Start von
KiKbd ungebr&auml;uchliche Zeichen geladen hat, die nicht zu den
Latin-Zeichens&auml;tzen geh&ouml;ren. Seit Version 1.0b1 ist es
m&ouml;glich, in den <link linkend="advanced">erweiterten Einstellungen</link> Zeichen vorzudefinieren, um das Problem zu l&ouml;sen.</para>
</sect1>

<sect1 id="bildschirmschonerprobleme">
<title>Probleme mit Bildschirmschonern</title>

<para>Es kann zu Problemen kommen, wenn der Bildschirmschoner aktiviert wird,
w&auml;hrend eine l&auml;nderspezifische Tastaturbelegung eingestellt
ist. Dann l&auml;&szlig;t sich das Pa&szlig;wort nur schwer eingeben.
Die L&ouml;sung besteht darin, KDE Bildschirmschoner zu verwenden. KiKbd
schaltet automatisch zur voreingestellten Tastaturbelegung (die erste in
der Liste, &uuml;blicherweise US-Englisch), sobald ein KDE
Bildschirmschoner das Pa&szlig;wort abfragt.</para>

<para>Das Problem l&auml;&szlig;t sich auch l&ouml;sen, indem man den
Standardzeichensatz mittels der Alternativ-Taste einschaltet. Dann
l&auml;&szlig;t sich das Pa&szlig;wort wie gewohnt eingeben.</para>
</sect1>

<sect1 id="fehlerberichte">
<title>Fehlerberichte</title>

<para>Bitte melden Sie Fehler auf dieser Webseite:
<ulink url="http://buglist.kde.org">http://buglist.kde.org</ulink></para>
</sect1>
</chapter>

<chapter id="AutorenundUumlbersetzer">
<title>Autoren und &Uuml;bersetzer</title>

<para>KiKbd wurde geschrieben von:
<ulink url="mailto:budnik@linserv.jinr.ru">Alexander Budnik</ulink>
und
<ulink url="mailto:dbouras@hol.gr">Dimitrios P. Bouras</ulink></para>

<para>Deutsche &Uuml;bersetzung von Stefan Doll:
<ulink url="mailto:stefan@i-2000.com">&lt;stefan@i-2000.com&gt;</ulink></para>
</chapter>
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->
