# AZERTY Global — Installation Linux

> Ce kit installe AZERTY Global comme disposition XKB Linux.

## Installation automatique

1. Ouvrez un terminal dans ce dossier.
2. Si le terminal n'est pas déjà dans le dossier extrait, allez dans le dossier du kit :

```bash
cd ~/Téléchargements/AZERTY_Global_Linux*
```

ou, selon la langue de votre dossier utilisateur :

```bash
cd ~/Downloads/AZERTY_Global_Linux*
```

3. Rendez les scripts exécutables :

```bash
chmod +x install.sh uninstall.sh
```

4. Lancez l'installation :

```bash
sudo ./install.sh
```

5. Fermez puis rouvrez votre session.

Le script installe la disposition XKB, enregistre `French (AZERTY Global)` et ajoute les règles Compose nécessaires aux touches mortes. Les fichiers XKB modifiés sont sauvegardés avec une extension `.backup.DATE`.

Des captures Fedora/GNOME sont disponibles dans `Captures installation Fedora GNOME/` si vous voulez suivre l'installation visuellement.

## Activer AZERTY Global

### GNOME / Fedora / Ubuntu

1. Ouvrez `Paramètres` → `Clavier`.
2. Dans `Sources de saisie`, cliquez sur `+`.
3. Cliquez sur les trois points en bas de la liste.
4. Dans la barre de recherche, tapez `azerty global`.
5. GNOME affiche `Autre` : ouvrez cette entrée.
6. Sélectionnez `French (AZERTY Global)`.

Sur Fedora/GNOME, AZERTY Global n'apparaît pas dans `Français (France)`, car il est installé comme disposition XKB autonome. Il est rangé sous `Autre`.

### KDE / Plasma

1. Ouvrez `Configuration du système`.
2. Allez dans `Périphériques d'entrée` → `Clavier` → `Dispositions`.
3. Ajoutez `French (AZERTY Global)`.

### Autres environnements

Cherchez la gestion des sources de saisie ou dispositions clavier. Le nom attendu est :

```text
French (AZERTY Global)
```

## Désinstallation

Pour retirer AZERTY Global :

```bash
sudo ./uninstall.sh
```

Le script retire seulement les entrées AZERTY Global, conserve les sauvegardes `.backup.DATE` et supprime le fragment Compose installé pour l'utilisateur.

## Installation manuelle

Si le script automatique ne convient pas à votre distribution :

1. Copiez `azerty_global` dans `/usr/share/X11/xkb/symbols/`.
2. Ajoutez l'entrée AZERTY Global dans `evdev.xml` et, si présent, `base.xml`.
3. Copiez `.XCompose_azerty_global` vers `~/.XCompose_azerty_global`.
4. Ajoutez dans `~/.XCompose` :

```text
include "%H/.XCompose_azerty_global"
```

## Ressources et support

- Guide : [https://azerty.global/guide](https://azerty.global/guide)
- Téléchargement : [https://azerty.global/download](https://azerty.global/download)
- FAQ : [https://azerty.global/faq](https://azerty.global/faq)
- Retours : [https://azerty.global/feedback](https://azerty.global/feedback)
- Support : [contact@azerty.global](mailto:contact@azerty.global)
- Discord : [https://discord.com/invite/nYknqshJz3](https://discord.com/invite/nYknqshJz3)

© 2017–2026 AZERTY Global — Association pour la Modernisation du Clavier Français
