Das komplette Neo-Wiki, was auch die Homepage darstellt. Gemacht mit ♥ und MkDocs.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
dokumentation/docs/Einrichtung/macOS.md

96 lines
9.1 KiB

# <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
* 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.
* 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 oder im [neo2-layout-osx](https://github.com/jgosmann/neo2-layout-osx#know-issues)-Projekt.