 <sect1 id="gkbapplet">
  <title>GNOME Billentyűzet átkapcsoló applet</title>

  <para>
   <application>GNOME Billentyűzet-átkapcsoló applet</application>, mely az alapértelemezett
   beállításokkal látható a <xref
   linkend="gkbapplet-fig"> ábrán, segít gyorsan és könnyen kicserélni a
  billentyűzet-kiosztásod, ha többfélét használsz. Az applet
  <interface>Panel</interface>-hez adásához kattints jobb egérgombbal a
   <interface>Panel</interface>-re, majd válaszd ki a
   <menuchoice>
    <guimenu>Panel</guimenu>
    <guisubmenu>Panelra helyezés</guisubmenu>
    <guisubmenu>Applet</guisubmenu>
    <guisubmenu>Segédprogramok</guisubmenu>
    <guimenuitem>GKB Billentyűzet-átkapcsoló</guimenuitem>
   </menuchoice> menüelemet.
  </para>

  <figure id="gkbapplet-fig">
   <title>GNOME billentyűzet-átkapcsoló</title>
   <screenshot>
    <screeninfo>GNOME billentyűzet átkapcsoló</screeninfo>
    <graphic format="png" fileref="figures/gkb_applet"
    srccredit="emese">
    </graphic>
   </screenshot>
  </figure>


  <!-- ============= Usage  ================================ -->
  <sect2 id="gkb-usage">
   <title>Használat</title>
   <para>
    Ha beállítottad, a <application>GKB
    Billentyűzet-átkapcsoló</application> applet segítségével átkapcsolhatsz
    az általad használt billentyűzetek között. Kattints bal
    egérgombbal az appletre vagy nyomd le a <keycombo><keycap>Alt</keycap>
    <keycap>Shift</keycap></keycombo> billentyűkombninációt.
   </para>

   <para>
    Ha jobb egérgombbal kattintassz az appletre, a következő elemeket
    tartalmazó menüt kapod:
    <itemizedlist>

     <listitem>
      <para>
       <guimenuitem>Tulajdonságok&hellip;</guimenuitem> &mdash;
       megnyitja a <link linkend="gkbapplet-prefs">
       <guilabel>GKB beállítások</guilabel></link> párbeszédablakot.
      </para>
     </listitem>

     <listitem>
      <para>
       <guimenuitem>Súgó</guimenuitem> &mdash;
       megjeleníti ezt a dokumentumot.
      </para>
     </listitem>

     <listitem>
      <para>
       <guimenuitem>Névjegy&hellip;</guimenuitem> &mdash;
       információt jelenít meg a <application>GNOME
       Billentyűzet-átkapcsoló</application> írójáról és
       az appletről.
      </para>
     </listitem>

    </itemizedlist>
   </para>
  </sect2>


  <!-- ============= Customization ============================= -->
  <sect2 id="gkbapplet-prefs">
    <title>Beállítások</title>
    <para>
	      Testreszabhatod a <application>GNOME
       Billentyűzet-átkapcsoló</application> appletet, ha jobb gombbal rákattintasz és megnyitod a
       <guimenuitem>Tulajdonságok&hellip;</guimenuitem> menüelem alatt rejtőző párbeszédablakot (ez látható
       a <xref linkend="gkbapplet-settings-fig"> ábrán). Ezen a párbeszédablakon állíthatsz be új
       billentyűzetkiosztást, módosíthatod a meglévőt vagy eltávolíthatod azt, amelyikre már nincs szükséged,
       valamint itt <link linkend="gkbapplet-options">állíthatod be az applet kinézetét is</link>.
	</para>

	    <figure id="gkbapplet-settings-fig">
	     <title>Tulajdonságok párbeszédablak</title>
	     <screenshot>
	      <screeninfo>Tulajdonságok párbeszédablak</screeninfo>
	      <graphic format="png" fileref="figures/gkb_applet_settings"
	      srccredit="emese">
	      </graphic>
	     </screenshot>
	    </figure>

	    <para>A <interface>Tulajdonságok</interface> párbeszédablakon két fül található:
	    a <guilabel>Kiosztások</guilabel> és a <guilabel>Beállítások</guilabel>.
	    A <guilabel>Kiosztások</guilabel> fülön, adhatod hozzá, szerkesztheted
	    vagy eltávolíthatod a billentyűzet-kiosztásokat. Itt tudod megváltoztatni a kiosztások sorrendjét is.
	    A <guilabel>Beállítások</guilabel> fülön meghatározhatod az applet kinézetét (zászló, címke, zászló+címke),
	    a méterét (Normál vagy Nagy), valamint azt, hogy milyen billentyűkombinációra váltson kiosztást
	    (lásd a <xref  linkend="bugs"> részt.)
	    </para>
	    <sect3 id="gkb-prefs-add">
	    <title>A billentyűzet-kiosztás beállítása</title>
	     <para>
	     A kiosztás beállításához a következőket kell tenned:
	      <itemizedlist>
	       <listitem>
	    	 <para>
	         Kiosztás hozzáadása &mdash; A <guilabel>kiosztás</guilabel> fülön kattints a
	         <guibutton>Hozzáadás</guibutton> gombra. Megjelenik a <xref linkend="gkbapplet-add-keymap-fig">
	         <interface>fanézet</interface>, melyből kiválaszthatod a számodra legalkalmasabb kiosztást,
	         a használt nyelv és az ország kiválasztásával.
	         </para>

	         <figure id="gkbapplet-add-keymap-fig">
	         <title>Kiosztás kiválasztása párbeszédablak</title>
	         <screenshot>
	         <screeninfo>Kiosztás kiválasztása párbeszédablak</screeninfo>
	         <graphic format="png" fileref="figures/gkb_add_list"
	         srccredit="emese"></graphic>
	         </screenshot>
	         </figure>
	         <para>Kiosztás hozzáadásához, kattints a nyelv előtt megjelenő <guibutton>+</guibutton>
	         jelre. Ekkor megjelenik az adott nyelvet beszélő országok listája. Kattints most az országod
	         előtt megjelenő <guibutton>+</guibutton> jelre: megjelenik az adott országban használt
	         billentyűzetkiosztások listája. Válaszd ki a legszimpatikusabbat és nyomd meg a <guibutton>Hozzáadás</guibutton> gombot.
	         Ha netán a magyar nyelvet és Magyarországot választottad és nem tudod mi a különbség Latin-1 és Latin-2 között,
	         de érdekel, úgorj a "Magyar billentyűzet-kiosztások, avagy hogyan írjunk hosszú ő-t" c. részhez.
	         <!-- TODO: link to be implemented -->
	         A kiválasztott kiosztás bekerül a listába a <interface>Tulajdonságok</interface> ablakba. Adhatsz hozzá további kiosztásokat,
	         vagy megnyomhatod a <guibutton>Bezárás</guibutton> a <interface>Kiosztás kiválasztása</interface> ablak bezárásához.
	         </para>
	      </listitem>

	    	<listitem>
	    	 <para>
	          Létező billentyűzet-kiosztás szerkesztése &mdash; A kiosztás kijelölése után kattints a
	          <guibutton>Szerkesztés</guibutton> gombra, ez felhozza a
	          <interface>Kiosztás szerkesztése</interface> ablakot (lásd
	          <xref linkend="gkbapplet-prefs-edit">).
	         </para>


	 <figure id="gkbapplet-prefs-edit">
	         <title>Kiosztás szerkesztése párbeszédablak</title>
	         <screenshot>
	         <screeninfo>Kiosztás szerkesztése párbeszédablak</screeninfo>
	         <graphic format="png" fileref="figures/gkb_edit_keymap"
	         srccredit="emese"></graphic>
	         </screenshot>
	         </figure>

	<para>
	Ezen a párbeszédablakon változtathatod meg a kiosztás tulajdonságait. Ezek
	a tulajdonságok a következők:

	<itemizedlist>

	<listitem>
	<para>
	<guilabel>Név</guilabel>: A kiosztás neve, ez jelenik meg a
	<interface>Tulajdonságok</interface> ablakban, valamint a segédszövegben, ha az egeret az appletre viszed.
	</para>
	</listitem>

	<listitem>
	<para>
	<guilabel>Címke</guilabel>: Ez a címke jelenik meg, ha a "Címke" vagy a "Zászló+címke" módot állítod be.
	Bővebb információért lásd a <xref  linkend="gkbapplet-options"> fejezetet.
	</para>
	</listitem>

	<listitem>
	<para>
	<guilabel>Nyelv</guilabel>: Ennek az opciónak nincs jelenleg hatása. A Gnome 2.0-ban fog működni.
	</para>
	</listitem>

	<listitem>
	<para>
	<guilabel>Ország</guilabel>: Ennek az opciónak nincs jelenleg hatása. A Gnome 2.0-ban fog működni.
	</para>
	</listitem>

	<listitem>
	<para>
	<guilabel>Zászló</guilabel>: Itt állíthatod be, hogy milyen zászló jelenjen meg az adott
	billentyűzet-kiosztással.
	</para>
	</listitem>

	<listitem>
	<para>
	<guilabel>Architektúra</guilabel>: Ennek az opciónak nincs jelenleg hatása. A Gnome 2.0-ban fog működni.
	</para>
	</listitem>

	<listitem>
	<para>
	<guilabel>Típus</guilabel>: Ennek az opciónak nincs jelenleg hatása. A Gnome 2.0-ban fog működni.
	</para>
	</listitem>

	<listitem>
	<para>
	<guilabel>Kódlap</guilabel>: Ennek az opciónak nincs jelenleg hatása. A Gnome 2.0-ban fog működni.
	</para>
	</listitem>

	<listitem>
	<para>
	<guilabel>Parancs</guilabel>: Ez az a parancs, amit az applet végrehajt, hogy kicserélje a
	billentyűzet-kiosztást. Alapértelmezett a <command>gkb_xmmap
	<replaceable>xmodmap-fájl-kiterjesztes</replaceable></command> parancs, ahol
	<replaceable>xmodmap-fájl-kiterjesztes</replaceable> annak az xmodmap fájlnak a kiterjesztése,
	amit használni szeretnél.
	</para>
	<tip>
	<title>A rendszeredre telepített kiosztások felkutatása</title>
	<para>A szokványos Linux rendszereken, az xmodmap fájlok a
	<filename class="directory">/usr/share/xmodmap</filename> könyvtárban találhatók.
	</para>
	</tip>
	<para>
	Ha pl. 101 gombos US kiosztást szeretnél használni, állítsd be a
	<command>gkb_xmmap us-101</command> parancsot.
	</para>
	       <para>
		    Ha nem működik, kipróbálhatod a <command>setxkbmap
		    <replaceable>LC</replaceable></command> parancsot, ahol <replaceable>LC</replaceable>
		    az országod két betűs ISO kódja (pl. <command>setxkbmap fr</command>, ha francia billentyűzetet használsz).
		    Végül, ha saját billentyűzetkiosztás-fájlt használsz (xmodmap fájlt), beállíthatod az
		    <command>xmodmap <replaceable>xmodmap-filename</replaceable></command> parancsot (pl.: <command>xmodmap
		    ~/xrus/yawerty.koi8.xmm</command>, ha ciril kiosztást szeretnél koi8-as kódlappal.
		    Please see <xref  linkend="gkbappplet-technical"> for more information.
	       </para>

	</listitem>
	</itemizedlist>

	    	 </para>
	    	</listitem>

	    	<listitem>
	    	 <para>
	          Removing a keyboard layout that is no longer needed &mdash;
	          To remove a keyboard, select it (click on it in the
	          <interface>GKB Properties</interface> window) and click the
	          <guibutton>Delete</guibutton> button.
	    	 </para>
	    	</listitem>

	    	<listitem>
		 <para>
	         Reordering keyboard layouts &mdash; The order in which the
	         keyboard layouts become active as you click on the applet or
	         press the hot key depends on the order they appear in the list in
	         the <interface>Properties</interface> window. The layout that is
	         displayed at the top of
	         the list will become the default layout when you close the
	         <interface>Properties</interface> window. To change the order in
	         the list, select the keymap to be moved, and click
	         <guibutton>Up</guibutton> or <guibutton>Down</guibutton> as
	         appropriate.
	         </para>
	    	</listitem>

	      </itemizedlist>
	     </para>
	     <para>
	      After you have made all the changes you want, click on
	      <guibutton>Apply</guibutton> to apply the changes or on
	      <guibutton>OK</guibutton> to apply the changes and close the
	      <interface>Properties</interface> dialog. To cancel the changes
	      and return to previous values, click the <guibutton>Close</guibutton>
	      button. The <guibutton>Help</guibutton> button brings up this chapter
	      of the on-line help.
	    </para>

	    </sect3>


	    <sect3 id="gkbapplet-options">
	     <title>Miscellaneous options</title>
	     <para>
	     Different options allow you to customize the look of your applet.
	     As a new feature, you can select between three different display modes:
	     <itemizedlist>

		     	<listitem>
		     	 <para>
		          Flag mode &mdash; The flag associated to the keymap is
	                  displayed on the <interface>Panel</interface>.
		     	 </para>
		     	</listitem>

		     	<listitem>
		     	 <para>
		         Label mode &mdash; No flag is displayed, only the label
	                 associated with the keymap.
		     	 </para>
		     	</listitem>

		     	<listitem>
		     	 <para>
		         Flag and label mode &mdash; Both flag and label
	                 associated with the keymap are displayed.
		     	 </para>
	    	    </listitem>

	      </itemizedlist>
	     </para>
	     <para>
	     Many users have reported, that the applet takes too much room on
	     the panel. You can now set the applets size from the
	     <guilabel>Applet size</guilabel> pull down list. Set the size to
	     <guibutton>Normal</guibutton> if you want a smaller applet.
	     If you have plenty of space or like nice big flags on you panel,
	     set the option to <guibutton>Big</guibutton>.
	     </para>
	     <para>
	An often formulated user wish was to implement the keymap switching using
	hotkeys. The developers proudly announce, that keyboard initiated switching now works. The hotkey combination that allows to change keymaps is set to
	<keycombo><keycap>Alt</keycap><keycap>Shift</keycap></keycombo> (<keycap>Alt</keycap> being the left <keycap>Alt</keycap> key). You can customize this hotkey sequence from the <interface>GKB Properties</interface> window's
	<guilabel>Options</guilabel> tab. Click on the <guibutton>Grab hotkey</guibutton> button and press the keys you want to set. The key combination is displayed in the <interface>input box</interface> near the button (you may see something like: <keysym>Control-Shift_R</keysym>). Finally, click on <guibutton>Apply</guibutton> or <guibutton>OK</guibutton> to finalize the new settings.
	     </para>
	    </sect3>

	  </sect2>

	<sect2 id="gkbappplet-technical">
	    <title>Technical information</title>
	    <para>
	      Normally you do not need these details - but if something is not
	    working, or you are just curious, read on.
	    </para>
	    <para>
	      <application>GNOME Keyboard</application>  switches the keyboard
	    map by issuing a command to X Window
	    System. X Window System has two mechanisms for setting keyboard
	    mapping: older one called "xmodmap" and a newer one, based on the
	    so-called "Xkb extension". If you have Xkb enabled, you should use
	    it and switch keyboard layouts by issuing a command
	    <command>setxkbmap <replaceable>LC</replaceable></command>. It
	    comes with a number of various keyboard layout files, usually in
	    directory <filename>/usr/X11R6/lib/X11/xkb/symbols</filename>.
	    </para>
	    <para> If you do not have Xkb extension enabled, or if it just
	    does not cover the language you need, you should use the older
	    <command>xmodmap</command> mechanism. In this case, you need to
	    have a file which describes keyboard layout in a special format
	    (see manual page for <command>xmodmap</command> for details), and
	    the command should be <command>xmodmap
	    <replaceable>filename</replaceable> </command>. <application>GNOME
	    Keyboard</application>  includes a
	    number of keyboard layout files, which are installed in the
	    directory <filename>/usr/share/xmodmap</filename>; these files
	    have names like <filename>xmodmap.de</filename>. To use one of
	    these files, you can use the command <command>gkb_xmmap
	    <replaceable>LC</replaceable></command>
	    which is equivalent to <command>xmodmap
	    /usr/share/xmodmap/xmodmap.<replaceable>LC</replaceable></command>:
	    for example,
	      <command>gkb_xmmap hu</command> is the same as <command>xmodmap
	    /usr/share/xmodmap/xmodmap.hu</command>.
	    </para>
	  </sect2>




	  <!-- ============= Bugs ================================== -->
	  <!-- This section should describe known bugs and limitations of
	       the program if there are any - please be frank and list all
	       problems you know of -->
	  <sect2 id="bugs">
	   <title>Known Bugs and Limitations</title>
	   <para>
	   <itemizedlist>
	    <listitem>
	    <para>
	    Languages and countries showing up in the
	    <interface>Select layout</interface> dialog are not sorted in
	    alphabetical order.
	    </para>
	    </listitem>
	    <listitem>
	<para>
	The program has very few error handling routines implemented. If you try to    feed it something unusual, it may crash.
	</para>
	</listitem>
	    <listitem>
	<para>
	If it does not crash, it returns the error: "The keymap switching
	    returned an error". If the <interface>Edit</interface> window is open
	    when this error appears and
	    you press the <guibutton>OK</guibutton> button on this window, it is
	    likely that nothing will happen. Try closing the
	    <interface>Edit</interface> window first and
	    then the error window.
	</para>
	</listitem>
	</itemizedlist>
	   </para>
	  </sect2>


	  <!-- ============= Authors ================================ -->

	  <sect2 id="authors">
	   <title>Authors</title>
	   <para>
	    <application>GNOME KeyBoard</application> was written by Szabolcs Ban
	    (<email>shooby@gnome.hu</email>).  Please send all comments,
	    suggestions, and bug
	    reports to the <ulink url="http://bugs.gnome.org" type="http">GNOME
	    bug tracking database</ulink>. (Instructions for submitting bug
	    reports can be found <ulink
	    url="http://bugs.gnome.org/Reporting.html" type="http">
	    on-line</ulink>). You can also use <application>Bug Report
	    Tool</application> (<command>bug-buddy</command>), available in the
	    <guisubmenu>Utilities</guisubmenu> submenu of <guimenu>Main
	    Menu</guimenu>, for submitting bug reports.
	   </para>

	   <para>
	    This manual was originally written by Szabolcs (Shooby) Ban
	    (<email>shooby@gnome.hu</email>) and Dan Mueth
	    (<email>d-mueth@uchicago.edu</email>). It has been rewritten
	    (strongly based on the original) by Emese Kovacs
	    (<email>emese@gnome.hu</email>) to reflect changes from v1.2 to v1.4.
	    The <link  linkend="gkbappplet-technical">Technical Information</link>
	    section has been added by
	    Alexander Kirillov (<email>kirillov@math.sunysb.edu</email>).
	    Please send all comments
	    and suggestions regarding this manual to the <ulink type="http"
	    url="http://developer.gnome.org/projects/gdp/">GNOME Documentation
	    Project</ulink> by sending an email to
	    <email>docs@gnome.org</email>. You can also submit comments online
	    by using the <ulink type="http"
	    url="http://developer.gnome.org/projects/gdp/doctable/">GNOME
	    Documentation Status Table</ulink>.
	   </para>

	   <!-- For translations: uncomment this:

	   <para>
	    Latin translation was done by ME
	    (<email>MYNAME@MYADDRESS</email>). Please send all  comments  and
	    suggestions regarding this translation to SOMEWHERE.
	   </para>

	   -->

	  </sect2>


	  <!-- ============= Application License ============================= -->

	  <sect2 id="license">
	   <title>License</title>
	   <para>
	    This program is free software; you can redistribute it and/or
	    modify it under the terms of the <citetitle>GNU General Public
	    License</citetitle> as published by the Free Software Foundation;
	    either version 2 of the License, or (at your option) any later
	    version.
	   </para>
	   <para>
	    This program is distributed in the hope that it will be useful, but
	    WITHOUT ANY WARRANTY; without even the implied warranty of
	    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
	    <citetitle>GNU General Public License</citetitle> for more details.
	   </para>
	   <para>
	    A copy of the <citetitle>GNU General Public License</citetitle> is
	    included as an appendix to the <citetitle>GNOME Users
	    Guide</citetitle>.  You may also obtain a copy of the
	    <citetitle>GNU General Public License</citetitle> from the Free
	    Software Foundation by visiting <ulink type="http"
	    url="http://www.fsf.org">their Web site</ulink> or by writing to
	    <address>
	     Free Software Foundation, Inc.
	     <street>59 Temple Place</street> - Suite 330
	     <city>Boston</city>, <state>MA</state> <postcode>02111-1307</postcode>
	     <country>USA</country>
	    </address>
	   </para>
	  </sect2>

	 </sect1>




