documentation

  • 8th June 2025

Versioning

Since version 2.45 xkeyboard-config switched to a versioning scheme to enable parallel installation of multiple versions, in a directoty tree independent of X11 files.

Read more 
  • 2nd November 2010

The XKB Configuration Guide

Abstract

This document describes how to configure Xorg XKB from a user’s point of view. It covers the basic configuration syntax and gives a few examples.

This version covers Xorg server versions 1.8 and later, used with the data files from the xkeyboard-config project.

Read more 
  • 25th November 2002

How to enhance XKB configuration

Abstract

This guide is aimed at alleviating one’s labour when creating a new (internationalized) keyboard layout. Unlike other documents, this guide emphasizes the keymap developer’s point of view.

Read more 

About

This project provides a consistent, well-structured, frequently released, open source database of keyboard configuration data. The project is targeted at XKB-based systems.

Read more 

Contributing to xkeyboard-config

Thank you for your interest in contributing to xkeyboard-config! There are many ways to contribute and we appreciate all of them.

Read more 

Symbols organization

The files in the symbols directory describe possible keyboard layouts for a given country or language or script.

Read more