Skip to content

Commit 920ae41

Browse files
authored
Revise Python version and installation steps
Update Python version requirements and installation instructions in the French README.
1 parent d912ffd commit 920ae41

1 file changed

Lines changed: 26 additions & 113 deletions

File tree

docs/doc/fr/readme.md

Lines changed: 26 additions & 113 deletions
Original file line numberDiff line numberDiff line change
@@ -33,15 +33,15 @@ Lors du premier démarrage de QualCoder, vous pouvez [configurer les fonctionnal
3333

3434
Vous avez deux options, voir le lien « Releases » (Versions) à droite de cette page :
3535
- Les versions plus récentes contiennent un fichier **exe** créé sous Windows 11. Double-cliquez pour l'exécuter, le démarrage prend 20 secondes.
36-
- Depuis la version 3.6, des **installateurs Windows** sont disponibles sur la page des versions.
36+
- Fes **installateurs Windows** sont disponibles sur la page des versions.
3737

3838
Lors de la première utilisation du fichier exe, Windows peut vous demander d'autoriser l'exécution de QualCoder. Cela est dû au fait qu'il provient d'un éditeur inconnu. L'obtention d'un certificat d'éditeur de confiance coûte très cher, ce qui rend cette option impossible dans un avenir proche. Si ces avertissements vous inquiètent, procédez à l'installation à partir de la source comme indiqué ci-dessous.
3939

4040
**Vous pouvez également procéder à l'installation à partir de la source :**
4141

4242
Utilisez un environnement virtuel (commandes au point 6 ci-dessous). Le fait de ne pas utiliser d'environnement virtuel peut affecter d'autres logiciels Python que vous avez peut-être installés.
4343

44-
1. Téléchargez et installez le langage de programmation Python. Veuillez utiliser Python 3.10, 3.11 ou 3.12 sous Windows, les autres versions pouvant causer des problèmes [Python3](https://www.python.org/downloads/). Téléchargez le dernier « programme d'installation Windows (64 bits) » (ou celui qui correspond à votre architecture) pour l'une des versions Python mentionnées ci-dessus.
44+
1. Téléchargez et installez le langage de programmation Python. Veuillez utiliser Python 3.11 à 3.14 sous Windows, les autres versions pouvant causer des problèmes [Python3](https://www.python.org/downloads/). Téléchargez le dernier « programme d'installation Windows (64 bits) » (ou celui qui correspond à votre architecture) pour l'une des versions Python mentionnées ci-dessus.
4545

4646
IMPORTANT : dans la première fenêtre de l'installation, cochez l'option « Ajouter Python au PATH ».
4747

@@ -59,7 +59,7 @@ cd Downloads\QualCoder-master
5959

6060
6. Installez l'environnement virtuel et les modules Python requis.
6161

62-
La commande `py` utilise la dernière version installée de Python. La commande `py` ne fonctionne pas sur tous les systèmes d'exploitation Windows. Vous pouvez remplacer `py` par `python3`. Si plusieurs versions de Python sont installées sur votre système Windows, vous pouvez utiliser une version spécifique, par exemple `py -3.10`. Voir la discussion ici : [Différence entre py et python](https://stackoverflow.com/questions/50896496/what-is-the-difference-between-py-and-python-in-the-terminal)
62+
La commande `py` utilise la dernière version installée de Python. La commande `py` ne fonctionne pas sur tous les systèmes d'exploitation Windows. Vous pouvez remplacer `py` par `python3`. Si plusieurs versions de Python sont installées sur votre système Windows, vous pouvez utiliser une version spécifique, par exemple `py -3.14`. Voir la discussion ici : [Différence entre py et python](https://stackoverflow.com/questions/50896496/what-is-the-difference-between-py-and-python-in-the-terminal)
6363

6464
L'installation peut prendre jusqu'à 10 minutes. Sur certains systèmes d'exploitation Windows, vous devrez peut-être remplacer la commande _py_ par _python3_ ci-dessous :
6565

@@ -70,13 +70,7 @@ py -m pip install --upgrade pip
7070
py -m pip install -r requirements.txt
7171
```
7272

73-
7. Exécutez QualCoder à partir de l'invite de commande, versions jusqu'à 3.6
74-
75-
```bash
76-
py -m qualcoder
77-
```
78-
79-
Dernier code, version 3.7 et supérieure, commencez par vous rendre dans le dossier src interne :
73+
7. Exécutez QualCoder à partir de l'invite de commande, La dernière version du code (version 3.7 et supérieur), commencez par vous rendre dans le dossier src interne :
8074

8175
```bash
8276
cd src
@@ -91,15 +85,15 @@ La commande devrait enlever le mot *(env)*.
9185

9286
**Relancer QualCoder**
9387

94-
Si vous n’êtes pas dans un environnement virtuel,
88+
Si vous n’êtes pas dans un environnement virtuel :
89+
9590
Si vous n'utilisez pas d'environnement virtuel, tant que vous êtes dans la même lettre de lecteur, par exemple C:
9691

9792
`py -m qualcoder`
9893

9994
Si vous utilisez un environnement virtuel :
10095

101-
`cd` to the Qualcoder-master (or Qualcoder release folder) for versions up to 3.6:
102-
96+
`cd` vers le dossier src à l'intérieur du dossier Qualcoder-master (ou Qualcoder release) :
10397
```
10498
env\Scripts\activate
10599
py -m qualcoder
@@ -121,7 +115,9 @@ Vous trouverez deux options (le « X » représentant la version actuelle) joint
121115

122116
Les ensembles d'applications sont compilés sur macOS Sequoia. Ils peuvent également fonctionner sur Sonoma et Ventura. Si vous utilisez une version plus ancienne, pensez à mettre à jour votre système d'exploitation ou à installer QualCoder à partir de la source, comme décrit ci-dessous.
123117

124-
Remarque : nous ne sommes actuellement pas en mesure de signer les ensembles d'applications, vous recevrez donc un avertissement indiquant que QualCoder provient d'un développeur non enregistré. Vous devez autoriser manuellement l'exécution de l'application si votre Gatekeeper est actif. Suivez ces étapes :
118+
Remarque : nous ne sommes actuellement pas en mesure de signer les ensembles d'applications, vous recevrez donc un avertissement indiquant que QualCoder provient d'un développeur non enregistré.
119+
120+
Vous devez autoriser manuellement l'exécution de l'application si votre Gatekeeper est actif. Suivez ces étapes :
125121
- Double-cliquez sur le fichier dmg téléchargé.
126122
- Faites glisser QualCoder vers le lien vers vos applications (ignorez le dossier « __main__ » qui se trouve également dans la fenêtre).
127123
- Lancez QualCoder en double-cliquant sur l'application dans votre dossier Applications. Vous recevrez un message d'erreur indiquant que QualCoder provient d'un développeur non enregistré. L'application ne se lancera pas.
@@ -132,64 +128,22 @@ Si ces paquets d'applications ne fonctionnent pas pour vous et que vous souhaite
132128

133129
**Sinon, installez à partir de la source :**
134130

135-
Utilisez un environnement virtuel (commandes au point 6 ci-dessous)
136-
137-
```bash
138-
cd Downloads/QualCoder-master
139-
```
140-
141-
6. Installer l’environnement virtuel et les paquets Python.
142-
143-
La commande « python3 » utilise la dernière version installée de Python. Vous pouvez utiliser une version spécifique sur votre macOS si vous avez plusieurs versions de Python installées, par exemple « python3.10 ». Pour vérifier que vous utilisez la bonne version de Python, tapez `which python3`, ce qui devrait afficher : `/Library/Frameworks/Python.framework/Versions/3.<version>/bin/python3`. Si le résultat est `/usr/bin/python3`, ne continuez pas, car il s'agit du Python de votre système et son utilisation est déconseillée.
131+
**Alternative : installation à partir du code source**
144132

145-
L'installation peut prendre jusqu'à 10 minutes.
133+
Utilisez un environnement virtuel (commandes au point 6 ci-dessous). Ne pas utiliser d'environnement virtuel peut affecter d'autres logiciels Python que vous avez installés.
146134

147-
```bash
148-
python3 -m venv env # this creates the virtual environment with the name "env" in your current directory
149-
source env/bin/activate # this activates the virtual environment "env", (env) should appear in front of your prompt
150-
pip3 install --upgrade pip # optionally; pip and pip3 are equivalent withing a virtual environment
151-
pip3 install -r requirements.txt
152-
```
135+
1. Téléchargez et installez le langage de programmation Python. Utilisez Python 3.10, 3.11 ou 3.12 sur macOS, d'autres versions peuvent causer des problèmes : [Python3](https://www.python.org/downloads/macos/). Téléchargez le dernier « macOS 64-bit universal2 installer » pour l'une des versions de Python mentionnées ci-dessus et ouvrez-le pour installer Python.
153136

154-
7. Lancer QualCoder depuis la console
137+
2. Téléchargez le logiciel QualCoder depuis : <https://github.com/ccbogel/QualCoder> en cliquant sur le bouton vert "Code". Il s'agit du code le plus récent, mais pas encore officiellement publié (des erreurs de codage peuvent parfois s'y glisser). Cliquez sur le bouton vert "Code", puis sur "Download ZIP". **Alternativement**, choisissez le fichier ZIP de la dernière version officielle, voir le lien vers les "Releases" sur le côté droit de cette page.
155138

156-
```bash
157-
cd src # only for version 3.7 and newer
158-
python3 -m qualcoder # python and python3 are equivalent withing a virtual environment
159-
```
160-
161-
8. Si QualCoder est lancé dans un environnement virtuel (ce qui est recommandé), pour quitter l’environnement virtuel, tapez :
162-
163-
```bash
164-
deactivate
165-
```
166-
167-
La commande devrait enlever le mot *(env)*.
168-
169-
**Pour relancer QualCoder**
170-
171-
Si vous n’êtes pas dans un environnement virtuel :
172-
173-
```bash
174-
cd Downloads/QualCoder-master
175-
cd src # only for version 3.7 and newer
176-
python3 -m qualcoder
177-
```
139+
3. Décompressez le dossier (par exemple dans "Téléchargements") en double-cliquant dessus.
178140

179-
Si vous êtes dans un environnement virtuel :
180-
181-
```bash
182-
cd Downloads/QualCoder-master
183-
source env/bin/activate
184-
cd src # only for version 3.7 and newer
185-
python3 -m qualcoder
186-
```
141+
4. Utilisez l'application Terminal (`Applications -> Utilitaires -> Terminal`).
187142

143+
5. Dans le terminal, déplacez-vous (avec la commande `cd`) dans le dossier QualCoder. Vous devriez être dans le dossier QualCoder-master ou, si vous utilisez une version officielle (par exemple QualCoder-3.8), dans ce dossier
188144
## Linux
189145

190-
### Ubuntu Linux
191-
192-
Il existe un lien vers un fichier exécutable (double-cliquez pour l'exécuter) pour Ubuntu dans la version 3.6.
146+
### Ubuntu / Lubuntu / ZorinOS
193147

194148
Pour installer à partir du code source ci-dessous, dans un environnement virtuel. Si vous utilisez le gestionnaire de bureau alternatif Ubuntu **Xfce**, vous devrez peut-être exécuter cette commande : `sudo apt install libxcb-cursor0`
195149

@@ -205,16 +159,16 @@ Pour installer à partir du code source ci-dessous, dans un environnement virtue
205159

206160
Par exemple, vous pourriez vous trouver dans ce dossier, où vous avez décompressé Qualcoder :
207161

208-
votreordinateur:~Téléchargements/QualCoder-3.7
162+
votreordinateur:~Téléchargements/QualCoder-3.8
209163

210164
```
211-
python3.12 -m venv env
165+
python3 -m venv env
212166
source env/bin/activate
213167
pip install --upgrade pip
214168
pip install -r requirements.txt
215169
```
216170

217-
5. Dernière version du code, version 3.7 et supérieure, commencez par vous rendre dans le dossier src interne :
171+
5. Allez dans le dossier src :
218172

219173
```
220174
cd src
@@ -275,47 +229,6 @@ These instructions are adapted from the Fedora 42 instructions below, tested wit
275229
python3.12 -m qualcoder
276230
```
277231

278-
### Fedora 42
279-
280-
Ces instructions permettent de télécharger le code source actuel directement depuis GitHub. Remarque : Fedora utilise Wayland, qui peut ne pas fonctionner correctement avec l'interface graphique Qt. Il est recommandé d'installer également Xwayland.
281-
Codage audio et vidéo : le logiciel plante et aucune solution n'a été trouvée pour le moment.
282-
283-
`sudo dnf install python3.12`
284-
285-
```
286-
virtualenv env
287-
source env/bin/activate
288-
python3.12 -m ensurepip
289-
python3.12 -m pip install --upgrade pip
290-
git clone https://github.com/ccbogel/QualCoder.git
291-
cd QualCoder
292-
python3.12 -m pip install -r requirements.txt
293-
```
294-
Pour exécuter QualCoder 3.6 :
295-
```
296-
python3.12 -m qualcoder
297-
```
298-
299-
Pour le code le plus récent, version 3.7 et supérieure, commencez par vous rendre dans le dossier src interne :
300-
301-
```
302-
cd src
303-
python3.12 -m qualcoder
304-
```
305-
306-
Pour désactiver l'environnement virtuel :
307-
308-
`deactivate`
309-
310-
**Utilisation :**
311-
312-
À tout moment, accédez au dossier Qualcoder à l'aide de la commande `cd` (si vous utilisez QualCoder 3.7 ou une version ultérieure, accédez au dossier src interne à l'aide de la commande cd src`) et entrez les commandes suivantes :
313-
314-
```
315-
cd QualCoder
316-
source env/bin/activate
317-
python3.12 -m qualcoder
318-
```
319232

320233
Une fois terminé, tapez `deactivate` pour quitter l'environnement virtuel.
321234
@@ -339,11 +252,11 @@ pip install --upgrade pip
339252
pip install -r requirements.txt
340253
```
341254
342-
Maintenant, la commande pour démarrer QualCoder, pour les versions jusqu'à 3.6 :
255+
Maintenant, la commande pour démarrer QualCoder, :
343256
344257
`python3 -m qualcoder`
345258
346-
Dernier code, version 3.7 et supérieure, cd vers le dossier src interne d'abord :
259+
Aller vers le dossier src interne d'abord :
347260

348261
```
349262
cd src
@@ -354,7 +267,7 @@ Après avoir utilisé QualCoder, désactivez l'environnement virtuel.
354267
355268
`deactivate`
356269
357-
Utilisation à tout moment après l'installation, déplacez-vous vers le dossier (puis vers le dossier src interne si vous utilisez la version 3.7 et supérieure), puis :
270+
Utilisation à tout moment après l'installation, déplacez-vous vers le dossier, puis vers le dossier src interne, puis :
358271
359272
```
360273
cd QualCoder
@@ -382,8 +295,8 @@ QualCoder est distribué sous licence LGPLv3.
382295
383296
## Citation APA style
384297
385-
Curtain, C. Dröge, K. (2025) QualCoder 3.7 [Computer software]. Retrieved from
386-
https://github.com/ccbogel/QualCoder/releases/tag/3.7
298+
Curtain, C. Dröge, K. (2025) QualCoder 3.8 [Computer software]. Retrieved from
299+
https://github.com/ccbogel/QualCoder/releases/tag/3.8
387300
388301
## Créateur
389302

0 commit comments

Comments
 (0)