add build workflow, remove redundant validate workflow

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
rewrite README: fix typos, add versions table, validation docs
2026-05-01 13:46:58 +02:00 · 2026-03-03 19:07:50 +01:00 · 2026-03-03 17:06:48 +01:00 · 2026-03-03 17:06:48 +01:00 · 2026-03-03 17:06:48 +01:00 · 2026-03-03 17:06:48 +01:00
56 changed files with 17735 additions and 1781 deletions
@@ -0,0 +1,36 @@
 name: Build
 on:
  push:
    branches: [main]
    paths:
      - 'EurKey-macOS.bundle/**'
      - 'scripts/**'
      - 'spec/**'
  pull_request:
    paths:
      - 'EurKey-macOS.bundle/**'
      - 'scripts/**'
      - 'spec/**'
 jobs:
  build:
    runs-on: macos-latest
    steps:
      - name: checkout
        uses: actions/checkout@v4
      - name: validate layouts
        run: python3 scripts/validate_layouts.py
      - name: build bundle
        run: bash scripts/build-bundle.sh
      - name: create DMG
        run: bash scripts/create-dmg.sh
      - name: upload DMG
        uses: actions/upload-artifact@v4
        with:
          name: EurKEY-macOS-DMG
          path: build/*.dmg
@@ -0,0 +1,82 @@
 # Sample workflow for building and deploying a Hugo site to GitHub Pages
 name: Deploy Hugo site to GitHub Pages
 on:
  # Runs on pushes targeting the default branch
  push:
    branches: ["master"]
  # Allows you to run this workflow manually from the Actions tab
  workflow_dispatch:
 # Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
 permissions:
  contents: read
  pages: write
  id-token: write
 # Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
 # However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
 concurrency:
  group: "pages"
  cancel-in-progress: false
 # Default to bash
 defaults:
  run:
    shell: bash
 jobs:
  # Build job
  build:
    runs-on: ubuntu-latest
    env:
      HUGO_VERSION: 0.120.4
    steps:
      - name: Install Hugo CLI
        run: |
          wget -O ${{ runner.temp }}/hugo.deb https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-amd64.deb \
          && sudo dpkg -i ${{ runner.temp }}/hugo.deb
      - name: Install Dart Sass
        run: sudo snap install dart-sass
      - name: Checkout
        uses: actions/checkout@v4
        with:
          submodules: recursive
      - name: Setup Pages
        id: pages
        uses: actions/configure-pages@v4
      - name: Install Node.js dependencies
        run: "[[ -f package-lock.json || -f npm-shrinkwrap.json ]] && npm ci || true"
      - name: Build with Hugo
        env:
          # For maximum backward compatibility with Hugo modules
          HUGO_ENVIRONMENT: production
          HUGO_ENV: production
        run: |
          hugo \
            --source /home/runner/work/EurKEY-macOS/EurKEY-macOS/eurkey-macos.eu/ \
            --minify \
            --baseURL "${{ steps.pages.outputs.base_url }}" # Adjust baseURL according to your directory structure
      - name: Upload artifact
        uses: actions/upload-pages-artifact@v3
        with:
          path: eurkey-macos.eu/public
  # Deployment job
  deploy:
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    runs-on: ubuntu-latest
    needs: build
    steps:
      - name: Deploy to GitHub Pages
        id: deployment
        uses: actions/deploy-pages@v4
@@ -0,0 +1,51 @@
 name: Release
 on:
  push:
    tags:
      - '[0-9][0-9][0-9][0-9].[0-9][0-9].[0-9][0-9]*'
 permissions:
  contents: write
 jobs:
  release:
    runs-on: macos-latest
    steps:
      - name: checkout
        uses: actions/checkout@v4
      - name: extract version from tag
        id: version
        run: echo "version=${GITHUB_REF_NAME}" >> "$GITHUB_OUTPUT"
      - name: validate layouts
        run: python3 scripts/validate_layouts.py
      - name: build bundle
        run: bash scripts/build-bundle.sh --version "${{ steps.version.outputs.version }}"
      - name: create DMG
        run: bash scripts/create-dmg.sh --version "${{ steps.version.outputs.version }}"
      - name: create GitHub release
        uses: softprops/action-gh-release@v2
        with:
          name: EurKEY-macOS ${{ steps.version.outputs.version }}
          files: build/EurKEY-macOS-${{ steps.version.outputs.version }}.dmg
          body: |
            ## Installation
            1. Download `EurKEY-macOS-${{ steps.version.outputs.version }}.dmg`
            2. Open the DMG
            3. Drag `EurKey-macOS.bundle` to the `Install Here (Keyboard Layouts)` folder
            4. Log out and back in (or restart)
            5. System Settings → Keyboard → Input Sources → Add → Select EurKEY
            ## Included layouts
            - **EurKEY v1.2** — legacy version
            - **EurKEY v1.3** — official spec implementation
            - **EurKEY v1.4** — v1.3 with ẞ on Caps+§
            - **EurKEY v2.0** — custom edition
          generate_release_notes: true
@@ -0,0 +1,31 @@
 **/public/
 __pycache__/
 *.pyc
 build/
 *.dmg
 # macOS
 .DS_Store
 .AppleDouble
 .LSOverride
 Icon
 ._*
 .DocumentRevisions-V100
 .fseventsd
 .Spotlight-V100
 .TemporaryItems
 .Trashes
 .VolumeIcon.icns
 .com.apple.timemachine.donotpresent
 .AppleDB
 .AppleDesktop
 Network Trash Folder
 Temporary Items
 .apdisk
 # IDEs
 .idea/
 .vscode/
 *.iws
 *.iml
 *.ipr
@@ -0,0 +1,56 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
 <dict>
 	<key>CFBundleIdentifier</key>
 	<string>de.felixfoertsch.keyboardlayout.EurKEY-macOS</string>
 	<key>CFBundleName</key>
 	<string>EurKEY-macOS</string>
 	<key>CFBundleVersion</key>
 	<string>2026.03.03</string>
 	<key>KLInfo_EurKEY v1.2</key>
 	<dict>
 		<key>TICapsLockLanguageSwitchCapable</key>
 		<false/>
 		<key>TISIconIsTemplate</key>
 		<true/>
 		<key>TISInputSourceID</key>
 		<string>de.felixfoertsch.keyboardlayout.EurKEY-macOS.eurkeyv1.2</string>
 		<key>TISIntendedLanguage</key>
 		<string>en</string>
 	</dict>
 	<key>KLInfo_EurKEY v1.3</key>
 	<dict>
 		<key>TICapsLockLanguageSwitchCapable</key>
 		<false/>
 		<key>TISIconIsTemplate</key>
 		<true/>
 		<key>TISInputSourceID</key>
 		<string>de.felixfoertsch.keyboardlayout.EurKEY-macOS.eurkeyv1.3</string>
 		<key>TISIntendedLanguage</key>
 		<string>en</string>
 	</dict>
 	<key>KLInfo_EurKEY v1.4</key>
 	<dict>
 		<key>TICapsLockLanguageSwitchCapable</key>
 		<false/>
 		<key>TISIconIsTemplate</key>
 		<true/>
 		<key>TISInputSourceID</key>
 		<string>de.felixfoertsch.keyboardlayout.EurKEY-macOS.eurkeyv1.4</string>
 		<key>TISIntendedLanguage</key>
 		<string>en</string>
 	</dict>
 	<key>KLInfo_EurKEY v2.0</key>
 	<dict>
 		<key>TICapsLockLanguageSwitchCapable</key>
 		<false/>
 		<key>TISIconIsTemplate</key>
 		<true/>
 		<key>TISInputSourceID</key>
 		<string>de.felixfoertsch.keyboardlayout.EurKEY-macOS.eurkeyv2.0</string>
 		<key>TISIntendedLanguage</key>
 		<string>en</string>
 	</dict>
 </dict>
 </plist>
@@ -0,0 +1,12 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
 <dict>
 	<key>BuildVersion</key>
 	<string>2026.03.03</string>
 	<key>ProjectName</key>
 	<string>EurKEY-macOS</string>
 	<key>SourceVersion</key>
 	<string>2026.03.03</string>
 </dict>
 </plist>
@@ -1,23 +1,118 @@
-EurKEY-Mac
+# EurKEY-macOS
 ==========
-The Keyboard Layout for Europeans, Coders and Translators - Version for Mac OS X.
+The keyboard layout for Europeans, coders, and translators. This repo contains a **modified version** of the EurKEY base layout for macOS, bundling multiple versions so users can pick what they need.
-This is a port of the [EurKEY Keyboard layout](http://eurkey.steffen.bruentjen.eu/), which features a QWERTY baseline layout (=good access to braces etc.) with quick access to commonly used accented characters and Umlauts.
+EurKEY-macOS targets MacBooks with the physical English International keyboard (ISO) instead of the ANSI layout from the official upstream. Since it is an ISO layout, it has one additional key (`` ` ``) and the big Enter key.
-**Status**: The whole layout should be mapped now. Please report if you find any missing characters.
+The keyboard layout should be compatible with the other ISO layouts typically available in Europe (e.g., German ISO). However, the printed keys will obviously be different. I tested the layout on the current tenkeyless MacBook keyboard (MacBook Air 2024). Working numpad keys are therefore not guaranteed.
 ## Versions
-Install
+The bundle ships 4 layout versions:
 =======
-Copy the two files `EurKEY.keylayout` and `EurKEY.icns` to your library, either system-wide (`/Library/Keyboard Layouts`) or for your local user (`~/Library/Keyboard Layouts`).
+| Version | Description |
 | ------- | ----------- |
 | **v1.3** | Official EurKEY spec implementation. **Recommended for most users.** |
 | **v1.2** | Legacy version based on [Leonardo Schenkel's port](https://github.com/lbschenkel/EurKEY-Mac). Predates the v1.3 spec (no `¬` dead key, `§` instead of `ẞ` on Shift+Option+S). |
 | **v1.4** | v1.3 with `ẞ` (capital sharp s) on Caps+`§` key. |
 | **v2.0** | Custom edition — complete rework. Every key configures exactly as printed on the MacBook keyboard. Removes left/right modifier key distinction. New monochrome template icon. |
 ## Installation
-License
+### From DMG (recommended)
 =======
-The Layout itself is licensed under [GPLv3](http://www.gnu.org/licenses/gpl-3.0.html).
+1. Download the latest `EurKEY-macOS-YYYY.MM.DD.dmg` from [Releases](https://github.com/felixfoertsch/EurKEY-macOS/releases).
-The EU flag icon is taken from [Iconspedia](http://www.iconspedia.com/pack/european-flags-1631/),
+2. Open the DMG.
-created by [Alpak](http://alpak.deviantart.com/) and
+3. Drag `EurKey-macOS.bundle` to the `Install Here (Keyboard Layouts)` folder.
-licensed under [CC](http://creativecommons.org/licenses/by-nc-nd/3.0)
+4. Log out and back in (or restart).
 5. System Settings → Keyboard → Input Sources → click `+` → select the EurKEY version you want.
 ### Manual
 1. Download or clone this repo.
 2. Copy `EurKey-macOS.bundle` to `/Library/Keyboard Layouts/` (system-wide) or `~/Library/Keyboard Layouts/` (user-only).
 3. Log out and back in.
 4. System Settings → Keyboard → Input Sources → click `+` → select EurKEY.
 <img src="eurkey-macos.eu/static/img/1-input-sources.png" width="300" alt="System preferences showing the edit button for input sources.">
 <img src="eurkey-macos.eu/static/img/2-add-layout.png" width="300" alt="Dialogue to add a new input source.">
 <img src="eurkey-macos.eu/static/img/3-select-eurkey.png" width="300" alt="EurKEY in the input sources list.">
 <img src="eurkey-macos.eu/static/img/4-select-input-method.png" width="300" alt="Selecting EurKEY from the menu bar dropdown.">
 ## Validation
 The project includes automated validation to catch regressions. The validation script parses each `.keylayout` XML file and compares key mappings and dead key compositions against the v1.3 reference.
 ```bash
 # validate all layouts
 python3 scripts/validate_layouts.py
 # parse a single layout to JSON
 python3 scripts/parse_keylayout.py "EurKey-macOS.bundle/Contents/Resources/EurKEY v1.3.keylayout" --summary
 # build the bundle (validates + generates Info.plist)
 bash scripts/build-bundle.sh
 # create a DMG installer
 bash scripts/create-dmg.sh
 ```
 ## Dead key compositions (v2.0)
 v2.0 renames all dead key states to their initializing key combination:
 | Key combination | Dead key symbol |
 | --------------- | --------------- |
 | ⌥`` ` ``       | `` ` ``         |
 | ⌥⇧`` ` ``     | ~               |
 | ⌥'              | ´               |
 | ⌥⇧'            | ¨               |
 | ⌥6              | ^               |
 | ⌥⇧6            | ˇ               |
 | ⌥7              | ˚               |
 | ⌥⇧7            | ¯               |
 | ⌥m              | Ω               |
 | ⌥⇧m            | √               |
 | ⌥\              | ¬               |
 ## Notes on Ukelele and template icons
 Template icons switch color with the system theme (dark/light). Ukelele's GUI checkbox for template icons does not save correctly — the `TISIconIsTemplate` flag must be set manually in `Info.plist`:
 ```xml
 <key>TISIconIsTemplate</key>
 <true/>
 ```
 The build script (`scripts/build-bundle.sh`) generates `Info.plist` with this flag set correctly for all layout versions.
 ## Changelog
 ### v2.0 (WIP)
 - Configures every key exactly as it is printed on the MacBook keyboard (ISO, English International).
 - Removes distinction between left/right modifier keys.
 - Uses the `*.bundle` format to group the layout versions.
 - Adds new monochrome macOS template icon that switches color with the system theme.
 - Renames all dead key states to their initializing key combination for easier identification.
 ### v1.4
 - Adds `ẞ` (capital sharp s) on Caps+`§` key.
 ### v1.3
 - Implements the layout according to [spec](https://eurkey.steffen.bruentjen.eu/changelog.html). Based on [Leonardo Schenkel's version 1.2](https://github.com/lbschenkel/EurKEY-Mac).
 ### v1.2
 - Original macOS port by [Leonardo Brondani Schenkel](https://github.com/lbschenkel/EurKEY-Mac).
 ## Attribution
 The original EurKEY layout is by [Steffen Brüntjen](https://eurkey.steffen.bruentjen.eu/start.html). The macOS port is originally based on the work of [Leonardo Brondani Schenkel](https://github.com/lbschenkel/EurKEY-Mac).
 ## License
 - The EurKEY Layout is licensed under [GPLv3](http://www.gnu.org/licenses/gpl-3.0.html). See: [eurkey.steffen.bruentjen.eu/license.html](https://eurkey.steffen.bruentjen.eu/license.html).
 - The EU flag icon is from [Iconspedia](http://www.iconspedia.com/pack/european-flags-1631/), created by [Alpak](http://alpak.deviantart.com/) and licensed under [CC BY-NC-ND 3.0](http://creativecommons.org/licenses/by-nc-nd/3.0).
@@ -0,0 +1,5 @@
 +++
 title = '{{ replace .File.ContentBaseName "-" " " | title }}'
 date = {{ .Date }}
 draft = true
 +++
@@ -0,0 +1,58 @@
 # EurKEY-macOS
 The Keyboard Layout for Europeans, Coders and Translators. This repo is a fork and contains a **modified verison** of the EurKEY base layout.
 I start versioning my customized edition from 2, since the layout is based on my modified EurKEY v1.4 that I have been using the last few years. The version with slight fixes is now available is called v1.5.
 EurKEY-macOS is a rework targeted at MacBooks with the with pyhiscal English International keyboard (ISO). Since it is an ISO layout, it has one additional key (`) and the big Enter key.
 The keyboard layout should be compatible with the other ISO layouts typically available in Europe (e.g. German ISO). I tested the layout on the current tenkeyless MacBook keyboard (MacBook Air 2024). Working numpad keys are therefore not guaranteed.
 ## Installation
 - Download the `EurKEY.bundle` file.
 - Copy the `EurKEY.bundle` file to `/Library/Keyboard Layouts/` (for global installation) or `~/Library/Keyboard Layouts/` (for user installation).
 - Open System Settings > Keyboard > Input Sources <br><img src="eurkey-macos.eu/static/img/1-input-sources.png" width="300">
 - Click the `+` button <br><img src="eurkey-macos.eu/static/img/2-add-layout.png" width="300">
 - Add `EurKEY` from the list of available input sources <br><img src="eurkey-macos.eu/static/img/3-select-eurkey.png" width="300">
 - Select `EurKEY` as the input method <br><img src="eurkey-macos.eu/static/img/4-select-input-method.png" width="300">
 ## Changelog
 ### v2.0 (WIP)
 | Key Combinations | Dead Key Symbol |
 | ---------------- | --------------- |
 | ⌥`               | `               |
 | ⌥⇧`             | ~               |
 | ⌥'               | ´               |
 | ⌥⇧'             | ¨               |
 | ⌥6               | ^               |
 | ⌥⇧6             | ˇ               |
 | ⌥7               | ˚               |
 | ⌥⇧7             | ¯               |
 | ⌥m               | Ω               |
 | ⌥⇧m             | √               |
 | ⌥\               | ¬               |
 ### v1.5
 - Configures every key exactly as it is printed on the keyboard (English - International).
 - Fixes §-Key.
 - Fixes German ẞ-Character ("Großes scharfes S"). Now correctly available via ⌥⇧s.
 - Removes distiction between left/right modifier keys.
 - Uses the `*.bundle` format to group the layout versions.
 - Adds new nicer flag icon from upstream.
 ### v1.4
 - Switches behaviour of superscript and subscript numbers: The subscript numbers are the default; the superscript numbers are available via `⌥⇧<number>`.
 ## Attribution
 You can find the original EurKEY layout on [Steffen Brüntjens Website](https://eurkey.steffen.bruentjen.eu/start.html). My modified versions are originally based on the work of [Leonardo Brondani Schenkel](https://github.com/lbschenkel/EurKEY-Mac).
 ## License
 - The EurKEY Layout is licensed under [GPLv3](http://www.gnu.org/licenses/gpl-3.0.html). See: [https://eurkey.steffen.bruentjen.eu/license.html](https://eurkey.steffen.bruentjen.eu/license.html).
 - The EU flag icon is taken from [Iconspedia](http://www.iconspedia.com/pack/european-flags-1631/), created by [Alpak](http://alpak.deviantart.com/) and licensed under [CC](http://creativecommons.org/licenses/by-nc-nd/3.0).
@@ -0,0 +1,4 @@
 baseURL = 'https://eurkey-macos.eu'
 languageCode = 'en'
 title = 'EurKEY-macOS'
 theme = 'blank'
@@ -0,0 +1,20 @@
 The MIT License (MIT)
 Copyright (c) 2016 Vimux
 Permission is hereby granted, free of charge, to any person obtaining a copy of
 this software and associated documentation files (the "Software"), to deal in
 the Software without restriction, including without limitation the rights to
 use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
 the Software, and to permit persons to whom the Software is furnished to do so,
 subject to the following conditions:
 The above copyright notice and this permission notice shall be included in all
 copies or substantial portions of the Software.
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
 FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
 COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
 IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
 CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
@@ -0,0 +1,31 @@
 # Blank
 Blank — starter [Hugo](https://gohugo.io/) theme for developers. Use it to make your own theme.
 **[Demo](https://blank-demo.netlify.app/)**
 ![Blank theme screenshot](https://github.com/Vimux/blank/blob/master/images/splash.png)
 ## Installation
 In your Hugo site `themes` directory, run:
 ```
 git clone https://github.com/vimux/blank
 ```
 Next, open `config.toml` in the base of the Hugo site and ensure the theme option is set to `blank`.
 ```
 theme = "blank"
 ```
 For more information read the official [quick start guide](https://gohugo.io/getting-started/quick-start/) of Hugo.
 ## Contributing
 Have you found a bug or got an idea for a new feature? Feel free to use the [issue tracker](https://github.com/Vimux/blank/issues) to let me know. Or make directly a [pull request](https://github.com/Vimux/blank/pulls).
 ## License
 This theme is released under the [MIT license](https://github.com/Vimux/blank/blob/master/LICENSE).
@@ -0,0 +1,4 @@
 +++
 title = "{{ replace .Name "-" " " | title }}"
 date = {{ .Date }}
 +++
@@ -0,0 +1,19 @@
 <!DOCTYPE html>
 <html lang="{{ .Site.LanguageCode | default "en-us" }}">
 <head>
 	<meta charset="UTF-8">
 	<meta name="viewport" content="width=device-width, initial-scale=1">
 	<title>{{ .Title }}</title>
 	{{ with .Site.Params.description }}<meta name="description" content="{{ . }}">{{ end }}
 	{{ with .Site.Params.author }}<meta name="author" content="{{ . }}">{{ end }}
 	<link rel="stylesheet" href="{{ "css/style.css" | relURL }}">
 	{{ with .OutputFormats.Get "RSS" -}}
 		{{ printf `<link rel="%s" type="%s" href="%s" title="%s">` .Rel .MediaType.Type .RelPermalink $.Site.Title | safeHTML }}
 	{{- end }}
 </head>
 <body>
 	{{ partial "header" . }}
 	{{ block "main" . }}{{ end }}
 	{{ partial "footer" . }}
 </body>
 </html>
@@ -0,0 +1,16 @@
 {{ define "main" }}
 	<main>
 		{{ if or .Title .Content }}
 		<div>
 			{{ with .Title }}<h1>{{ . }}</h1>{{ end }}
 			{{ with .Content }}<div>{{ . }}</div>{{ end }}
 		</div>
 		{{ end }}
 		{{ range .Paginator.Pages }}
 			{{ .Render "summary" }}
 		{{ end }}
 		{{ partial "pagination.html" . }}
 	</main>
 {{ partial "sidebar.html" . }}
 {{ end }}
@@ -0,0 +1,26 @@
 {{ define "main" }}
 	<main>
 		<article>
 			<h1>{{ .Title }}</h1>
 			<time datetime="{{ .Date.Format "2006-01-02T15:04:05" }}">{{ .Date.Format "02.01.2006 15:04" }}</time>
 			<div>
 				{{ .Content }}
 			</div>
 			{{ with .Params.tags }}
 			<div>
 				<ul id="tags">
 					{{ range . }}
 					<li><a href="{{ "/tags/" | relLangURL }}{{ . | urlize }}">{{ . }}</a></li>
 					{{ end }}
 				</ul>
 			</div>
 			{{ end }}
 			{{ with .Site.DisqusShortname }}
 			<div>
 				{{ template "_internal/disqus.html" . }}
 			</div>
 			{{ end }}
 		</article>
 	</main>
 {{ partial "sidebar.html" . }}
 {{ end }}
@@ -0,0 +1,13 @@
 <article>
 	<h1><a href="{{ .Permalink }}">{{ .Title }}</a></h1>
 	<time datetime="{{ .Date.Format "2006-01-02T15:04:05" }}">{{ .Date.Format "02.01.2006 15:04" }}</time>
 	{{ range .Params.tags }}
 	<a href="{{ "/tags/" | relLangURL }}{{ . | urlize }}">{{ . }}</a>
 	{{ end }}
 	<div>
 		{{ .Summary }}
 		{{ if .Truncated }}
 			<a href="{{ .Permalink }}">Read more...</a>
 		{{ end }}
 	</div>
 </article>
@@ -0,0 +1,7 @@
 {{ define "main" }} {{ readFile "content/README.md" | markdownify }}
 <main>
  {{ $paginator := .Paginate (where .Site.RegularPages "Type" "in"
  .Site.Params.mainSections) }} {{ range $paginator.Pages }} {{ .Render
  "summary" }} {{ end }} {{ partial "pagination.html" . }}
 </main>
 {{ partial "sidebar.html" . }} {{ end }}
@@ -0,0 +1,3 @@
 <footer>
  <p>Last Update: {{ now.Format "2006-01-02" }}</p>
 </footer>
@@ -0,0 +1,12 @@
 <header>
  <h1><a href="{{ .Site.BaseURL }}">{{ .Site.Title }}</a></h1>
  {{ with .Site.Menus.main }}
  <nav>
    <ul>
      {{ range . }}
      <li><a href="{{ .URL | relURL }}">{{ .Name }}</a></li>
      {{ end }}
    </ul>
  </nav>
  {{ end }}
 </header>
@@ -0,0 +1,9 @@
 <div>
 {{ if .Paginator.HasPrev }}
 	<a href="{{ .Paginator.Prev.URL }}">Previous Page</a>
 {{ end }}
 {{ .Paginator.PageNumber }} of {{ .Paginator.TotalPages }}
 {{ if .Paginator.HasNext }}
 	<a href="{{ .Paginator.Next.URL }}">Next Page</a>
 {{ end }}
 </div>
@@ -0,0 +1,14 @@
 <aside>
 	<div>
 		<div>
 			<h3>LATEST POSTS</h3>
 		</div>
 		<div>
 			<ul>
 				{{ range first 5 (where .Site.RegularPages "Type" "in" .Site.Params.mainSections) }}
 				<li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
 				{{ end }}
 			</ul>
 		</div>
 	</div>
 </aside>
@@ -0,0 +1,13 @@
 name = "Blank"
 license = "MIT"
 licenselink = "https://github.com/vimux/blank/blob/master/LICENSE"
 description = "Starter Hugo theme for developers."
 homepage = "https://github.com/vimux/blank/"
 demosite = "https://blank-demo.netlify.app/"
 tags = ["blog", "plain", "blank", "starter", "development"]
 features = ["blog"]
 min_version = "0.20"
 [author]
  name = "Vimux"
  homepage = "https://github.com/vimux"
@@ -0,0 +1,145 @@
 #!/usr/bin/env bash
 # Build and validate the EurKEY-macOS keyboard layout bundle.
 #
 # Regenerates Info.plist with correct KLInfo entries for all layout versions,
 # sets the bundle version, and validates the bundle structure.
 #
 # Usage: bash scripts/build-bundle.sh [--version YYYY.MM.DD]
 set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 PROJECT_DIR="$(cd "${SCRIPT_DIR}/.." && pwd)"
 BUNDLE_DIR="${PROJECT_DIR}/EurKey-macOS.bundle"
 CONTENTS_DIR="${BUNDLE_DIR}/Contents"
 RESOURCES_DIR="${CONTENTS_DIR}/Resources"
 # parse arguments
 VERSION="${1:-$(date +%Y.%m.%d)}"
 if [[ "${1:-}" == "--version" ]]; then
 	VERSION="${2:?missing version argument}"
 fi
 BUNDLE_ID="de.felixfoertsch.keyboardlayout.EurKEY-macOS"
 BUNDLE_NAME="EurKEY-macOS"
 # layout versions to include
 VERSIONS=("v1.2" "v1.3" "v1.4" "v2.0")
 echo "Building ${BUNDLE_NAME} ${VERSION}"
 echo "Bundle: ${BUNDLE_DIR}"
 echo
 # --- validate that all required files exist ---
 errors=0
 for ver in "${VERSIONS[@]}"; do
 	keylayout="${RESOURCES_DIR}/EurKEY ${ver}.keylayout"
 	icns="${RESOURCES_DIR}/EurKEY ${ver}.icns"
 	if [[ ! -f "${keylayout}" ]]; then
 		echo "ERROR: missing ${keylayout}"
 		errors=$((errors + 1))
 	fi
 	if [[ ! -f "${icns}" ]]; then
 		echo "ERROR: missing ${icns}"
 		errors=$((errors + 1))
 	fi
 done
 for lang in en de es; do
 	strings="${RESOURCES_DIR}/${lang}.lproj/InfoPlist.strings"
 	if [[ ! -f "${strings}" ]]; then
 		echo "ERROR: missing ${strings}"
 		errors=$((errors + 1))
 	fi
 done
 if [[ $errors -gt 0 ]]; then
 	echo "FAILED: ${errors} missing file(s)"
 	exit 1
 fi
 # --- generate Info.plist ---
 cat > "${CONTENTS_DIR}/Info.plist" << 'PLIST_HEADER'
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
 <dict>
 	<key>CFBundleIdentifier</key>
 PLIST_HEADER
 echo "	<string>${BUNDLE_ID}</string>" >> "${CONTENTS_DIR}/Info.plist"
 cat >> "${CONTENTS_DIR}/Info.plist" << 'PLIST_NAME'
 	<key>CFBundleName</key>
 PLIST_NAME
 echo "	<string>${BUNDLE_NAME}</string>" >> "${CONTENTS_DIR}/Info.plist"
 cat >> "${CONTENTS_DIR}/Info.plist" << 'PLIST_VERSION'
 	<key>CFBundleVersion</key>
 PLIST_VERSION
 echo "	<string>${VERSION}</string>" >> "${CONTENTS_DIR}/Info.plist"
 # add KLInfo for each version
 for ver in "${VERSIONS[@]}"; do
 	layout_name="EurKEY ${ver}"
 	# generate input source ID: bundle id + layout name with spaces removed, lowercased
 	source_id_suffix=$(echo "eurkey${ver}" | tr '[:upper:]' '[:lower:]' | tr -d ' ')
 	source_id="${BUNDLE_ID}.${source_id_suffix}"
 	cat >> "${CONTENTS_DIR}/Info.plist" << KLINFO_ENTRY
 	<key>KLInfo_${layout_name}</key>
 	<dict>
 		<key>TICapsLockLanguageSwitchCapable</key>
 		<false/>
 		<key>TISIconIsTemplate</key>
 		<true/>
 		<key>TISInputSourceID</key>
 		<string>${source_id}</string>
 		<key>TISIntendedLanguage</key>
 		<string>en</string>
 	</dict>
 KLINFO_ENTRY
 done
 cat >> "${CONTENTS_DIR}/Info.plist" << 'PLIST_FOOTER'
 </dict>
 </plist>
 PLIST_FOOTER
 echo "Generated Info.plist with ${#VERSIONS[@]} layout entries"
 # --- generate version.plist ---
 cat > "${CONTENTS_DIR}/version.plist" << VPLIST
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
 <dict>
 	<key>BuildVersion</key>
 	<string>${VERSION}</string>
 	<key>ProjectName</key>
 	<string>${BUNDLE_NAME}</string>
 	<key>SourceVersion</key>
 	<string>${VERSION}</string>
 </dict>
 </plist>
 VPLIST
 echo "Generated version.plist (${VERSION})"
 # --- validate with plutil ---
 if command -v plutil &> /dev/null; then
 	plutil -lint "${CONTENTS_DIR}/Info.plist" || exit 1
 	plutil -lint "${CONTENTS_DIR}/version.plist" || exit 1
 	echo "plist validation passed"
 fi
 # --- run layout validation ---
 if [[ -f "${SCRIPT_DIR}/validate_layouts.py" ]]; then
 	echo
 	python3 "${SCRIPT_DIR}/validate_layouts.py" || exit 1
 fi
 echo
 echo "Bundle build complete: ${BUNDLE_DIR}"
 echo "Version: ${VERSION}"
@@ -0,0 +1,63 @@
 #!/usr/bin/env bash
 # Create a .dmg installer for EurKEY-macOS keyboard layouts.
 #
 # The DMG contains the keyboard layout bundle and a symlink to
 # /Library/Keyboard Layouts/ for drag-and-drop installation.
 #
 # Usage: bash scripts/create-dmg.sh [--version YYYY.MM.DD]
 set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 PROJECT_DIR="$(cd "${SCRIPT_DIR}/.." && pwd)"
 BUNDLE_DIR="${PROJECT_DIR}/EurKey-macOS.bundle"
 BUILD_DIR="${PROJECT_DIR}/build"
 # parse arguments
 VERSION="${1:-$(date +%Y.%m.%d)}"
 if [[ "${1:-}" == "--version" ]]; then
 	VERSION="${2:?missing version argument}"
 fi
 DMG_NAME="EurKEY-macOS-${VERSION}"
 DMG_PATH="${BUILD_DIR}/${DMG_NAME}.dmg"
 STAGING_DIR="${BUILD_DIR}/dmg-staging"
 echo "Creating DMG: ${DMG_NAME}"
 # --- ensure bundle is built ---
 if [[ ! -f "${BUNDLE_DIR}/Contents/Info.plist" ]]; then
 	echo "ERROR: bundle not found at ${BUNDLE_DIR}"
 	echo "Run scripts/build-bundle.sh first"
 	exit 1
 fi
 # --- prepare staging directory ---
 rm -rf "${STAGING_DIR}"
 mkdir -p "${STAGING_DIR}"
 # copy the bundle
 cp -R "${BUNDLE_DIR}" "${STAGING_DIR}/"
 # create symlink to installation target
 ln -s "/Library/Keyboard Layouts" "${STAGING_DIR}/Install Here (Keyboard Layouts)"
 echo "Staged files:"
 ls -la "${STAGING_DIR}/"
 # --- create DMG ---
 mkdir -p "${BUILD_DIR}"
 rm -f "${DMG_PATH}"
 hdiutil create \
 	-volname "${DMG_NAME}" \
 	-srcfolder "${STAGING_DIR}" \
 	-ov \
 	-format UDZO \
 	"${DMG_PATH}"
 # --- clean up ---
 rm -rf "${STAGING_DIR}"
 echo
 echo "DMG created: ${DMG_PATH}"
 echo "Size: $(du -h "${DMG_PATH}" | cut -f1)"
@@ -0,0 +1,355 @@
 #!/usr/bin/env python3
 """Parse Apple .keylayout XML files into a flat JSON representation.
 Extracts all key mappings across modifier layers (base, Shift, Caps, Option,
 Shift+Option, Caps+Option, Command+Option) and resolves dead key states to
 their composed outputs.
 Usage:
 	python3 scripts/parse_keylayout.py <file.keylayout> [--output file.json]
 Output JSON structure:
 {
 	"name": "EurKEY v1.3",
 	"modifierMap": { ... },
 	"keyMaps": {
 		"0": { "label": "Base", "keys": { "0": {"output": "a", ...}, ... } },
 		...
 	},
 	"actions": {
 		"a": {
 			"none": "a",
 			"dead: ^": "â",
 			...
 		},
 		...
 	},
 	"deadKeys": {
 		"dead: ^": { "terminator": "^", "compositions": { "a": "â", "A": "Â", ... } },
 		...
 	}
 }
 """
 import json
 import re
 import sys
 import xml.etree.ElementTree as ET
 from pathlib import Path
 # macOS key code → physical key name (US ANSI/ISO layout)
 KEY_CODE_NAMES = {
 	0: "A", 1: "S", 2: "D", 3: "F", 4: "H", 5: "G",
 	6: "Z", 7: "X", 8: "C", 9: "V", 10: "§/`",
 	11: "B", 12: "Q", 13: "W", 14: "E", 15: "R",
 	16: "Y", 17: "T", 18: "1", 19: "2", 20: "3",
 	21: "4", 22: "6", 23: "5", 24: "=", 25: "9",
 	26: "7", 27: "-", 28: "8", 29: "0", 30: "]",
 	31: "O", 32: "U", 33: "[", 34: "I", 35: "P",
 	36: "Return", 37: "L", 38: "J", 39: "'", 40: "K",
 	41: ";", 42: "\\", 43: ",", 44: "/", 45: "N",
 	46: "M", 47: ".", 48: "Tab", 49: "Space", 50: "`",
 	51: "Delete", 52: "Enter", 53: "Escape",
 	# numpad
 	65: "KP.", 67: "KP*", 69: "KP+", 75: "KP/",
 	76: "KPEnter", 78: "KP-", 81: "KP=",
 	82: "KP0", 83: "KP1", 84: "KP2", 85: "KP3",
 	86: "KP4", 87: "KP5", 88: "KP6", 89: "KP7",
 	91: "KP8", 92: "KP9",
 	# iso extra key
 	93: "ISO§", 94: "ISO_backslash", 95: "ISO_comma",
 	# function/navigation keys
 	96: "F5", 97: "F6", 98: "F7", 99: "F3",
 	100: "F8", 101: "F9", 103: "F11", 105: "F13",
 	107: "F14", 109: "F10", 111: "F12", 113: "F15",
 	114: "Help/Insert", 115: "Home", 116: "PageUp",
 	117: "ForwardDelete", 118: "F4", 119: "End",
 	120: "F2", 121: "PageDown", 122: "F1",
 	123: "Left", 124: "Right", 125: "Down", 126: "Up",
 }
 # modifier map index → human-readable label
 MODIFIER_LABELS = {
 	0: "Base",
 	1: "Shift",
 	2: "Caps",
 	3: "Option",
 	4: "Shift+Option",
 	5: "Caps+Option",
 	6: "Command+Option",
 	7: "Control",
 }
 # key codes that are "typing" keys (not function/navigation/control)
 TYPING_KEY_CODES = set(range(0, 50)) | {50, 93, 94, 95}
 def _read_keylayout_xml(filepath):
 	"""Read a .keylayout file, working around XML 1.1 control character references.
 	Apple .keylayout files declare XML 1.1 and use numeric character references
 	for control characters (&#x0001; through &#x001F;) that are invalid in XML 1.0.
 	Python's ElementTree only supports XML 1.0, so we convert control character
 	references to placeholder tokens, parse, then restore them.
 	"""
 	with open(filepath, "r", encoding="utf-8") as f:
 		content = f.read()
 	# downgrade XML declaration from 1.1 to 1.0
 	content = content.replace('version="1.1"', 'version="1.0"')
 	# strip the DOCTYPE (references local DTD that may not exist)
 	content = re.sub(r'<!DOCTYPE[^>]*>', '', content)
 	# replace control character references with placeholder strings
 	# &#x0001; through &#x001F; and &#x007F; are problematic in XML 1.0
 	def replace_control_ref(m):
 		code_point = int(m.group(1), 16)
 		return f"__CTRL_U{code_point:04X}__"
 	content = re.sub(
 		r'&#x(000[0-9A-Fa-f]|001[0-9A-Fa-f]|007[Ff]);',
 		replace_control_ref,
 		content,
 	)
 	return content
 def _restore_control_chars(text):
 	"""Restore placeholder tokens back to actual characters."""
 	if text is None:
 		return None
 	def restore(m):
 		code_point = int(m.group(1), 16)
 		return chr(code_point)
 	return re.sub(r'__CTRL_U([0-9A-F]{4})__', restore, text)
 def parse_keylayout(filepath):
 	"""Parse a .keylayout XML file and return a structured dict."""
 	xml_content = _read_keylayout_xml(filepath)
 	root = ET.fromstring(xml_content)
 	result = {
 		"name": root.get("name", ""),
 		"group": root.get("group", ""),
 		"id": root.get("id", ""),
 	}
 	# parse modifier map
 	result["modifierMap"] = parse_modifier_map(root)
 	# parse all keyMapSets
 	key_map_sets = {}
 	for kms in root.findall(".//keyMapSet"):
 		kms_id = kms.get("id")
 		key_map_sets[kms_id] = parse_key_map_set(kms, key_map_sets)
 	# parse actions (dead key compositions)
 	actions = parse_actions(root)
 	result["actions"] = actions
 	# parse terminators
 	terminators = {}
 	for term in root.findall(".//terminators/when"):
 		state = term.get("state", "")
 		output = _restore_control_chars(term.get("output", ""))
 		terminators[state] = output
 	result["terminators"] = terminators
 	# resolve layouts
 	layouts = root.findall(".//layout")
 	# build resolved key maps with all key codes from all layout entries
 	resolved = {}
 	for layout in layouts:
 		map_set_id = layout.get("mapSet")
 		first_code = int(layout.get("first", "0"))
 		last_code = int(layout.get("last", "0"))
 		kms = key_map_sets.get(map_set_id, {})
 		for idx_str, keys in kms.items():
 			if idx_str not in resolved:
 				resolved[idx_str] = {}
 			for code_str, entry in keys.items():
 				code = int(code_str)
 				if first_code <= code <= last_code:
 					resolved[idx_str][code_str] = entry
 	# build the final keyMaps output
 	key_maps = {}
 	for idx_str in sorted(resolved.keys(), key=int):
 		idx = int(idx_str)
 		label = MODIFIER_LABELS.get(idx, f"Index {idx}")
 		keys = {}
 		for code_str in sorted(resolved[idx_str].keys(), key=int):
 			code = int(code_str)
 			entry = resolved[idx_str][code_str]
 			key_name = KEY_CODE_NAMES.get(code, f"code{code}")
 			key_info = {"code": code, "keyName": key_name}
 			if "output" in entry:
 				key_info["output"] = entry["output"]
 			if "action" in entry:
 				action_id = entry["action"]
 				key_info["action"] = action_id
 				# resolve the action's base output
 				if action_id in actions:
 					action_data = actions[action_id]
 					if "none" in action_data:
 						key_info["output"] = action_data["none"]
 					elif "next" in action_data:
 						key_info["deadKey"] = action_data["next"]
 			keys[code_str] = key_info
 		key_maps[idx_str] = {"label": label, "keys": keys}
 	result["keyMaps"] = key_maps
 	# build dead key summary
 	dead_keys = {}
 	for state_name, terminator in terminators.items():
 		compositions = {}
 		for action_id, action_data in actions.items():
 			if state_name in action_data:
 				compositions[action_id] = action_data[state_name]
 		dead_keys[state_name] = {
 			"terminator": terminator,
 			"compositions": compositions,
 		}
 	result["deadKeys"] = dead_keys
 	return result
 def parse_modifier_map(root):
 	"""Parse the modifierMap element."""
 	mod_map = {}
 	for mm in root.findall(".//modifierMap"):
 		mm_id = mm.get("id")
 		default_index = mm.get("defaultIndex", "")
 		selects = []
 		for kms in mm.findall("keyMapSelect"):
 			map_index = kms.get("mapIndex", "")
 			modifiers = []
 			for mod in kms.findall("modifier"):
 				modifiers.append(mod.get("keys", ""))
 			selects.append({"mapIndex": map_index, "modifiers": modifiers})
 		mod_map[mm_id] = {"defaultIndex": default_index, "selects": selects}
 	return mod_map
 def parse_key_map_set(kms_element, all_key_map_sets):
 	"""Parse a keyMapSet element, resolving baseMapSet/baseIndex references."""
 	result = {}
 	for km in kms_element.findall("keyMap"):
 		index = km.get("index")
 		keys = {}
 		# resolve base map set if specified
 		base_map_set_id = km.get("baseMapSet")
 		base_index = km.get("baseIndex")
 		if base_map_set_id and base_index:
 			base_kms = all_key_map_sets.get(base_map_set_id, {})
 			base_keys = base_kms.get(base_index, {})
 			keys.update(base_keys)
 		# parse keys in this keyMap (override base)
 		for key in km.findall("key"):
 			code = key.get("code")
 			entry = {}
 			if key.get("output") is not None:
 				entry["output"] = _restore_control_chars(key.get("output"))
 			if key.get("action") is not None:
 				entry["action"] = key.get("action")
 			keys[code] = entry
 		result[index] = keys
 	return result
 def parse_actions(root):
 	"""Parse all action elements into a dict of action_id → {state → output/next}."""
 	actions = {}
 	for action in root.findall(".//actions/action"):
 		action_id = action.get("id")
 		states = {}
 		for when in action.findall("when"):
 			state = when.get("state", "none")
 			if when.get("output") is not None:
 				states[state] = _restore_control_chars(when.get("output"))
 			elif when.get("next") is not None:
 				if state == "none":
 					states["next"] = when.get("next")
 				else:
 					states[state] = f"→{when.get('next')}"
 		actions[action_id] = states
 	return actions
 def format_char(c):
 	"""Format a character for display, showing control chars as hex."""
 	if len(c) == 1:
 		cp = ord(c)
 		if cp < 0x20 or cp == 0x7F:
 			return f"U+{cp:04X}"
 		if cp == 0xA0:
 			return "NBSP"
 	return c
 def print_summary(data):
 	"""Print a human-readable summary of the parsed layout."""
 	print(f"Layout: {data['name']}")
 	print(f"Dead key states: {', '.join(data['deadKeys'].keys())}")
 	print()
 	for idx_str in sorted(data["keyMaps"].keys(), key=int):
 		km = data["keyMaps"][idx_str]
 		print(f"--- {km['label']} (index {idx_str}) ---")
 		for code_str in sorted(km["keys"].keys(), key=int):
 			code = int(code_str)
 			if code not in TYPING_KEY_CODES:
 				continue
 			ki = km["keys"][code_str]
 			key_name = ki["keyName"]
 			output = ki.get("output", "")
 			dead = ki.get("deadKey", "")
 			formatted = format_char(output) if output else ""
 			extra = f" [dead: {dead}]" if dead else ""
 			action = f" (action: {ki['action']})" if "action" in ki else ""
 			print(f"  {key_name:>12s} (code {code:>3d}): {formatted}{extra}{action}")
 		print()
 def main():
 	import argparse
 	parser = argparse.ArgumentParser(description="Parse Apple .keylayout XML files")
 	parser.add_argument("keylayout", help="Path to .keylayout file")
 	parser.add_argument("--output", "-o", help="Output JSON file path")
 	parser.add_argument("--summary", "-s", action="store_true",
 		help="Print human-readable summary")
 	args = parser.parse_args()
 	data = parse_keylayout(args.keylayout)
 	if args.summary:
 		print_summary(data)
 	if args.output:
 		output_path = Path(args.output)
 		output_path.parent.mkdir(parents=True, exist_ok=True)
 		with open(output_path, "w", encoding="utf-8") as f:
 			json.dump(data, f, ensure_ascii=False, indent="\t")
 		print(f"Written to {output_path}")
 	elif not args.summary:
 		json.dump(data, sys.stdout, ensure_ascii=False, indent="\t")
 		print()
 if __name__ == "__main__":
 	main()
@@ -0,0 +1,8 @@
 #!/usr/bin/env bash
 # Validate all EurKEY keylayout files against the v1.3 reference spec.
 # Exit code 0 if all pass, 1 if any unexpected mismatches.
 set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 exec python3 "${SCRIPT_DIR}/validate_layouts.py" "$@"
@@ -0,0 +1,306 @@
 #!/usr/bin/env python3
 """Validate .keylayout files against the EurKEY v1.3 reference spec.
 Compares each layout version's key mappings and dead key compositions against
 the reference, reporting mismatches. Supports per-version exception lists for
 intentional differences.
 Usage:
 	python3 scripts/validate_layouts.py [--verbose]
 Exit code 0 if all layouts pass validation, 1 if any unexpected mismatches.
 """
 import sys
 from pathlib import Path
 # import the parser
 sys.path.insert(0, str(Path(__file__).parent))
 from parse_keylayout import parse_keylayout, TYPING_KEY_CODES, MODIFIER_LABELS, KEY_CODE_NAMES
 BUNDLE_DIR = Path(__file__).parent.parent / "EurKey-macOS.bundle" / "Contents" / "Resources"
 # modifier indices that contain meaningful typing output
 # (exclude index 6 = Command+Option and 7 = Control — these are system shortcuts)
 VALIDATED_MODIFIER_INDICES = {"0", "1", "2", "3", "4", "5"}
 def load_layout(version):
 	"""Parse a keylayout file for the given version string."""
 	path = BUNDLE_DIR / f"EurKEY {version}.keylayout"
 	if not path.exists():
 		print(f"ERROR: {path} not found")
 		sys.exit(2)
 	return parse_keylayout(str(path))
 def compare_key_maps(reference, target, exceptions):
 	"""Compare key maps between reference and target layouts.
 	Returns a list of (modifier_label, key_name, code, ref_output, target_output) tuples
 	for each mismatch that is not in the exceptions list.
 	"""
 	mismatches = []
 	# build terminator→state name maps for dead key comparison
 	# build state_name→terminator for both versions
 	ref_state_to_term = {name: dk["terminator"] for name, dk in reference["deadKeys"].items()}
 	tgt_state_to_term = {name: dk["terminator"] for name, dk in target["deadKeys"].items()}
 	for idx_str in VALIDATED_MODIFIER_INDICES:
 		ref_km = reference["keyMaps"].get(idx_str, {}).get("keys", {})
 		tgt_km = target["keyMaps"].get(idx_str, {}).get("keys", {})
 		mod_label = MODIFIER_LABELS.get(int(idx_str), f"Index {idx_str}")
 		for code_str in ref_km:
 			code = int(code_str)
 			if code not in TYPING_KEY_CODES:
 				continue
 			ref_key = ref_km[code_str]
 			tgt_key = tgt_km.get(code_str, {})
 			ref_output = ref_key.get("output", "")
 			tgt_output = tgt_key.get("output", "")
 			ref_dead = ref_key.get("deadKey", "")
 			tgt_dead = tgt_key.get("deadKey", "")
 			key_name = KEY_CODE_NAMES.get(code, f"code{code}")
 			# check for exception
 			exc_key = f"{idx_str}:{code_str}"
 			if exc_key in exceptions:
 				expected = exceptions[exc_key]
 				if expected.get("output") == tgt_output or expected.get("deadKey") == tgt_dead:
 					continue
 				# exception exists but value doesn't match → still a mismatch
 				mismatches.append((
 					mod_label, key_name, code,
 					f"{ref_output or ref_dead} (ref)",
 					f"{tgt_output or tgt_dead} (got, expected exception: {expected})",
 				))
 				continue
 			# compare dead keys by terminator (state names may differ)
 			if ref_dead or tgt_dead:
 				ref_term = ref_state_to_term.get(ref_dead, ref_dead)
 				tgt_term = tgt_state_to_term.get(tgt_dead, tgt_dead)
 				if ref_term == tgt_term:
 					continue  # same dead key, different name
 				# dead keys differ
 				ref_display = f"[dead: {ref_dead} → {ref_term}]"
 				tgt_display = f"[dead: {tgt_dead} → {tgt_term}]" if tgt_dead else tgt_output or "[missing]"
 				mismatches.append((mod_label, key_name, code, ref_display, tgt_display))
 				continue
 			# compare regular outputs
 			if ref_output != tgt_output:
 				if not tgt_output and not tgt_dead:
 					tgt_display = "[missing]"
 				else:
 					tgt_display = tgt_output
 				mismatches.append((mod_label, key_name, code, ref_output, tgt_display))
 	return mismatches
 def _build_terminator_map(data):
 	"""Build a mapping from terminator character → dead key data.
 	Different layout versions may use different state names (e.g., "dead: ^" vs "7")
 	but the same terminator character. This allows matching by terminator.
 	"""
 	return {dk["terminator"]: (name, dk) for name, dk in data["deadKeys"].items()}
 def _composition_output_set(compositions):
 	"""Extract the set of output characters from a dead key's compositions.
 	Since action IDs differ between versions (e.g., "a" vs "a61"), we compare
 	by the set of output characters produced, not by action ID.
 	"""
 	return set(compositions.values())
 def compare_dead_keys(reference, target, exceptions):
 	"""Compare dead key compositions between reference and target.
 	Matches dead key states by their terminator character (since state names
 	may differ between versions). Compares composition output sets.
 	Returns a list of (dead_key_state, detail, ref_value, target_value) tuples.
 	"""
 	mismatches = []
 	ref_by_term = _build_terminator_map(reference)
 	tgt_by_term = _build_terminator_map(target)
 	for terminator, (ref_name, ref_dk) in ref_by_term.items():
 		if ref_name in exceptions.get("_dead_key_skip", []):
 			continue
 		if terminator not in tgt_by_term:
 			mismatches.append((ref_name, "*", "present", "missing"))
 			continue
 		_, tgt_dk = tgt_by_term[terminator]
 		# compare composition output sets
 		ref_outputs = _composition_output_set(ref_dk["compositions"])
 		tgt_outputs = _composition_output_set(tgt_dk["compositions"])
 		only_ref = ref_outputs - tgt_outputs
 		only_tgt = tgt_outputs - ref_outputs
 		for out in sorted(only_ref):
 			exc_key = f"dead:{ref_name}:output:{out}"
 			if exc_key not in exceptions:
 				mismatches.append((ref_name, f"output {out}", "present", "missing"))
 		for out in sorted(only_tgt):
 			exc_key = f"dead:{ref_name}:extra:{out}"
 			if exc_key not in exceptions:
 				mismatches.append((ref_name, f"output {out}", "missing", "present"))
 	return mismatches
 def format_char_display(c):
 	"""Format a character for display."""
 	if not c or c in ("[missing]", "missing", "present"):
 		return c
 	if len(c) == 1:
 		cp = ord(c)
 		if cp < 0x20 or cp == 0x7F:
 			return f"U+{cp:04X}"
 	return c
 # --- per-version exception definitions ---
 # format: {"modifierIndex:keyCode": {"output": "expected_value"}}
 # or {"_dead_key_skip": ["state_name", ...]} to skip entire dead key states
 # v1.2 predates v1.3 — known differences documented here
 V1_2_EXCEPTIONS = {
 	# Shift+Option S: v1.2 has § where v1.3 has ẞ (capital sharp s)
 	"4:1": {"output": "§"},
 	# v1.2 does not have the ¬ (negation) dead key — added in v1.3
 	"_dead_key_skip": ["dead: ¬"],
 }
 # v1.4 differences from v1.3:
 # - §/` key (code 10) in Caps/Caps+Option outputs ẞ instead of §
 # - ¬ dead key has an extra ¬ composition (self-referencing)
 V1_4_EXCEPTIONS = {
 	"2:10": {"output": "ẞ"},   # Caps: §/` → ẞ (capital sharp s)
 	"5:10": {"output": "ẞ"},   # Caps+Option: §/` → ẞ
 	"dead:dead: ¬:extra:¬": True,  # extra ¬ composition in negation dead key
 }
 # v2.0 is a custom edition — skip validation for now, just document diffs
 V2_0_EXCEPTIONS = {
 	"_skip_validation": True,
 }
 VERSIONS = {
 	"v1.2": {"file": "v1.2", "exceptions": V1_2_EXCEPTIONS, "label": "EurKEY v1.2"},
 	"v1.3": {"file": "v1.3", "exceptions": {}, "label": "EurKEY v1.3 (reference)"},
 	"v1.4": {"file": "v1.4", "exceptions": V1_4_EXCEPTIONS, "label": "EurKEY v1.4"},
 	"v2.0": {"file": "v2.0", "exceptions": V2_0_EXCEPTIONS, "label": "EurKEY v2.0 (custom)"},
 }
 def validate_version(version_key, reference):
 	"""Validate a single version against the reference. Returns (pass, mismatch_count)."""
 	config = VERSIONS[version_key]
 	exceptions = config["exceptions"]
 	if exceptions.get("_skip_validation"):
 		print(f"\n{'='*60}")
 		print(f"  {config['label']} — SKIPPED (custom edition)")
 		print(f"{'='*60}")
 		return True, 0
 	target = load_layout(config["file"])
 	print(f"\n{'='*60}")
 	print(f"  Validating {config['label']} against v1.3 reference")
 	print(f"{'='*60}")
 	# compare key maps
 	key_mismatches = compare_key_maps(reference, target, exceptions)
 	dk_mismatches = compare_dead_keys(reference, target, exceptions)
 	total = len(key_mismatches) + len(dk_mismatches)
 	if key_mismatches:
 		print(f"\n  Key mapping mismatches ({len(key_mismatches)}):")
 		for mod_label, key_name, code, ref_out, tgt_out in key_mismatches:
 			print(f"    {mod_label:>14s} | {key_name:>12s} (code {code:>3d}): "
 				f"ref={format_char_display(ref_out)} got={format_char_display(tgt_out)}")
 	if dk_mismatches:
 		print(f"\n  Dead key mismatches ({len(dk_mismatches)}):")
 		for state, action_id, ref_out, tgt_out in dk_mismatches:
 			print(f"    {state:>12s} + {action_id}: "
 				f"ref={format_char_display(ref_out)} got={format_char_display(tgt_out)}")
 	if total == 0:
 		print(f"\n  PASS — no unexpected mismatches")
 	else:
 		print(f"\n  FAIL — {total} unexpected mismatch(es)")
 	return total == 0, total
 def self_validate(reference):
 	"""Validate that v1.3 matches itself (sanity check)."""
 	target = load_layout("v1.3")
 	key_mismatches = compare_key_maps(reference, target, {})
 	dk_mismatches = compare_dead_keys(reference, target, {})
 	total = len(key_mismatches) + len(dk_mismatches)
 	if total > 0:
 		print("INTERNAL ERROR: v1.3 does not match itself!")
 		for m in key_mismatches:
 			print(f"  key: {m}")
 		for m in dk_mismatches:
 			print(f"  dead: {m}")
 		return False
 	print("  Self-check: v1.3 matches itself ✓")
 	return True
 def main():
 	print("EurKEY-macOS Layout Validation")
 	print("Reference: EurKEY v1.3")
 	# load reference
 	reference = load_layout("v1.3")
 	# sanity check
 	if not self_validate(reference):
 		sys.exit(2)
 	all_pass = True
 	total_mismatches = 0
 	for version_key in VERSIONS:
 		if version_key == "v1.3":
 			continue  # skip self-comparison
 		passed, count = validate_version(version_key, reference)
 		if not passed:
 			all_pass = False
 		total_mismatches += count
 	print(f"\n{'='*60}")
 	if all_pass:
 		print("  ALL LAYOUTS PASS ✓")
 	else:
 		print(f"  VALIDATION FAILED — {total_mismatches} total mismatch(es)")
 	print(f"{'='*60}")
 	sys.exit(0 if all_pass else 1)
 if __name__ == "__main__":
 	main()
Author	SHA1	Message	Date
felixfoertsch	859c26f64c	add build workflow, remove redundant validate workflow Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-03-03 19:07:50 +01:00
felixfoertsch	5e29ef63d4	rewrite README: fix typos, add versions table, validation docs - fix "verison" → "version", "pyhiscal" → "physical", "distiction" → "distinction" - add versions table explaining each layout version - add installation from DMG section - add validation section with usage examples - restructure changelog with clearer per-version descriptions - fix dead key table formatting Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-03-03 17:06:48 +01:00
felixfoertsch	079ff0a872	add build, DMG creation scripts, CI/CD workflows - build-bundle.sh: regenerates Info.plist with KLInfo entries for all 4 layout versions, sets CalVer bundle version, validates plists - create-dmg.sh: packages bundle into a DMG with drag-and-drop symlink to /Library/Keyboard Layouts/ - release.yml: GitHub Actions workflow that validates, builds, creates DMG, publishes GitHub Release on CalVer tag push - validate.yml: CI validation on push/PR for layout and script changes - Info.plist now declares all 4 layouts (was only v2.0) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-03-03 17:06:48 +01:00
felixfoertsch	7084817dab	add validation infrastructure, fix "6" key bug in v1.3 - add keylayout XML parser (parse_keylayout.py) that extracts all key mappings, dead key compositions, modifier layers from .keylayout files - add validation script (validate_layouts.py) that compares layouts against v1.3 reference with per-version exception support - fix action id="6" outputting "p" instead of "6" in v1.3 - generate reference JSON for all 4 layout versions - document known intentional differences: v1.2 (no ¬ dead key, § vs ẞ), v1.4 (ẞ on §/` caps, extra ¬ composition) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-03-03 17:06:48 +01:00
felixfoertsch	e16b92051d	add v1.3 to the bundle, implements official spec Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-03-03 17:06:48 +01:00
felixfoertsch	b5e2de535e	create bundle, add v1.4, v2.0 to the bundle Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-03-03 17:06:48 +01:00