aboutsummaryrefslogtreecommitdiff
path: root/docs/fr-fr/cli.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/fr-fr/cli.md')
-rw-r--r--docs/fr-fr/cli.md127
1 files changed, 0 insertions, 127 deletions
diff --git a/docs/fr-fr/cli.md b/docs/fr-fr/cli.md
deleted file mode 100644
index 917a9315b..000000000
--- a/docs/fr-fr/cli.md
+++ /dev/null
@@ -1,127 +0,0 @@
1# La CLI de QMK
2
3Cette page décrit comment configurer et utiliser la CLI QMK.
4
5# Vue d'ensemble
6
7La CLI de QMK permet de simplifier la compilation et l'interaction avec les claviers QMK. Nous avons défini plusieurs commandes pour simplifier et rationaliser les tâches telles qu'obtenir et compiler le firmware QMK, créer de nouvelles keymaps, et plus.
8
9* [CLI globale](#global-cli)
10* [CLI locale](#local-cli)
11* [Les commandes CLI](#cli-commands)
12
13# Pré-requis
14
15La CLI nécessite Python 3.5 ou plus récent. Nous essayons de limiter le nombre de pré-requis, mais vous allez aussi devoir installer les paquets listés dans le fichier [`requirements.txt`](https://github.com/qmk/qmk_firmware/blob/master/requirements.txt).
16
17# CLI globale
18
19QMK met à disposition une CLI installable qui peut être utilisée pour configurer votre environnement de compilation QMK, fonctionne avec QMK, et qui rend l'utilisation de plusieurs copies de `qmk_firmware` plus simple. Nous recommandons d'installer et de mettre à jour ceci régulièrement.
20
21## Installer en utilisant Homebrew (macOS, quelques Linux)
22
23Si vous avez installé [Homebrew](https://brew.sh) vous pouvez entrer ce qui suit et installer QMK:
24
25```
26brew tap qmk/qmk
27brew install qmk
28export QMK_HOME='~/qmk_firmware' # Optional, set the location for `qmk_firmware`
29qmk setup # This will clone `qmk/qmk_firmware` and optionally set up your build environment
30```
31
32## Installer en utilisant easy_install ou pip
33
34Si votre système n'est pas listé ci-dessus, vous pouvez installer QMK manuellement. Premièrement, vérifiez que vous avez bien installé Python 3.5 (ou plus récent) et pip. Ensuite, installez QMK avec cette commande:
35
36```
37pip3 install qmk
38export QMK_HOME='~/qmk_firmware' # Optional, set the location for `qmk_firmware`
39qmk setup # This will clone `qmk/qmk_firmware` and optionally set up your build environment
40```
41
42## Paquets pour d'autres systèmes d'exploitation
43
44Nous recherchons des gens pour créer et maintenir un paquet `qmk` pour plus de systèmes d'exploitation. Si vous voulez créer un paquet pour votre système d'exploitation, suivez ces directives:
45
46* Suivez les bonnes pratiques pour votre système d'exploitation lorsqu'elles entrent en conflit avec ces directives
47 * Documentez pourquoi dans un commentaire lorsque vous ne les suivez pas
48* Installez en utilisant un virtualenv
49* Expliquez à l'utilisateur de définir la variable d'environnement `QMK_Home` pour "check out" les sources du firmware à un autre endroit que `~/qmk_firmware`.
50
51# Les commandes CLI
52
53## `qmk compile`
54
55Cette commande permet de compiler le firmware de n'importe quel répertoire. Vous pouvez compiler des exports JSON de <https://config.qmk.fm> ou compiler des keymaps du dépôt.
56
57**Utilisation pour les exports de configuration**:
58
59```
60qmk compile <configuratorExport.json>
61```
62
63**Utilisation pour les Keymaps**:
64
65```
66qmk compile -kb <keyboard_name> -km <keymap_name>
67```
68
69## `qmk format-c`
70
71Cette commande formatte le code C en utilisant clang-format. Lancez-la sans arguments pour formatter tout le code core, ou passez les noms de fichiers à la ligne de commande pour la lancer sur des fichiers spécifiques.
72
73**Utilisation**:
74
75```
76qmk format-c [file1] [file2] [...] [fileN]
77```
78
79## `qmk config`
80
81Cette commande vous permet de configurer le comportement de QMK. Pour la documentation complète de `qmk config`, regardez [Configuration de CLI](cli_configuration.md).
82
83**Utilisation**:
84
85```
86qmk config [-ro] [config_token1] [config_token2] [...] [config_tokenN]
87```
88
89## `qmk doctor`
90
91Cette commande examine votre environnement et vous alertes des potentiels problèmes de compilation ou de flash.
92
93**Utilisation**:
94
95```
96qmk doctor
97```
98
99## `qmk new-keymap`
100
101Cette commande crée une nouvelle keymap basée sur une keymap par défaut d'un clavier existant.
102
103**Utilisation**:
104
105```
106qmk new-keymap [-kb KEYBOARD] [-km KEYMAP]
107```
108
109## `qmk format-py`
110
111Cette commande formate le code python dans `qmk_firmware`.
112
113**Utilisation**:
114
115```
116qmk format-py
117```
118
119## `qmk pytest`
120
121Cette commande démarre la suite de test python. Si vous faites des changements dans le code Python, assurez-vous que les tests se lancent avec succès.
122
123**Utilisation**:
124
125```
126qmk pytest
127```