Soumettre un clavier Keyman

Voici les étapes détaillées pour soumettre votre clavier via GitHub. Ceci est un survol du processus: Le process detaillé est à https://help.keyman.com/developer/keyboards/github/ 

Étape 0 : Préparation

• Choisissez un Nom pour Votre Clavier : Le nom doit être unique, ASCII, et ne peut contenir que des lettres minuscules, des chiffres, et des underscores. Évitez les termes comme "keyboard" ou "unicode".
• Structure du Dossier : Utilisez une structure de dossier régulière. Chaque clavier doit être dans un dossier portant son nom. Regardez d’autres claviers à https://github.com/keymanapp/keyboards (https://github.com/keymanapp/keyboards) .
• Créer des Fichiers : Les fichiers nécessaires incluent `.kmn` (source du clavier), `.kps` (package source), `.kpj` (fichier projet Keyman), et autres fichiers comme des images et des fichiers de documentation.

Étape 1 : Créer un Fork

• Créez un Compte GitHub : Si vous n'avez pas de compte GitHub, rendez-vous sur https://github.com/ et suivez les instructions pour en créer un. Un compte GitHub est nécessaire pour soumettre des contributions à la communauté open source.
• Github Desktop : Téléchargez et installez GitHub Desktop.
• Fork le Dépôt Keyman : Créez un fork du dépôt 'keyboards' sur GitHub keyboards (https://github.com/keymanapp/keyboards). Cela crée une copie du dépôt dans votre espace GitHub.

Étape 2 : Ajouter le Clavier

• Clonez Votre Fork : Clonez le fork sur votre machine locale.
  • Cliquez “Cloner”, puis choisissez l’emplacement.
• Ajoutez Votre Clavier : Ajoutez votre clavier dans le dossier approprié (généralement `release` ou `experimental`) dans un dossier avec le nom du clavier.
• Commit et Push : Faites des commits de vos changements et poussez-les vers votre fork sur GitHub.

Étape 3 : Soumettre un Pull Request

• Ouvrir un Pull Request : Sur GitHub ou GitHub Desktop, naviguez vers votre fork et cliquez sur "New pull request". Comparez les branches et créez le pull request.
• Description du Pull Request : Fournissez une description claire de votre clavier et de ce qu'il fait.
• Révision et Communication : L'équipe Keyman examinera votre soumission et communiquera avec vous pour des révisions éventuelles.
• Mise à Jour du Fork : Si nécessaire, mettez à jour votre fork pour le garder synchronisé avec le dépôt principal.

Étape 4: Fusion

• Accepté Une fois satisfaite, l’équipe accepter votre clavier.

Étape 5: Tester le clavier

• Tester: Environ un jour apres la fusion, votre clavier sera disponible sur Keyman.com et aussi dan l’appli. Allez le tester.

Étape 6: Maintenance

• Si le clavier n’est pas comme attendu, ou vous avez des mises à jour à envoyer :
  •    Ouvrez Github Desktop et `Pull` pour avoir la dernière version.
  •    Modifiez le clavier dans la copie locale de “keyboards”.
  •    Commit et Push.
  •    Revenir à étape 3.

Ces étapes représentent un guide complet pour soumettre un clavier Keyman via GitHub. Chaque étape est cruciale pour assurer que votre clavier est correctement examiné et intégré dans la communauté Keyman.