aucoop/AUCOOP-Mint-Nama-Plugin

Plugin for keyboard characters related to the Nama (Khoekhoegowab) language # Nama Compose Linux Small Linux Mint friendly tooling for typing Khoekhoegowab (Nama) characters with a Compose key setup. This repository was created to keep the keyboard setup separate from AUCOOP-Mint while the integration shape is still undecided. ## What It Does - sets `Right Ctrl` as the Compose key - writes a `~/.XCompose` file with Nama click and vowel mappings - optionally remaps the Spanish dead-accent key so it types `^` directly - persists the `^` remap at graphical login with `~/.Xmodmap`, `.xprofile`, and a desktop autostart entry ## Current Character Support Clicks: - `ǀ` - `ǁ` - `ǃ` - `ǂ` Circumflex vowels: - `â Â` - `î Î` - `û Û` Macron vowels: - `ā Ā` - `ē Ē` - `ī Ī` - `ō Ō` - `ū Ū` ## Files - `scripts/setup_nama_compose.sh`: installs Compose key and `~/.XCompose` - `scripts/setup_spanish_caret_key.sh`: remaps the Spanish accent key to `^` - `docs/user-cheatsheet.md`: end-user guide in plain Markdown - `docs/user-cheatsheet.css`: shared screen and print styling for the cheatsheet ## Usage Run the Compose setup: ```bash bash scripts/setup_nama_compose.sh ``` Run the Spanish keyboard caret remap: ```bash bash scripts/setup_spanish_caret_key.sh ``` ## Running Over SSH From this repository, run: ```bash scp scripts/setup_nama_compose.sh scripts/setup_spanish_caret_key.sh docs/user-cheatsheet.md aucoop@HOST:/home/aucoop/ && ssh aucoop@HOST 'chmod +x /home/aucoop/setup_nama_compose.sh /home/aucoop/setup_spanish_caret_key.sh && /home/aucoop/setup_nama_compose.sh && DISPLAY=:0 XAUTHORITY=/home/aucoop/.Xauthority /home/aucoop/setup_spanish_caret_key.sh && mkdir -p /home/aucoop/Desktop && cp /home/aucoop/user-cheatsheet.md /home/aucoop/Desktop/nama-keyboard-cheatsheet.md' ``` Replace `HOST` with the target IP address. If the remote machine uses password authentication, use `sshpass` in front of `scp` and `ssh`. ## Cheatsheet PDF The cheatsheet source stays in Markdown so it also works as an online document. Generate HTML: ```bash …