You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

105 lines
5.3 KiB

  1. # Configurateur de QMK
  2. Le [Configurateur de QMK](https://config.qmk.fm) est une interface graphique en ligne permettant de générer des fichiers "hex" du firmware de QMK.
  3. ?> **S'il vous plaît, suivez les étapes suivantes dans l'ordre.**
  4. Regardez le [Tutoriel vidéo](https://youtu.be/tx54jkRC9ZY)https://www.youtube.com/watch?v=-imgglzDMdY)
  5. Le configurateur de QMK fonctionne mieux avec Chrome et Firefox.
  6. !> **Les fichiers d'autres outils, tels que KLE ou kbfirmware ne seront pas compatibles avec le configurateur QMK. Ne les chargez pas, ne les importez pas. Le configurateur QMK est un outil DIFFERENT.**
  7. ## Sélectionner votre clavier
  8. Cliquez la boîte déroulante et sélectionnez le clavier pour lequel vous voulez créer une keymap.
  9. ?> Si votre clavier a plusieurs versions, faites attention à utiliser la bonne.
  10. Je vais le répéter, parce que c'est important
  11. !> **FAITES ATTENTION A UTILISER LA BONNE VERSION !**
  12. Si votre clavier est annoncé comme fonctionnant grâce à QMK mais n'est pas dans la liste, il y a des chances que le développeur ne l'ait pas encore fait, ou que nous n'avons pas encore eu le temps de le merger. Ajoutez un problème (issue) sur [qmk_firmware](https://github.com/qmk/qmk_firmware/issues) demandant le support de votre clavier, s'il n'y a pas de [Pull Request](https://github.com/qmk/qmk_firmware/pulls?q=is%3Aopen+is%3Apr+label%3Akeyboard) ouvert pour lui. Il y a aussi des claviers alimentés par QMK qui sont sur le compte GitHub du fabricant, il est bon de le vérifier aussi.
  13. ## Sélectionner la disposition de votre clavier
  14. Choisissez la disposition (layout) qui représente le mieux la keymap que vous voulez créer. Certains claviers n'ont pas encore assez de dispositions ou des dispositions incorrectes. Ils seront supportés dans le future.
  15. ## Nom de la Keymap
  16. Appelez cette keymap comme vous voulez.
  17. ?> Si vous rencontrez des problèmes lors de la compilation, il peut être utile de changer ce nom, il peut déjà exister dans le dépôt du firmware QMK.
  18. ## Créer votre keymap
  19. Entrer un keycode peut s'accomplir de 3 façons différentes.
  20. 1. Glisser déposer
  21. 2. Cliquer sur un endroit vide sur le layout et cliquer sur le keycode souhaité
  22. 3. Cliquer sur un endroit vide sur le layout et appuyer sur une touche physique de votre clavier.
  23. Passez votre souris au dessus d'une touche et un affichage vous dira quel est le rôle du keycode. Pour une version plus verbeuse suivre:
  24. [Référence Keycode basique](https://docs.qmk.fm/#/keycodes_basic)
  25. [Référence Keycode avancé](https://docs.qmk.fm/#/feature_advanced_keycodes)
  26. Dans le cas où vous ne trouvez pas une disposition qui supporte votre keymap, par exemple trois places pour une barre d'espace, ou deux places pour retour clavier, ou deux places pour shift, etc. etc. remplissez les TOUTES.
  27. ### Exemples
  28. 3 places pour la barre d'espace: Remplissez les TOUTES avec la barre d'espace
  29. 2 places pour un retour clavier: Remplissez les DEUX avec un retour clavier
  30. 2 places pour un shift droit: Remplissez les DEUX avec un shift droit
  31. 1 place pour un shift gauche et 1 place pour le support ISO: Remplissez les deux avec un shift gauche
  32. 5 places, mais seulement 4 touches: Deviner et vérifier, ou demander à quelqu'un qui l'a déjà fait.
  33. ## Sauvez votre keymap pour des éditions futures
  34. Une fois satisfait de votre keymap, ou si vous souhaitez revenir travailler dessus plus tard, appuyez sur le bouton `Export Keymap`. Il vous permettra de sauvegarder votre keymap avec le nom choisi au dessus suivi de .json.
  35. Vous pouvez ensuite charger ce fichier .json à nouveau en appuxant sur le bouton `Import Keymap`.
  36. !> **ATTENTION** Ce n'est pas le même type de fichier .json utilisé pour kbfirmware.com ou n'importe quel autre outil. Si vous essayez d'utiliser ce fichier pour d'autres outil, ou le fichier .json d'autres outils avec le configurateur QMK, il y a des chances que votre clavier **explose**.
  37. ## Générer votre fichier firmware
  38. Appuyez sur le bouton `Compile`.
  39. Une fois la compilation terminée, vous pourrez appuyer sur le bouton vert `Download Firmware`.
  40. ## Ecrire votre firmware sur votre clavier
  41. Merci de vous référer à [Flasher le Firmware](fr-FR/newbs_flashing.md)
  42. ## Dépannage
  43. #### Mon fichier json ne fonctionne pas
  44. Si le fichier .json a été généré par le configurateur QMK, bravo vous avez trouvé un bug. Merci d'ouvrir une issue sur [qmk_configurator](https://github.com/qmk/qmk_configurator/issues)
  45. Sinon... vous avez raté mon message écris en gras qui dit de ne pas utiliser d'autres fichiers .json?
  46. #### Il y a des espaces en trop dans mon alyout? Qu'est-ce que je fais?
  47. Si vous voulez dire que vous avez trois places pour une barre d'espace, le mieux est de les remplir tous avec une barre d'espace. Vous pouvez faire de même avec les retour clavier et les shift.
  48. #### C'est quoi le keycode pour .......
  49. Merci de regarder
  50. [Référence keycode basique](https://docs.qmk.fm/#/keycodes_basic)
  51. [Référence keycode avancé](https://docs.qmk.fm/#/feature_advanced_keycodes)
  52. #### Ca ne compile pas?
  53. Merci de vérifier les autres dispositions de votre keymap afin d'être sûr qu'il n'y a pas de touches aléatoires.
  54. ## Problèmes et Bugs
  55. Nous acceptons toujours les demandes des clients et les rapports de bugs. Merci de les remplirs sur [qmk_configurator](https://github.com/qmk/qmk_configurator/issues)