From 3e6bbd4f4979ba96442f171fa6b2f8bc57c18954 Mon Sep 17 00:00:00 2001 From: qwertfisch Date: Fri, 6 Nov 2020 17:44:36 +0100 Subject: [PATCH] Neue Kategorie Entwicklung mit vier Seiten, bereits Links angepasst --- docs/Entwicklung/Erstellen-von-Grafiken.md | 31 ++++ docs/Entwicklung/Sonderzeichenbigramme.md | 46 ++++++ docs/Entwicklung/Treiber-KnowHow-NeoVars.md | 163 ++++++++++++++++++++ docs/Entwicklung/Treiber-KnowHow.md | 147 ++++++++++++++++++ mkdocs.yml | 6 + 5 files changed, 393 insertions(+) create mode 100644 docs/Entwicklung/Erstellen-von-Grafiken.md create mode 100644 docs/Entwicklung/Sonderzeichenbigramme.md create mode 100644 docs/Entwicklung/Treiber-KnowHow-NeoVars.md create mode 100644 docs/Entwicklung/Treiber-KnowHow.md diff --git a/docs/Entwicklung/Erstellen-von-Grafiken.md b/docs/Entwicklung/Erstellen-von-Grafiken.md new file mode 100644 index 0000000..b03fff7 --- /dev/null +++ b/docs/Entwicklung/Erstellen-von-Grafiken.md @@ -0,0 +1,31 @@ +# Anleitung und Regeln für das Erstellen von Grafiken + +!!! warning "Zu überarbeiten" + Diese Seite ist nach der Portierung noch nicht inhaltlich überarbeitet worden. Einige Inhalte sind womöglich obsolet oder besser auf anderen Seiten aufgehoben. Eine Überarbeitung der Seite ist angeraten. Diskussionen sind zu entfernen oder zu verschieben. + +## Bevorzugte Dateiformate +Wann immer möglich, sollten **alle Grafiken im verlustfreien [SVG-Vektorformat](https://de.wikipedia.org/wiki/Scalable_Vector_Graphics)** erstellt werden. Eine gute und freie Software hierfür ist [Inkscape](https://www.inkscape.org/?lang=de). Dabei solle stets darauf geachtet werden, in der Datei auch stets die CC-BY-SA-Lizenz (genaueres hierzu bei den [Lizenzfragen](/Beitragen/Lizenzfragen)) mit anzugeben; unter Inkscape geht dies komfortabel unter »Datei/Dokument-Metadaten/Nutzungsbedingungen → Lizenz«. + +Sofern Bitmap-Varianten (Pixel-Grafiken) erstellt werden müssen, sollte das [PNG-Format](https://de.wikipedia.org/wiki/Portable_Network_Graphics) gewählt werden. + +Kurze Animationen (etwa für die Homepage) sollten als GIF (oder noch besser im [APNG-Format](https://de.wikipedia.org/wiki/Animated_Portable_Network_Graphics)) oder am Besten gar nicht erstellt werden, da diese nur nerven und ablenken. + +### Warum ist SVG das bevorzugte Format? +Das SVG-Format hat viele Vorteile: + + * Man kann sich selbst PNGs in beliebiger Qualität (Vergrößerung und Komprimierung) erzeugen. + * Man kann sich selbst Versionen ohne Antialiasing erzeugen (sind dann kantiger, aber wesentlich kleiner). + * Man kann die Grafik verändern/verbessern/in einem anderen Kontext verwenden. + * Die meisten modernen Browser unterstützen diesen Standard, so dass eigentlich überall SVG-Dateien betrachtet werden können sollten. + * Wenn die SVG-Datei zu groß ist, bewirkt eine .tbz (=.tar.bz2) Komprimierung oft Wunder. + +## SVGs in andere Formate umwandeln +### SVGs in PNGs konvertieren +Zuerst die gewünschte SVG-Grafik mit Inkscape ins PNG-Format konvertieren. Die so entstandenen Dateien sind jedoch noch sehr groß, da sie 24 Bit pro Pixel verwenden. + +Nachbearbeitung mit GIMP → Bild → Modus → Indiziert… → Optimale Palette erzeugen (255 Farben → 8b) → Umwandeln → Abspeichern. + +Zu guter Letzt kann die Größe der PNG-Datei mit Hilfe des Programms pngOUT.exe von Ken Silverman (http://www.advsys.net/ken/utils.htm) nochmal verlustfrei verkleinert werden. + +### SVGs in PDFs konvertieren +Dafür kann man ebenfalls Inkscape verwenden. diff --git a/docs/Entwicklung/Sonderzeichenbigramme.md b/docs/Entwicklung/Sonderzeichenbigramme.md new file mode 100644 index 0000000..17c659f --- /dev/null +++ b/docs/Entwicklung/Sonderzeichenbigramme.md @@ -0,0 +1,46 @@ +# Liste der Sonderzeichenbigramme + +!!! warning "Zu überarbeiten" + Diese Seite ist nach der Portierung noch nicht inhaltlich überarbeitet worden. Einige Inhalte sind womöglich obsolet oder besser auf anderen Seiten aufgehoben. Eine Überarbeitung der Seite ist angeraten. Diskussionen sind zu entfernen oder zu verschieben. + +## 3. Ebene + +|**Bigramme**|**Verwendung in**| +| :---: | :---: | +|$_|Perl| +|~/ ./ &> >& =`|Shell| +|#!/|Shell| +|$@| Bash| +|@"| C#| +|:= |Pascal, Delphi| +|-> => C, |Java, ASCII-Pfeile| +|<= >= |zahlreiche Programmiersprachen| +|<> |Pascal, Delphi| +|!= |C, Java| +|:* |URL| +|:% |Vi| +| |XML, HTML| +| |PHP| +|/* */ |C, Java| +|" =' |zahlreiche Programmiersprachen| +|!" ?" |sollte eigentlich in normalen Texten ?“ bzw. !“ sein| +|(" ") (' ') |zahlreiche Programmiersprachen| +|); '; "; "); |C, Java, Pascal, Delphi| +|," ", ,' ', |zahlreiche Programmiersprachen| +|}[ ]{ _{ !^{ \[ \]|Latex| +|!^2 !^3 |Tabellenkalkulation, Latex, Programmiersprachen| +|:-) ;-) |Chat, Email| +|): |Python| +|+= *= /= -= |C, Java, Python| +|{$ |Pascal, Delphi| +|#{ |Ruby| +|$* $< $( %. ${ |Makefiles, Bash| + +## 4. Ebene + +|**Bigramme**|**Verwendung in**| +| :---: | :---: | +|⇥↲ |Tab-Completion| +|⇡↲ |Shell-History| +|⇢↲ ⇣↲ |Menüauswahl| +|⇡↲⇥ ⇡⇢↲ ⇡⇢⇥ ⇡⇢↲ ⇣↲⇥ ⇣⇢↲ ⇣⇢⇥ ⇣⇢↲ |Formulareingabe| diff --git a/docs/Entwicklung/Treiber-KnowHow-NeoVars.md b/docs/Entwicklung/Treiber-KnowHow-NeoVars.md new file mode 100644 index 0000000..b0b58af --- /dev/null +++ b/docs/Entwicklung/Treiber-KnowHow-NeoVars.md @@ -0,0 +1,163 @@ +# NeoVars für Entwickler + +!!! warning "Zu überarbeiten" + Diese Seite ist nach der Portierung noch nicht inhaltlich überarbeitet worden. Einige Inhalte sind womöglich obsolet oder besser auf anderen Seiten aufgehoben. Eine Überarbeitung der Seite ist angeraten. Diskussionen sind zu entfernen oder zu verschieben. + +**Eine schnelle, sehr pragmatische Kurzanleitung zum Verändern von Buchstaben findet sich [hier](http://www.adnw.de/uploads/Main/ADNWMitNeo-TreiberUnterWindows/NeoVarsModAnleitung2.pdf)** + +## Geschichte +NeoVars ist die nunmehr zweite Implementierung des NEO-Tastaturlayouts in der Programmiersprache AutoHotKey (auch AHK), www.autohotkey.com. Statt mit langen if-then-else-Bäumen auf getrennten Key-Hooks arbeitet neo-vars mit einem globalen, für (fast) alle Tasten durchlaufenen Key-Hook (keyhooks.ahk), der nicht nur für key-press sondern auch für key-release (up) verwendet wird. + +## Key-Hook +Der Key-Hook durchläuft die Funktion AllStar (varsfunctions.ahk), in der der Name der gedrückten Taste (PhysKey, dann ActKey) um die aktuelle Ebenennummer erweitert wird und das Ergebnis als Variable abgefragt wird. Diese Variable (gespeichert in char) sagt nun, was sich hinter dem Tastendruck für ein Zeichen (z. B. „U0041“ für ein großes A) oder auch Sonderzeichen (z. B. „SComp“ für Compose), oder auch Unterprogrammaufruf (z. B. „P_EHt“ für das Umschalten des Einhand-Modus) verbirgt. Dieser „Lookup“, den man in „besseren“ Programmiersprachen mit assoziativen Hash-Arrays implementiert, wird in AHK über dynamische Variablenabfragen gemacht, wobei diese Variablen vorher definiert wurden. + +## Variablen +Variablen werden aber nicht nur für die Zuweisung Ebene+Taste=Zeichen (keydefinitions.ahk) verwendet, sondern auch für Shortcuts (shortcuts.ahk), die später dazu dienen, aus abstrakten Zeichen wieder von Programmen verwendbare Tastendrücke zu machen: Aus „SHome“ wird beispielsweise über »send« wieder „{Home down}“ für den Tastendruck und „{Home up}“ für das Loslassen. Auch für Buchstaben und Sonderzeichen wird diese Methode verwendet, um größtmögliche Kompatibilität mit normalen Programmen zu gewährleisten. Alles, wofür es keine Shortcuts gibt, wird als Unicode-Zeichen an die +Applikation geschickt. Ein paar wenige Zeichen können nicht oder nur schwer durch getrennte Down-Up-Sequenzen umgesetzt werden; an diesen Stellen wird auf den getrennten Key-Release verzichtet und das Zeichen bzw. eine dafür notwendige Zeichenfolge über das gute alte »send« geschickt. + +Zweiter wichtiger und auch für den Benutzer spürbarer Unterschied zum alten AHK-Skript ist die Unterstützung von Key-Press und -Release (down- und up-events), wodurch z. B. manche Programme erst benutzbar werden, wie z. B. Spiele, die die Dauer messen, für die eine Taste niedergedrückt ist. Dafür muss sich das Skript aber für jede Taste merken, was es bei einem späteren Release für ein Zeichen schicken muss, damit keine Taste „hängen“ bleibt. Auch diese Informationen werden in Variablen gespeichert, deren Namen mit dem Scancode/Virtualcode der Taste zusammenhängen. + +Ähnlich werden Compose-Sequenzen unterstützt: Ist eine Variable definiert, die darauf hinweist, dass die bisherige Sequenz ein Compositum ist, wird dieses dargestellt. Ist eine andere Variable definiert, die sagt, dass bis zu einem fertigen Compositum noch mehr Zeichen kommen können, wird das aktuelle Zeichen nicht ausgegeben und stattdessen dem Compositum angehängt. Die dafür nötigen Variablen werden von einem Extra-Skript aus den definierten Compose-Sequenzen erstellt und als AHK-Code abgespeichert (compose.generated.ahk). Hier ist von Vorteil, dass AHK fast beliebig lange Variablennamen unterstützt. + +Mit der Verwendung von Unterprogrammen, sowohl beim Drücken von Tasten, als auch bei Composita, eröffnen sich interessante +Möglichkeiten, die z. T. noch gar nicht ausgeschöpft sind. Ein paar Schmankerln sind aber jetzt schon eingebaut, wofür aber z. T. auch Hooks bemüht werden müssen. + +Erst diese Key-Hooks an mehreren Stellen machen Spezial-Modi möglich: Es gibt einen Physical-Key-Hook, der z. B. für die Implementierung des Einhand-Neo verwendet wird (einhandneo.ahk). Er kann unter entsprechenden Nebenbedingungen, wie hier dem Gedrückthalten der Space-Taste, Tastencodes austauschen. Ein weiterer Key-Hook ermöglicht das Abfangen sämtlicher Tastendrücke für z. B. einen Römische-Zahlen-Modus (tools.ahk), um den gewohnten Ablauf zu ändern, um also hier die gedrückten Ziffern als Dezimalzahl zu interpretieren und in die für sie nötigen römischen Zahlen-Buchstaben umzuwandeln. Ähnlich funktioniert auch der generische Unicode-Zeichengenerator über ♫uu. + +Eine weitere Stelle für Hooks ist die Ausgabefunktion, die derzeit für das Decodieren von Unicode-Zeichen verwendet wird: ♫dd und dann ein Zeichen eingeben, das auch über ein Compositum entstanden sein kann, und ein kleiner ToolTip gibt den entsprechenden Unicode-Codepoint aus (tools.ahk). + +## Bildschirmtastatur +Die Bildschirmtastatur (M3+F1) reagiert nunmehr dynamisch auf die verschiedenen aktivierten Ebenen, d. h. mit dem Drücken eines Modifiers wird automatisch die entsprechende Ebene angezeigt, ohne dass man diese manuell wählen müsste. Im CapsLock-Modus funktioniert das noch nicht richtig, da sich dort Buchstaben und Sonderzeichen unterschiedlich verhalten und wir dafür noch zwei zusätzliche PNG-Dateien brauchen. Abgesehen davon gibt es Überlegungen, die Bildschirmtastatur komplett dynamisch zu machen, das heißt, dass man auch die zu erwartenden Compose-Sequenzen sehen kann. Wenn man also das tote Hochkomma ́ tippt, würde die Bildschirmtastatur für die solcherart unterstützten Tasten die Buchstaben mit Apostroph darstellen. Ob das aber so einfach geht, ist nicht ganz klar: Erstens muss die Ausgabe ausreichend gut ausschauen, zweitens muss die Existenz eines dafür ausgelegten Unicode-Fonts sichergestellt sein, und schließlich muss man die entsprechenden Windows-Funktionen umständlich über DLL-Calls aufrufen, um die AHK-Beschränkung auf die System-Codepage zu überwinden. Ob diese Funktion dann auch die benötigte Performance hat, müsste sich erst erweisen. + +Das AHK-Skript (leider nicht das EXE) bindet jetzt eine eventuell bestehende individuelle Datei aus dem NEO2-Applikationsverzeichnis ein (custom.ahk). Überhaupt sind die Spezialmodi wie EinHand-Neo, Lernmodus und Lang-s-Tastatur in eigene „Module“ ausgelagert worden, die den restlichen Code überhaupt nicht mehr tangieren. Das bedeutet einerseits, dass man sie einfacher warten kann, andererseits auch, dass sie durch diese leicht zu durchschauende Kapselung als Vorlage für individuelle Erweiterungen zur Verfügung stehen. So wäre denkbar, dass man auch die normale Belegung in ein Modul packt, das dann recht einfach und unabhängig vom restlichen Code gewartet werden kann. + +Auf kurze Sicht steht eine automatische Tasten-Layout-Generierung auf dem Plan, mit der man über einen Klick die aktuelle Tastenbelegung aus der Referenz erzeugen kann. Zuvor sollte ein vernünftiges Dateiformat für die Referenz gefunden werden, dann kann mit der Erstellung des Konverters begonnen werden. + +Last, but not least gehört für die vielen Konfigurationsoptionen ein entsprechender Dialog her. Der Kapselung wegen könnten die einzelnen Module hier separate Dialogboxen oder Tabs erhalten. + +## Tray-Tipps +Übrigens stellt neo-vars seine Informationen (z. B. über die Aktivierung des Mod4-Lock) über Tray-Tips dar, die mitunter im Explorer oder über die Registry aktiviert werden müssen. Diese Einstellung zu ändern, wäre auch ein heißer Kandidat für die Config-Dialoge. + +Nur ein kleiner Teil des Codes wurde vom alten Neo-AHK übernommen, darunter die kaum benutzten Keyboard-LEDs und die stark angepassten Unicode-Zeichenausgaben und Ebenenfunktionen. Mittlerweile werden sogar die Modifier über die normalen Keyboard-Hooks geleitet, wodurch man im Prinzip auch diese Zeichen generisch umlegen kann. Einen Strich durch die Rechnung macht uns AHK mit einer recht unflexiblen Handhabung der Alt-Taste, die zwar ge-hookt aber nicht so einfach gesendet werden kann (AHK sendet bona fide automatisch Key-release-Events und simuliert Strg-Tastendrücke). Strg, Win und Konsorten wären hingegen kein Problem. + +Wir hatten recht lang ein generelles Performance-Problem, das zur Folge hatte, dass hier und da ein Zeichen nicht vom AHK-Skript verarbeitet wurde und stattdessen direkt zur Applikation weiter gereicht wurde. Dieses Problem ist offenbar auf AHK und dessen Funktion SendInput in seiner derzeitigen Version zurückzuführen. Mit SendEvent (bzw. »SendMode Event« am Beginn des Skripts) haben wir aber keine Probleme mehr, weshalb neo-vars nun auch die offizielle AHK-Version ist. + +## Individuelles Zusatz-Skript +Sofern man NeoVars als AHK-Skript startet und nicht als vorcompiliertes .EXE, hat man die Möglichkeit, eine Datei `custom.ahk` im Neo2-Anwendungsdaten-Verzeichnis (`%APPDATA%\Neo2\`) in den NeoVars-Start einzubinden. Über diesen Mechanismus kann man auf sämtliche Funktionen von AutoHotkey zugreifen und auch am Innersten von NeoVars Anpassungen vornehmen. + +Man kann `custom.ahk` beispielsweise benützen, um das Tastaturlayout permanent oder auch per Hotkey, den individuellen Wünschen entsprechend, änderbar zu machen. Im Anschluss ist ein Skript zu sehen, das die alternative MU-HP-Variante einrichtet und per Hotkey M3+F8 zugänglich macht. + +``` +; -*- encoding:utf-8 -*- +; NEO-MUHP +; (c) 2009 Matthias Wächter + + +CharProc__UHPt() { + global + ; Custom Layout togglen + isUHP := !(isUHP) + if (isUHP) { + CharProc__UHP1() + if (zeigeModusBox) + TrayTip,NEO-MU-HP-Belegungsvariante,Die Belegungsvariante wurde aktiviert. Zum Deaktivieren`, Mod3+F8 druecken.,10,1 + } else { + CharProc__UHP0() + if (zeigeModusBox) + TrayTip,NEO-MU-HP-Belegungsvariante,Die Belegungsvariante wurde deaktiviert.,10,1 + } +} + +CharProc__UHP1() { + global + ; NEO-MU-HP-Tastaturbelegungsvariante aktivieren + ED12("010",1,"y","Y") + ED12("011",1,"o","O") + ED12("012",1,"a","A") + ED12("013",0,",","–") + ED12("014",1,"j","J") + ED12("015",1,"k","K") + ED12("016",1,"g","G") + ED12("017",1,"c","C") + ED12("018",1,"l","L") + ED12("019",1,"f","F") + ED12("01A",1,"x","X") + + ED12("01E",1,"i","I") + ED12("01F",1,"u","U") + ED12("020",1,"e","E") + ED12("021",1,"h","H") + ED12("022",1,"p","P") + ED12("023",1,"d","D") + ED12("024",1,"t","T") + ED12("025",1,"n","N") + ED12("026",1,"r","R") + ED12("027",1,"s","S") + ED12("028",1,"ß","ẞ") + + ED12("02C",1,"ü","Ü") + ED12("02D",1,"ö","Ö") + ED12("02E",1,"ä","Ä") + ED12("02F",0,".","•") + ED12("030",1,"q","Q") + ED12("031",1,"v","V") + ED12("032",1,"m","M") + ED12("033",1,"b","B") + ED12("034",1,"z","Z") + ED12("035",1,"w","W") +} + +CharProc__UHP0() { + global + ; NEO-MU-DK-Tastaturbelegungsvariante deaktivieren + ED12("010",1,"x","X") + ED12("011",1,"v","V") + ED12("012",1,"l","L") + ED12("013",1,"c","C") + ED12("014",1,"w","W") + ED12("015",1,"k","K") + ED12("016",1,"h","H") + ED12("017",1,"g","G") + ED12("018",1,"f","F") + ED12("019",1,"q","Q") + ED12("01A",1,"ß","ẞ") + + ED12("01E",1,"u","U") + ED12("01F",1,"i","I") + ED12("020",1,"a","A") + ED12("021",1,"e","E") + ED12("022",1,"o","O") + ED12("023",1,"s","S") + ED12("024",1,"n","N") + ED12("025",1,"r","R") + ED12("026",1,"t","T") + ED12("027",1,"d","D") + ED12("028",1,"y","Y") + + ED12("02C",1,"ü","Ü") + ED12("02D",1,"ö","Ö") + ED12("02E",1,"ä","Ä") + ED12("02F",1,"p","P") + ED12("030",1,"z","Z") + ED12("031",1,"b","B") + ED12("032",1,"m","M") + ED12("033",0,",","–") + ED12("034",0,".","•") + ED12("035",1,"j","J") +} + +ActivateNEOMUHP() { + global + + CP3F8 := "P__UHPt" ; M3+F8: Aktiviere/Deaktiviere NEO-MU-HP + + IniRead,isMUHP,%ini%,Global,isMUHP,0 + if (isMUHP) + CharProc__UHP1() + +} + +ActivateNEOMUHP() +``` + +**Achtung:** Die hier verwendeten Funktionen erfordern umfangreiches Wissen rund um AutoHotkey und NeoVars. Desweiteren ist das hier dargestellte Skript nur lauffähig, wenn es als UTF-8-Datei abgespeichert wurde. \ No newline at end of file diff --git a/docs/Entwicklung/Treiber-KnowHow.md b/docs/Entwicklung/Treiber-KnowHow.md new file mode 100644 index 0000000..d33b6e9 --- /dev/null +++ b/docs/Entwicklung/Treiber-KnowHow.md @@ -0,0 +1,147 @@ + +# Treiber-Know-How + +!!! warning "Zu überarbeiten" + Diese Seite ist nach der Portierung noch nicht inhaltlich überarbeitet worden. Einige Inhalte sind womöglich obsolet oder besser auf anderen Seiten aufgehoben. Eine Überarbeitung der Seite ist angeraten. Diskussionen sind zu entfernen oder zu verschieben. + +Auf dieser Seite sollen Interna der Treiberentwicklung festgehalten werden. +Mit welchen Programmen lassen sich die Treiber bearbeiten, welche Möglichkeiten sind schon getestet worden, was kann in der Zukunft noch probiert werden? + +Auch Sackgassen sollten dokumentiert werden, damit nicht die nächsten wieder reinlaufen! + +Natürlich kann diese Seite auch denjenigen helfen, die sich ihre Treiber individuell anpassen wollen. +Dafür gibt es wohl vor allem zwei Gründe: + + * spezielle Bedürfnisse, die in der allgemeinen Referenz nicht berücksichtigt werden können + * spezielle Hardware, die Anpassungen nötig macht + +## Windows +Für Windows gibt es momentan drei Neo-Treiber. Infos zur [Einrichtung der Treiber](/Benutzerhandbuch/Installation#windows) gibt es auf einer Extraseite. + +### kbdneo +kbdneo ist ein richtiger Treiber, der direkt die Tastendrucke der Tastatur empfängt. Leider kann er bislang noch nicht alle Funktionen der Referenz umsetzen. Diese können mit einem AHK-Skript nachgerüstet werden. + +Für die Entwicklung des kbdneo-Treibers wird momentan das [Windows Driver Kit](http://www.microsoft.com/whdc/devtools/wdk/wdkpkg.mspx) verwendet. +Für die M3-Ebene wird ein neu geschaffener Modifier verwendet, für die M4-Ebene der japanische Kana-Modifier. + +Im »WinDDK-Programmordner«\src\input\layout\ gibt es einige Beispiele. +Ein guter Texteditor reicht für die Bearbeitung der Dateien. +Kompiliert wird der Treiber durch Eingabe von ‚build‘ im Ordner der Quellcodedateien in dem ‚Build Environment‘. +(Für weitere Infos: Florian Janßen fragen.) + +### Neovars +Neovars ist in der Skriptsprache [Autohotkey](https://www.autohotkey.com/) geschrieben. Dies ermöglicht die komplette Umsetzung der Referenz (und noch mehr). Die Skripte sowie die fertig kompilierte exe-Dateien lassen sich ohne Administratorrechte ausführen. Allerdings kann mit dieser Herangehensweise kein echtes Tastaturlayout realisiert werden, da die Tastendrucke lediglich abgefangen und umgewandelt werden, was zu ganz eigenen Problemen führt. + +Der aktuelle AHK-Treiber ist Neovars, der auch aktiv weiterentwickelt wird. Es gibt ausführliche Hinweise für [Nutzer](/Benutzerhandbuch/neovars) wie [Entwickler](Treiber-KnowHow-NeoVars.md). + +Die letzte Version vor der Neuimplementierung steht [im SVN](../src/branch/master/windows/ahk-auslaufend) für Entwickler zu Testzwecken zur Verfügung. +Dieser Treiber sollte aber nicht mehr verwendet werden. + +### neo2-llkh +neo2-llkh ist ein sehr schlanker Treiber, der weder Autohotkey noch Admin-Rechte benötigt. Er unterstützt alle sechs Ebenen und bietet ein paar Funktionen, die in den anderen Treibern nicht verfügbar sind: Zum Beispiel können die linke Alt- und Strg-Taste vertauscht werden, CapsLock kann als zusätzliche Escape-Taste konfiguriert werden oder man kann einstellen, dass für Shortcuts das QWERTZ-Layout gelten soll. + +Dieser Treiber ist der jüngste in der Liste und deshalb auch nicht so gut erprobt wie die anderen. + +### Weitere Programme +Es gibt noch einige andere Programme, mit denen ebenfalls die Änderung des Windows-Tastaturlayouts möglich ist. Sie sind jedoch den oben beschriebenen aus verschiedenen Gründen unterlegen: + + * MSKLC: [MSKLC 1.4](http://msdn.microsoft.com/en-us/goglobal/bb964665.aspx) ist für Windows, kostenlos und gut, wenn man „nur“ 4 Ebenen hat. Es ist in der Hilfedatei hervorragend beschrieben. Man erstellt wie mit dem DDK (kbdneo) ein „echtes“ Tastaturlayout. Wurde für Neo1 verwendet, inzwischen jedoch vom [DDK](TreiberKnowHow#kbdneo) (siehe dort) abgelöst. + * KbdEdit: Ein vielversprechendes Programm zur Erstellung von Tastaturlayouts. Doch da nicht nur die Entwicklerversion Geld kostet, sondern auch das fertige Layout nur mit dem kostenpflichtigen Player verwendet werden kann, kommt es für Neo leider nicht in Frage. + * [KeyTweak](http://webpages.charter.net/krumsick/): Greift direkt in die Registry ein und ermöglicht so nicht das Umschalten zwischen Neo und qwertz. Kann aber z.B. CapsLock dauerhaft zu AltGr ändern. + +## Linux +Hier ist [die Einrichtung von Neo unter Linux](/Benutzerhandbuch/Linux) beschrieben. + +Die Linux-„Treiber“ sind reine Textdateien, lassen sich also mit dem Editor bearbeiten. +Interessant sind also vor allem Probleme, die beim Bearbeiten aufgetaucht sind. + +Falls Linux mit einer **Mac-Tastatur** betrieben werden soll (adb, z.B. Installation auf einem iBook), gibt es wohl Probleme, CapsLock umzubelegen. Dazu ist ein Patch (macintosh-mangle-caps-lock-events-on-adb-keyboards.patch) notwendig, der einen Eintrag /proc/sys/dev/adbhid/mangle_caps_lock_events hinzufügt (siehe dazu [hier](http://hans.fugal.net/yodl/blosxom.cgi/mac/caps.html) und [hier](http://lists.debian.org/debian-powerpc/2005/12/msg00214.html)). +Dieser [Patch](http://kernel.org/pub/linux/kernel/people/akpm/patches/2.6/) befand sich auch eine Weile im ­mm Zweig des Kernels, ist aber inzwischen wieder rausgeflogen. + +### Xmodmap +Zur Info die allgemeine [Man-Page](http://www.xfree86.org/4.0.1/xmodmap.1.html) zur Xmodmap, sowie eine deutsche Seite aus dem [Ubuntu-Wiki](http://wiki.ubuntuusers.de/Xmodmap). + +### Xkbmap +Vier Ressourcen, die beim Entwickeln von xkb helfen können: + + * [„XKB configuration guide“](http://www.xfree86.org/current/XKB-Config.html), hier wird die Einrichtung von XFree86 XKB beschrieben, das Manual richtet sich vor allem an Anwender. + * [„How to further enhance XKB configuration“](http://www.xfree86.org/current/XKB-Enhancing.html), hier wird vor allem für Entwickler die Erstellung von neuen (internationalisierten) Tastaturlayouts beschrieben. Für ein einfaches Layout ohne komplizierte Modifier-Verhalten sollte diese Anleitung ausreichen. + * [„An Unreliable Guide to XKB Configuration“](http://www.charvolant.org/~doug/xkb/html/index.html), vermutlich nicht ganz so unverlässlich, wie es sich selbst schimpft :-) + * [X Keyboard Extension von Ivan Pascal](http://pascal.tsu.ru/en/xkb/), auch wenn Sprache und Rechtschreibung dort sehr zu wünschen übrig lassen, bekommt man dort einen weitaus tieferen Einblick als in all den anderen Anleitungen. + +Es wurde viel diskutiert, wie der Name des Layouts in den Treibern und im X-Server sein soll. +Für die Aufnahme in den offiziellen X-Server muss das Layout »de_neo« heißen, im X-Server wird also „neo“ als Option des Layouts „de“ ausgewählt. + +### Compose + +Es gibt eine eigene Seite zum [Einrichten der Neo-Composedatei](/Benutzerhandbuch/Tote-Tasten-und-Compose#Linux). + +## Mac OS +Allgemeine Infos gibt es unter [Einrichtung von Neo auf einem Mac](/Benutzerhandbuch/macOS). + +Eventuelle Alternativen zum [neo.keylayout](#neokeylayout): + + * Wird ein X-Server installiert, läßt sich auch eine Xmodmap laden. Allerdings benötigt man eine speziell angepaßte Version der Xmodmap, und sie wirkt sich nur auf Programme aus, die unter X11 laufen. Zu finden ist diese angepaßte Version im Anhang von Pascals Mail auf der Mailingliste: [neo_mac.xmodmap](http://lists.neo-layout.org/pipermail/diskussion/2009-June/013158.html) (ab »nächster Teil«). Allerdings funktionieren dabei nicht die Ebenen 4 und 6 (siehe entsprechende [Diskussion](http://lists.neo-layout.org/pipermail/diskussion/2009-June/013159.html)). + * Vielleicht wird es irgendwann auch eine Dotnet-Implementierung für AHK geben, dann könnte man auch den AHK-Treiber am Mac benutzen ([die Meldung dazu](http://www.autohotkey.com/forum/topic34421-30.html)). + +### neo.keylayout +Es ist nicht schwierig, die Datei [neo.keylayout](https://git.neo-layout.org/neo/neo-layout/raw/branch/master/mac_osx/neo.keylayout) zu bearbeiten, da Apple sich hier für das mensch- wie maschinenlesbare XML-Format entschieden hat. + + * **code** gibt die Nummer der Taste an, durch deren Drücken man das dahinter geschriebene Zeichen erhält. + * Nach Tasten mit **action** wartet der Computer auf eine zweite Eingabe. + * Welches Zeichen man durch die Kombinationen erhält, kann man am Ende der Datei unter **actions** definieren. + * Weitere Infos gibt’s in einer [Technical Note](http://developer.apple.com/technotes/tn2002/tn2056.html). + +[Ukelele](http://scripts.sil.org/ukelele) ist ein sehr guter Keyboardlayouteditor für Mac, sowohl was Handhabung als auch Dokumentation angeht. Dies ist komfortabler, als die XML-Datei mit einem normalen Texteditor zu bearbeiten. + +### Modifier +Neo verwendet die „Alt-/Optionstaste“ als M3, also ist Ebene 3 mit „Alt/Option“, Ebene 5 mit „Alt/Option“ + „Shift“ erreichbar. In den Systemeinstellungen verbirgt sich unter „Tastatur“ das „Sondertasten-Menü“ (engl. bei den System Preferences „Keyboard“ → „Modifier“). Dort können CapsLock, Ctrl, Alt/Option/Wahltaste und Apfel/Befehlstaste neu belegt werden. Es wird empfohlen, dort für CapsLock die Funtkion „Alt/Option“ einzustellen, um den linken Mod3 am gewohnten Platz vorzufinden. + +Die Tasten # und < lassen sich in den Systemeinstellungen nicht als Modifier einstellen. Das ist jedoch über das Programm [KeyRemap4MacBook](http://pqrs.org/macosx/keyremap4macbook/index.html) möglich in Kombination mit der für Neo angepassten [http://neo-layout.org/private.xml](http://wiki.neo-layout.org/browser/mac_osx/private.xml?format=raw). Diese xml-Datei lässt sich auch noch weiter bearbeiten und an individuelle Bedürfnisse anpassen. + +#### M4 und rechte CMD-Taste + +Wer eine Apple-Tastatur besitzt, bei der rechts neben der Leertaste eine weitere CMD-Taste existiert, kann über folgende Lösung diese Taste als weitere CMD- und nicht als M4-Taste nutzen (M4 wird dann über die rechte ALT-Taste bedient). Dann können Shortcuts mit Command-Key auch per Zehnfingerstystem und ohne Klammergriff bedient werden können. + +Hierzu einfach die [KeyRemap4MacBook XML Datei](https://git.neo-layout.org/neo/neo-layout/raw/branch/master/mac_osx/private.xml) anpassen: + +``` + + +--KeyOverlaidModifier-- KeyCode::OPTION_R, ModifierFlag::EXTRA1, + KeyCode::VK_MODIFIER_EXTRA1, KeyCode::VK_LOCK_EXTRA1 +--KeyToKey-- KeyCode::OPTION_R, KeyCode::VK_MODIFIER_EXTRA1 +``` + +Ein umbinden der rechten Option auf rechte Command ist danach auch nicht mehr nötig in KeyRemap4MacBook. + +## Compose + +Zur Aufnahme oder Änderung von [Compose](Compose)-Kombinationen muss die Datei SVN/Compose/Compose.neo um die entsprechenden Einträge ergänzt werden. Diese UTF-8-Datei ist im Standard-Compose-Format für Linux geschrieben. Die Compose-Funktion unter Windows (beispielsweise die des NeoVars) wird hieraus automatisch generiert. + +### Beschreibung einer typischen Kombination +Die Coko ♫|C=ℂ würde beispielsweise durch die folgende Zeile umgesetzt werden: +> ` : "ℂ" U02102 # DOUBLE-STRUCK CAPITAL C` + +Dabei steht… + + * `` für ♫, + * `` für | (symbolischer Linux-Name in ASCII), + * `` für C (auch ASCII ;-)), + * `"ℂ"` für die Ausgabe (diesmal als echtes, d.h. UTF-8-kodiertes Unicode-Zeichen zwischen den Anführungszeichen), + * und alles hiernach ist ein Kommentar, und zwar + * der eindeutige Unicode-Codepointder Ausgabe: ` U02102`, + * und die offizielle Unicode-Beschreibung dieses Zeichens: `# DOUBLE-STRUCK CAPITAL C`. + +Die offiziellen Beschreibungen und Codepoints können in der [Unicode-Referenz](http://www.unicode.org/Public/5.1.0/ucd/UnicodeData.txt) nachgeschlagen werden. Bei umfangreichen systematischen Ergänzen ist es sinnvoll, die Cokos zur Arbeitsersparung mit einer Tabellenverarbeitung zu erstellen, oder ein entsprechendes Skript zu erstellen. + +### Überschreiben vorhandener Cokos +Falls einmal bereits vorhandene Kombinationen bewusst umdefiniert werden sollten, ist es wichtig, dass die Compose.neo am Ende der Compose eingefügt wird, da bei mehrfach vorhandenen Kombinationen stets die letzte gültig ist. + +### Sonstige Hinweise + + * Bei Kombinationen mit Zahlen die KP_-Zahlen nicht vergessen! + * Wieso setzt man sowohl als auch ? + * Einige Programme (z.B. gucharmap) reagieren auf beide unterschiedlich, bei Neo wird aber nur underscore benutzt. Da es in der Standard-Compose stets beide Definitionen gibt, wurde das bislang so beibehalten, auch wenn die underbar-Definitionen höchstwahrscheinlich nie gebraucht werden werden. + * Funktionieren auch Angaben der Form <∀>? + * Unter Linux definitiv nicht. Darum sollten wir bei der bisherigen Lösung bleiben, die vielleicht für Entwickler umständlicher ist, aber dafür problemlos funktioniert. diff --git a/mkdocs.yml b/mkdocs.yml index e1ae969..fce1ca1 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -131,6 +131,12 @@ nav: - Historisch/Diskussionen.md - NeoCon: Historisch/NeoCon.md + - Entwicklung: + - Entwicklung/Treiber-KnowHow.md + - Entwicklung/Treiber-KnowHow-NeoVars.md + - Entwicklung/Erstellen-von-Grafiken.md + - Entwicklung/Sonderzeichenbigramme.md + - Unsortiert: - Hardware/Hardwarekonflikte.md - Unsortiert/Grafiken.md