dokumentation/docs/Einrichtung/macOS.md

109 lines
11 KiB
Markdown

# <svg viewBox="0 0 24 24" width="1em"> <path fill="currentColor" d="M18.71,19.5C17.88,20.74 17,21.95 15.66,21.97C14.32,22 13.89,21.18 12.37,21.18C10.84,21.18 10.37,21.95 9.1,22C7.79,22.05 6.8,20.68 5.96,19.47C4.25,17 2.94,12.45 4.7,9.39C5.57,7.87 7.13,6.91 8.82,6.88C10.1,6.86 11.32,7.75 12.11,7.75C12.89,7.75 14.37,6.68 15.92,6.84C16.57,6.87 18.39,7.1 19.56,8.82C19.47,8.88 17.39,10.1 17.41,12.63C17.44,15.65 20.06,16.66 20.09,16.67C20.06,16.74 19.67,18.11 18.71,19.5M13,3.5C13.73,2.67 14.94,2.04 15.94,2C16.07,3.17 15.6,4.35 14.9,5.19C14.21,6.04 13.07,6.7 11.95,6.61C11.8,5.46 12.36,4.26 13,3.5Z" /></svg> macOS
## Installationsanleitung für macOS
Die Installation des Neo-Tastaturlayouts unter macOS ist zwar nicht sehr schwer, hier aber dennoch ausführlich erklärt:
* Die Layoutdatei und die passende Icon-Datei herunterladen:
| Layout | Layoutdatei | Icon-Datei |
| --- | --- | --- |
| Neo | [neo.keylayout](https://dl.neo-layout.org/neo.keylayout) | [neo.icns](https://dl.neo-layout.org/neo.icns) |
| Bone | [bone.keylayout](https://dl.neo-layout.org/bone.keylayout) | [bone.icns](https://dl.neo-layout.org/bone.icns) |
| NeoQwertz | [neoqwertz.keylayout](https://dl.neo-layout.org/neoqwertz.keylayout) | [neoqwertz.icns](https://dl.neo-layout.org/neoqwertz.icns) |
* Safari-Nutzer entfernen bitte bei der Layoutdatei die Dateiendung `.xml`.
!!! tip "Hinweis"
Eventuell wird im Finder die tatsächliche Endung nicht angezeigt. Im Datei-Info-Fenster (Tastenkombination ++cmd+i++) ist unter »Name & Suffix« stets der vollständige Dateiname sichtbar und änderbar.
Diese beiden Dateien müssen an einen Ort verschoben (oder kopiert) werden, an dem macOS Tastaturbelegungen erwartet:
* Soll die Belegung für alle Nutzer verfügbar sein, ist dies `/Library/Keyboard Layouts`. Man kann die Dateien einfach mit dem Finder dorthin verschieben.
* Wenn du in diesem Ordner keine Schreibrechte hast, dann kannst du die Dateien zumindest in den Ordner »Dein persönliches Verzeichnis« (`~/Library/Keyboard Layouts`) verschieben oder kopieren. Dann ist die PC-Tastaturbelegung allerdings nur für dich verfügbar und nicht für andere Nutzer auf diesem Computer. Dies ist z.B. mit folgendem Terminal-Befehl möglich: (bei anderem Layout entsprechend die Dateinamen zu `bone` oder `neoqwertz` anpassen)
```
cp ~/Downloads/neo.keylayout ~/Downloads/neo.icns "~/Library/Keyboard Layouts/"
```
* Wenn die Dateien nach `/Network/Library/Keyboard Layouts` verschoben werden, stehen sie allen Nutzern im lokalen Netzwerk zur Verfügung.
Schließlich kann man unter »Systemeinstellungen → Tastatur → Eingabequellen« das Tastaturlayout mit Klick auf das + Symbol hinzufügen. In der Liste ist es fortan unter »Andere → Deutsch (Neo 2)« aufgeführt (bzw. »Others« bei englischsprachigem System).
!!! warning "Achtung"
**Nun ist ein Neustart erforderlich.**
Wechselt man ohne Neustart direkt auf das neu hinzugefügte Layout, so treten eigenartige Fehler auf. So kann es zum Beispiel vorkommen, dass beim Wechsel zwischen Programmen auf das alte/vorherige Layout umgeschaltet wird.
Zwischen Layouts kann man einfach und schnell in der Systemleiste wechseln (sofern »Tastaturmenü in der Menüzeile anzeigen« ausgewählt ist).
Die weiteren Schritte hängen von der macOS-Version ab.
### macOS 10.12 »Sierra« und neuer
Um **alle sechs Ebenen** auf dem Mac nutzen zu können, wird das Programm [Karabiner-Elements](https://karabiner-elements.pqrs.org/) benötigt. Ist dieses Programm installiert, geht man wie folgt vor:
* Die Neo2-Regeln importieren. [Hier](https://ke-complex-modifications.pqrs.org/#neo2) (Seitenaufbau dauert eine Weile) auf »Import« klicken, dann sollte der Link automatisch mit Karabiner Elements geöffnet und die Regeln importiert werden. Siehe auch [das entsprechende Kapitel](https://karabiner-elements.pqrs.org/docs/manual/configuration/configure-complex-modifications/) in der Karabiner Elements Dokumentation. Alternativ die .json Datei herunterladen und nach ~/.config/karabiner/karabiner.json kopieren.
* Das Programm »Karabiner-Elements« öffnen und in »Complex-Modifications« auf »Add rule« klicken.
* Unter »Neo2« die Regel »Neo2 mod 3 and 4 keys« hinzufügen, entsprechend der vorhandenen Tastatur.
* Ebenso die Regeln »Neo2 layer 4«, »Neo2 layer 6« und »Toggle caps_lock by pressing left_shift + right_shift at the same time« hinzufügen.
Probleme mit den Neo2-Regeln können sowohl [hier beim Neo-Projekt](https://git.neo-layout.org/neo/neo-layout/issues) als auch bei [Karabiner Elements](https://github.com/pqrs-org/KE-complex_modifications/issues) gemeldet werden.
### macOS bis 10.11 »El Capitan«
Unter »Systemeinstellungen → Tastatur → Tastatur (Reiter)« verbirgt sich zudem das »Sondertasten«-Menü. Dort können ++caps-lock++, ++ctrl++, ++option++ und ++cmd++ neu belegt werden. Es ist sinnvoll, ++caps-lock++ dort zu einer zweiten ++option++-Taste zu ändern, um den linken ++mod3++ an gewohnter Stelle vorzufinden.
Um **alle 6 Ebenen** auf dem Mac nutzen zu können, wird das Programm [Karabiner](https://github.com/tekezo/Karabiner/releases/download/files/Karabiner-10.22.0.dmg) benötigt (nur kompatibel mit macOS 10.11 »El Capitan« und früher!). Ist dieses Programm installiert, kann man wie folgt vorgehen:
* Die für Neo angepasste [private.xml](https://dl.neo-layout.org/private.xml) herunterladen und unter `~/Library/Application Support/Karabiner` speichern.
* Das Programm »Karabiner« öffnen und dort auf »Reload XML« klicken.
* Daraufhin ganz oben unter »remapping« die beiden Punkte »_German Neo 2. Enthält:_« und »_Shift_L+Shift_R zu Capslock_« auswählen.
Ebenso unter »Change Option_R Key (Right Option)« den Haken bei »_Option_R to Command_R_« setzen.
Außerdem unter dem Punkt »For German« die »_NEO Keyboard Layout Fixes_« aktivieren. (die Punkte können über die Suchzeile jeweils schnell gefunden werden)
Nun sollten alle 6 Ebenen mit der korrekten Modifierbelegung funktionieren.
#### Äquivalente Positionierung der Cmd-Taste auf interner und externer Tastatur
!!! warning "Achtung"
Karabiner wurde zu Karabiner-Elements weiterentwickelt, deshalb ist dieser historische Abschnitt u.U. nicht mehr korrekt. Bei neuen Erkenntnissen bitte Verbesserungen eigenständig einpflegen.
Gängige USB-Tastaturen haben die Alt-Taste neben der Leertaste und daneben eine Windowstaste. Möchte man sowohl die interne Tastatur des MacBooks als auch die externe Tastatur mit der Cmd-Taste neben der Leertaste haben, geht man wie folgt vor:
* Mit der Anwendung Seil wird unter »Change the caps lock key« der Haken bei »Change the caps lock key« gesetzt. Für den »keycode« wird *110* eingetragen.
* Nun werden die Einstellungen von Karabiner geändert. Bei »For PC Users« muss in dem Punkt »Change PC Application Key (Menu Key)« der Haken bei »Application Key to Option_L« gesetzt werden.
* Im letzten Schritt werden die Tastenbelegungen für Cmd- und Alt-Taste der USB-Tastatur getauscht. Dies erfolgt in »Systemeinstellungen → Tastatur → Sondertasten«. Hier wird die externe Tastatur ausgewählt und die CapsLock-Taste auf »Keine Aktion« eingestellt.
Nun sollten beide Tastaturen wie gewohnt und auf die gleiche Weise funktionieren.
## Legende der Haupttastatur für Mac
```
┌─────┐ 1 … 1. Ebene (kein Mod)
│2 4 6│ 2 … 2. Ebene (Umschalt) [⇧]
│1 3 5│ 3 … 3. Ebene (Mod3) [CapsLock] oder [#]
└─────┘ 4 … 4. Ebene (Mod4) [>] oder rechte [⌘]-Taste
5 … 5. Ebene (Mod3+Umschalt) [⇧] + [CapsLock]
6 … 6. Ebene (Mod3+Mod4) [#] + [<] od. [CapsLock] + rechte [⌘]-Taste od. [#]
```
## Hinweise und Einschränkungen
* Die Command-Ebene (++cmd++) hat das Neo-Layout.
* [Compose](../Benutzerhandbuch/Tote-Tasten-und-Compose.md) ist noch nicht umgesetzt.
* Die Anwendung Tastaturübersicht lässt sich wie das Tastaturlayout über »Systemsteuerung → Ländereinstellungen → Tastaturmenü« einstellen. Das hat mehrere Vorteile: Man braucht nicht die Tasten auf der Tastatur rausreißen und neu anordnen, und eigentlich sollte man ja sowieso nie auf die Tasten schauen.
* Im Verzeichnis [grafik](https://git.neo-layout.org/neo/neo-layout/src/branch/master/grafik) gibt es mehrere Bilder und auch einen Aufsteller, den man sich ausdrucken und vor sich hinstellen kann.
* Bei Problemen in die [FAQ](../Probleme/FAQ.md#apple-macos) schauen.
### Ebene 3
* In Wahrheit (direkt im .keylayout File) wird Option Links als Modifier für Ebene 3 verwendet. CapsLock (M3L) und # (M3R) werden dann mit Karabiner Elements auf Option Links gemappt. In einigen wenigen Programmen funktioniert dieses Mapping nicht. Dann kann immerhin noch Option Links als Mod 3 verwendet werden.
* Es ist unklar warum, aber als Workaround für obiges Problem kann es helfen in Karabiner Elements eine Simple Rule anzulegen die caps_lock auf left_option mappt. Dann funktioniert allerdings Ebene 6 mit den linken Modifiern nicht mehr.
* Dadurch das Mod 3 auf auf Option Links gemappt wird, interpretieren einige Programme Ebene 3-Eingaben als Shortcut anstatt das entsprechende Symbol auszugeben. Abhängig von der Anwendung kann dies der Shortcut mit dem jeweiligen Ebene 3-Zeichen sein oder der Shortcut mit dem Zeichen auf der Grundebene. Webseiten im Browser sehen im Allgemeinen die Ebene-3 Zeichen, native Anwendung meistens letzteres.
* Dieses Problem kann durch die Karabiner Elements Complex Modifications "Prevent all layer 3 keys from being treated as option key shortcut" (für alle Tasten) oder "Prevent problemeatic keys (?, /, #, =, and '?') from being treated as option key shortcut" (für eine Auswahl von häufig problematischen Tasten) umgangen werden. Diese Regel wandelt eine einzelne Ebene 3-Taste in eine spezielle Tottastensequenz um, die von Programmen nicht mehr als Shortcut interpretiert werden kann, aber unter Umständen andere Probleme mit sich bringt. Insbesondere führt diese Regel dazu, dass in JetBrains IDEs ein zusätzliches ungewolltes Zeichen eingefügt wird. Ein [entsprechendes Bugticket](https://youtrack.jetbrains.com/issue/JBR-1311?_ga=2.179409447.2093995893.1567764984-747787643.1539369234) wurde bereits vor längerer Zeit erstellt. Folgender Workaround existiert aber: Man öffnet **Help | Edit Custom Properties**, fügt `com.jetbrains.use.old.keyevent.processing=true` ein und started die IDE neu.
### Verhalten von Pos1 und Ende
* Pos1 und Ende auf der Ebene 4 sind auf Command + Links bzw. Command + Rechts gemappt damit ein ähnliches Verhalten wie in anderen Betriebssystemen entsteht (zum Anfang bzw. Ende der Zeile hüpfen).
* Um in Terminals, Remote-Desktop-Lösungen und Virtuellen Maschinen wirklich Pos1 und Ende über Ebene 4 zu bekommen, kann man die Karabiner Elements Rule "Neo2 mod 4: Map ↖ to Home and ↘︎ to End in terminal apps, remote desktop apps and virtual machines" verwenden.
* Damit sich im MacOS Terminal Pos1 und Ende wie gewünscht verhalten geht man in [Terminal menu] → Preferences → Profiles tab (or settings on some versions of OS X) → Keyboard sub-tab und fügt diese Shortcuts hinzu: Key: ↖ Action: \033OH Key: ↗ Action: \033OF