summaryrefslogtreecommitdiffstats
path: root/windows/autohotkey/README.txt
blob: 4fde0366306319301f8da878fed2c6961956fec5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
== Neo 2.0 Autohotkey-Treiber f�r Windows ==


== Hinweise f�r Nutzer ==

=== Direkte Installation === 
Einfach die Datei neo20.exe herunterladen und irgendwo speichern (bspw. auf dem Desktop oder in dem Order �Eigenen Dateien�). Nach einem einfachen Doppelklick auf diese .exe-Datei steht Neo in voller Funktionalit�t zur Verf�gung! Das alles geht ohne Administrator-Rechte und ist auf jedem Rechner sofort ausf�hrbar.

=== R�ckkehr zum normalen Tastaturlayout ===
Um kurzzeitig zwischen QWERTZ und Neo hin- und herzuwechseln, kann mit der Tastenkombination Shift+Pause das Skript pausiert bzw. wieder gestartet werden. Gleiches erreicht man auch �ber einen Doppelklick auf das rote/wei�e Neo-Icon im Traybereich (bei der Uhr).

=== Bildschirmtastatur oder: Wo ist blo� XYZ abgeblieben? ===
Mit den Tastenkominationen Mod4+F1 bis Mod4+F8 (Mod4 ist beim normalen Tastaturlayout AltGr oder die "<" Taste rechts neben der linken Gro�schreibetaste) erh�lt man eine graphische Zusammenfassung der Neo-Tastatur. Sie erleichert das Finden eines noch nicht so vertrauten Zeichens und hilft zudem beim Erlernen des Blindschreibens, da der Blick auf den Bildschirm und nicht auf die Tastatur gerichtet ist.

=== Globale Schalter und die Neo2.ini ===
Es besteht die M�glichkeit, beim Starten des AHK-Treibers individuelle Anfangswerte f�r die globalen Schalter des Programms vorzugeben.

Dies geschieht �ber die Konfigurationsdatei Neo2.ini (diese muss im gebr�uchlichen INI-Format vorliegen, also insbesondere ANSI-kodiert sein). 
Eine Neo2.ini, die alle Werte auf die Standardwerte ��ndert�, s�he etwa so aus:
[Global]
# Im folgenden gilt (soweit nicht anders angegeben) Ja = 1, Nein = 0:

ahkTreiberKombi=0
einHandNeo=0
lernModus=0
zeigeLockBox=1
UseMod4Light=1
LangSTastatur=0
DeadSilence=0
DeadCompose=0

Diese Datei muss manuell (etwa mit Notepad) in dem richtigen Verzeichnis innerhalb der Anwendungsdaten des aktuellen Nutzers angelegt werden. Unter Windows Vista ist dies etwa das Verzeichnis
C:\Users\<BENUTZERNAME>\AppData\Roaming\Neo2\Neo2.ini
unter Windows XP hingegen das Verzeichnis
C:\Dokumente und Einstellungen\<BENUTZERNAME>\Anwendungsdaten\Neo2\Neo2.ini 
usw.

=== Automatischer Start ===
Bei Bedarf kann man sich eine Verkn�pfung mit neo20.exe in den Autostart-Ordner im Startmen� legen, dann hat man die Belegung direkt nach der Anmeldung. In diesem Fall sollte man jedoch auch einen Umstieg auf den nativen kbdNeo2-Treiber erw�gen (der jedoch noch nicht vollst�ndig umgesetzt ist).

=== Tempor�re Dateien und gr�ndliche Deinstallation ===
Die .exe-Datei entpackt beim Ausf�hren Bilder f�r die Tray-Icons und die Bildschirmtastatur in einen Neo2-Unterordner des tempor�ren Windows(Umgebungsvariablen-)Ordners (unter Windows XP ist dies etwa C:\Dokumente und Einstellungen\Mario Mustermann\Lokale Einstellungen\Temp\Neo2). Diese Dateien bitte w�hrend der Dateiausf�hrung nicht verschieben oder l�schen, ansonsten k�nnen Laufzeitfehler auftreten.

=== Lang-S-Tastatur ===
Um den korrekten Satz des langen S (�?�) zu erleichtern, wurde der Lang-S-Modus geschaffen. Er ist �ber die Tastenkombination Mod4+F11 ein- und ausschaltbar. Er vertauscht zyklisch s ? � ? ? ? s.

=== FAQ ===
Bei vielen Problemen hilt es weiter, zun�chst in die allgemeine Neo-FAQ zu schauen; viele bekannte Probleme und Fragen sind dort mit entsprechendenen L�sungshinweisen dokumentiert.

=== Hinweis zur Aktualit�t ===
Achtung: Da sich Neo in aktiver Weiterentwicklung befindet, kann es vorkommen, dass die Bildschirmtastatur oder die neo20.exe mit der aktuellen Referenz (noch) nicht �bereinstimmt. Scheuen Sie sich nicht, uns �ber die Homepage des Neo-Layouts (http://neo-layout.org) Verbesserungsvorschl�ge zukommen zu lassen!

=== Was noch nicht funktioniert ===
Derzeit sind erst einige wenige Compose-Funktionen im Treiber implementiert. Genauere Informationen befinden sich in der Datei Changelog-and-Todo.txt.


== Hinweise f�r Entwickler ==

=== AutoHotkey herunter laden ===
Man sollte als erstes das Programm namens �AutoHotkey� (http://www.autohotkey.com/download/AutoHotkeyInstall.exe) herunterlanden. Es wird empfohlen, dieses Programm m�glichst in dem vorgeschlagenen Standardverzeichnis zu installieren.
Wenn man jedoch �ber KEINE Administratorrechte verf�gt, kann man das Programm beispielsweise auch in das Verzeichnis �Eigene Dateien/Neo�  (oder in ein anderes Verzeichnis, f�r das man Schreibrechte hat) installieren.
In diesem Fall muss dann f�r eine Kompilierung des Skriptes noch die Datei Build-Update.bat lokal entsprechend angepasst werden (diese lokale �nderung der Build-Update.bat aber bitte nicht einchecken, da die allermeisten Entwickler Autohotkey im vorgeschlagenen Standardverzeichnis installiert haben!).

=== Die ausf�hrbare Datei aktualisieren ===
Um die neo20.exe auf den neuesten Stand zu bringen, reicht (wenn Autohotkey im Standardverzeichnis installiert wurde) ein Doppelklick auf die Batch-Datei Build-Update.bat
Es ist empfehlenswert, diese Batch-Datei stets vor einem Commit auszuf�hren, damit die .exe-Datei immer auf dem aktuellsten Stand ist.

=== Den Sourcecode bearbeiten ===
Die Datei neo20.ahk sollte auf keinen Fall mehr direkt bearbeitet werden, da sie inzwischen automatisch generiert und regelm��ig �berschrieben wird.

Stattdessen m�ssen die Dateien/Module im Source-Unterverzeichnis bearbeitet werden, etwa:
Source\Keys-Neo.ahk
Source\Keys-Qwert-to-Neo.ahk
Source\Methods-Layers.ahk
Source\Methods-Lights.ahk

Um die gemachten �nderungen zu testen, sollte die Datei Source\All.ahk verwendet werden, die alle Module einbindet und regul�r durch einen Doppelklick mit dem AHK-Interpreter gestartet werden kann.

Der gro�e Vorteil dieser Methode liegt darin, dass sich die Zeilennummern eventueller Fehlermeldungen nicht mehr auf die gro�e �vereinigte� AHK-Datei, sondern auf die tats�chlich relevanten Module beziehen, z.�B.�:
Error at line 64 in #include file "C:\...\autohotkey\Source\Methods-Lights.ahk"
Line Text: CTL_CODE_LED(p_device_type, p_function, p_method, p_access)
Error: Functions cannot contain functions.
The programm will exit.

Zudem ist angedacht, den AHK-Treiber in voneinander m�glichst unabh�ngige Teile aufzusplitten, um so die �bersichtlichkeit zu erh�hen und die Komplexit�t des Codes zu verringern.

=== Links zur AHK/Autohotkey-Skriptsprache ===
Eine kurze Einf�hrung (Installation und Beispielskript) findet man etwa auf
http://www.kikizas.net/en/usbapps.ahk.html

Eine alphabetische Liste aller erlaubten Kommandos findet man online unter
http://www.autohotkey.com/docs/commands.htm

=== Wie es funktioniert ===
Das Programm kann alle Tastendrucke abfangen und stattdessen andere Tasten simulieren. Die Zeile
a::send b
f�ngt z.?B. die Taste �a� ab und sendet stattdessen ein �b�. Die AHK-Dateien lassen sich mit einem Texteditor bearbeiten, man muss dann nur das Skript neu starten, um die �nderungen zu �bernehmen.

=== ... ===