neo/linux/X/README

== Wiki ==
Aktuelle Anleitungen gibt es immer im Wiki.
Hierfür wäre die URL
  http://wiki.neo-layout.org/wiki/Neo unter Linux einrichten/xkbmap
die richtige Stelle.
Für Offliner gibt es diese alte README, die immer mal wieder auf den
aktuellen Stand gebracht wird. Insbesondere von den Entwicklern.

    ______________________________________________________________________
    Probleme gibt es bei Systemen mit Xorg Versionen vor 7.3 bzw. X-Server
    vor 1.3 (Fedora 6, Gentoo stable, Ubuntu 7.04 und andere).
    Außerdem muss man bei nicht ganz aktuellen Versionen des X-Servers in
    der Datei „de“ alle Vorkommen von „kpdl“ durch „keypad“ ersetzen.
    Ansonsten erscheint der Fehler »Error loading new keyboard
    description«.
    ——————————————————————————————————————————————————————————————————————

== Installation durch Ersetzen der Systemdateien (Root-Rechte erforderlich) ==

Der Vorteil dieser Methode ist die gute Systemintegration. Nach der Installation
kann das Neo-Layout und seine Modifier-Optionen auch in GUI-Tools, wie sie es in
Gnome und KDE gibt, ausgewählt und verwendet werden.

Dazu wird der gesamte Inhalt dieses Verzeichnisses nach /usr/share/X11/xkb/
kopiert.
Eine Sicherheitskopie der alten Dateien ist empfehlenswert!

=== Aktivieren ===
Zum Aktivieren nur
    setxkbmap de neo
eintippen.

=== Deaktivieren ===
Zurück zu qwertz geht es mit:
    setxkbmap de

=== uiae/asdf-Umschalten ===
Trägt man folgende Zeilen in die ~/.bashrc, ~/.zshrc oder vergleichbares ein, 
kann man anschließend mittels abrollen der linken Hand auf der Grundreihe 
zwischen qwertz und NEO wechseln.

    alias asdf='setxkbmap de neo'
    alias uiae='setxkbmap de'

=== Neo für alle Benutzer – Umschalten mit Rollen ===

Trägt man folgende Zeilen in seine xorg.conf (nur mit root-Zugang möglich) ein,
kann man anschließend mittels drücken der Rollen-Taste zwischen qwertz und
NEO wechseln. Die Rollen-LED zeigt den aktuellen Status an.

	Option "XkbLayout"  "de,de"
	Option "XkbVariant" "neo,nodeadkeys"
	Option "XkbOptions" "grp:sclk_toggle,grp_led:scroll"

Seit X.org 7.3 wird die Tastatur von HAL verwaltet. um gleiche Einstellungen
vorzunehmen erstellt man in /etc/hal/fdi/policy eine Datei namens 
10-x11-input.fdi mit folgendem Inhalt:

  <match key="info.capabilities" contains="input.keys">
  	<merge key="input.x11_driver" type="string">evdev</merge>
  	<merge key="input.x11_options.XkbModel" type="string">evdev</merge>
  	<merge key="input.x11_options.XkbLayout" type="string">de,de</merge>
  	<merge key="input.x11_options.XkbVariant" type="string">neo,nodeadkeys</merge>
  	<merge key="input.x11_options.XkbOptions" type="string">grp:sclk_toggle,grp_led:scroll</merge>
  </match>


== Installation ohne Ersetzen der Systemdateien ==

Hierzu werden keinerlei Root-Rechte benötigt. Allerdings ist hierdurch keine
gute Systemintegration gewährleistet.
Die folgenden Befehle sollten im diesem Verzeichnis ausgeführt werden.

=== Aktivieren ===
Folgender Befehl aktiviert Neo: 
    setxkbmap -I./ de neo -print | xkbcomp - -I./ $DISPLAY

Die ausgegebenen Warnings, sowie zwei Errors können im Normalfall ignoriert
werden.

=== Deaktivieren ===
Zurück zu qwertz geht es mit:
    setxkbmap de

=== uiae/asdf-Umschalten ===
Trägt man folgende Zeilen in die ~/.bashrc, ~/.zshrc oder vergleichbares ein, 
kann man anschließend mittels abrollen der linken Hand auf der Grundreihe 
zwischen qwertz und NEO wechseln.

    alias asdf='setxkbmap -I$NEO_PWD de neo -print | xkbcomp - -I$NEO_PWD $DISPLAY'
    alias uiae='setxkbmap de'

wobei $NEO_PWD durch dieses Verzeichnis ersetzt werden muss.



== FAQ ==
Bei Problemen erst mal in die FAQ schauen, das meiste ist bekannt.

== Quelle == 
Die Dateien in diesem Ordner basieren auf den Orginaldateien aus xkeyboard-config:

http://cgit.freedesktop.org/xkeyboard-config/