https://github.com/gagbo/go-xkb-install

https://github.com/gagbo/go-xkb-install

Last synced: about 1 month ago
JSON representation

• Host: GitHub
• URL: https://github.com/gagbo/go-xkb-install
• Owner: gagbo
• License: mit
• Created: 2022-06-12T10:25:48.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2022-07-09T11:17:52.000Z (over 2 years ago)
• Last Synced: 2024-10-15T08:28:23.453Z (3 months ago)
• Language: Go
• Size: 25.4 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Helper binary to install xkb keyboard layouts

This script notably helps to install a new ruleset within

the only file that actually gets parsed by the system to

list the available layouts.

## Usage

Once the binanry gets properly installed (from a binary on the

release page)

```bash

xkb-install -h

```

Meanwhile to quickly iterate and test it, here's an example

```bash

go run . -S fr -V optimot_ergo -d "French (Optimot, clavier Ergo)" --compose=./Optimot-Compose.txt ./Optimot-Ergo.xkb

# Alternatively

xkb-install -S fr -V optimot_ergo -d "French (Optimot, clavier Ergo)" --compose=./Optimot-Compose.txt ./Optimot-Ergo.xkb

```

The `Optimot-Ergo.xkb` file is expected to have symbol data about the variant like

```

xkb_symbols "optimot_ergo" {

    ...

};

```

## Features

- Idempotent

- Makes a layout available in system dropdowns

Extra details:

- [-] Install an extra `XkbSymbols` table in the `/usr/share/X11/xkb/symbols/XX` file

- [x] Add extra variants in the `evdev.lst` file under the `XX` symbol

- [x] Add extra variants in the `evdev.xml` file under the `XX` layout/symbol

  + [x] edit the XML file in tree

  + [x] backup the old file with a timestamp

  + [x] write the new file after getting sudo rights

- [x] Install an optional `.Xcompose` file in the home of `$USER`