Merge pull request #5 from Nael-Sayegh/documentation-fr

Add French translation for the documentation

addon/doc/fr/readme.md

@@ -0,0 +1,69 @@
+# Module Open AI pour NVDA
+
+Ce module est conçu pour intégrer parfaitement les capacités de l'API Open AI dans votre travail. Que vous souhaitiez créer du texte complet, traduire des passages avec précision, résumer des documents de manière concise, ou même interpréter et décrire du contenu visuel, ce module complémentaire fait tout cela avec facilité.
+
+## Installation
+
+1. Allez sur la page des [versions](https://github.com/aaclause/nvda-OpenAI/releases) pour trouver la dernière version de l'extension.
+2. Téléchargez la dernière version à partir du lien fourni.
+3. Exécutez le programme d'installation pour ajouter le module complémentaire à votre environnement NVDA.
+
+## Prérequis pour l'utilisation
+
+Pour utiliser toutes les fonctionnalités du module OpenAI pour NVDA, une clé API de OpenAI est requise. Suivez ces étapes pour la configurer :
+
+1. Obtenez une clé API en vous inscrivant à un compte OpenAI à l'adresse suivante : [https://platform.openai.com/api-keys](https://platform.openai.com/api-keys).
+2. Avec la clé API prête, vous avez deux options de configuration :
+   - Par le biais de la boîte de dialogue des paramètres de NVDA :
+     1. Accédez au menu NVDA et naviguez vers le sous-menu "Préférences".
+     2. Ouvrez la boîte de dialogue "Paramètres" et sélectionnez la catégorie "Open AI".
+     3. Saisissez votre clé API dans le champ prévu à cet effet et cliquez sur "OK" pour confirmer.
+   - En utilisant des variables d'environnement :
+     1. Appuyez sur `Windows+Pause` pour ouvrir les Propriétés du système.
+     2. Cliquez sur "Paramètres avancés du système" et sélectionnez "Variables d'environnement".
+     3. Créez une nouvelle variable sous "Variables utilisateur" :
+         1. Cliquez sur "Nouveau".
+         2. Entrez `OPENAI_API_KEY` comme nom de la variable et collez votre clé API comme valeur.
+     4. Cliquez sur "OK" pour enregistrer vos modifications.
+
+Vous êtes maintenant prêt à explorer les fonctionnalités du module OpenAI pour NVDA !
+
+## Comment utiliser le module
+
+### Accès aux principales fonctionnalités
+
+La fonctionnalité du module est situé dans une boîte de dialogue centrale qui peut être ouverte en utilisant le raccourci `NVDA+g`. Cette boîte de dialogue donne accès à la majorité des fonctionnalités du module complémentaire, ce qui vous permet de :
+
+- Engager une conversation avec le modèle d'IA.
+- Obtenir des descriptions d'images à partir de fichiers d'images.
+- Transcrire du contenu oral à partir de fichiers audio ou via un microphone.
+- Utiliser la fonction Text-To-Tpeech pour vocaliser le texte écrit dans le Prompt.
+
+#### Commandes à partir de la boîte de dialogue principale
+
+Certaines commandes sont disponibles dans la boîte de dialogue principale pour différents éléments.
+
+- Lorsque le champ du prompt est sélectionné :
+	- `Ctrl+Entrée` : Soumettre le texte que vous avez entré.
+	- `Ctrl+Flèche haut` : Récupérez et placez le prompt le plus récent dans le champ actuel pour relecture ou réutilisation.
+- Lorsque le champ de l'historique est sélectionné :
+	- `Alt+Flèche droite` : Copier le texte de l'utilisateur dans le prompt.
+	- `Alt+Flèche gauche` : Copier la réponse de l'assistant dans le système.
+	- `Ctrl+C` : Copier la réponse de l'assistant ou le texte de l'utilisateur en fonction de la position du curseur.
+	- `Ctrl+Maj+Flèche haut` : Passer au bloc de texte de l'utilisateur ou de l'assistant au-dessus du bloc actuel.
+	- `Ctrl+Maj+Flèche bas` : Passez au bloc de texte de l'utilisateur ou de l'assistant en dessous du bloc actuel.
+
+### Commandes globales
+
+Ces commandes peuvent être utilisées pour déclencher des actions à partir de n'importe où sur votre ordinateur. Il est possible de les réaffecter à partir de la boîte de dialogue *Gestes de commandes* sous la catégorie *Open AI*.
+
+- `NVDA+e` : Faire une capture d'écran et la décrire.
+- `NVDA+o` : Saisissir l'objet de navigateur actuel et le décrire.
+
+## Dépendances incluses
+
+Le module complémentaire est fourni avec les dépendances essentielles suivantes :
+
+- [OpenAI](https://pypi.org/project/openai/) : La bibliothèque Python officielle pour l'API openai.
+- [MSS](https://pypi.org/project/mss/) : Un module multi-captures d'écran ultra-rapide multi-plateformes en Python pur utilisant ctypes.
+- [sounddevice](https://pypi.org/project/sounddevice/) : Jouer et enregistrer du son avec Python.

addon/locale/fr/LC_MESSAGES/nvda.po

@@ -1,9 +1,9 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: open ai\n"
-"Report-Msgid-Bugs-To: '[email protected]'\n"
-"POT-Creation-Date: 2023-11-23 21:16+0100\n"
-"PO-Revision-Date: 2023-11-23 21:31+0100\n"
+"Report-Msgid-Bugs-To: [email protected]\n"
+"POT-Creation-Date: 2023-11-27 15:06+0100\n"
+"PO-Revision-Date: 2023-11-27 19:34+0100\n"
 "Last-Translator: \n"
 "Language-Team: \n"
 "Language: fr\n"
@@ -54,7 +54,7 @@ msgstr ""
 
 #: addon\globalPlugins\openai\__init__.py:124
 msgid "Remember the content of the S&ystem field between sessions"
-msgstr "Se souvenir du contenu du champ S&ystem entre les sessions"
+msgstr "Se souvenir du contenu du champ S&ystème entre les sessions"
 
 #: addon\globalPlugins\openai\__init__.py:132
 msgid "Enable &advanced settings (including temperature and probability mass)"
@@ -83,10 +83,15 @@ msgstr "Affiche le dialogue Open AI"
 msgid "Take a screenshot and describe it"
 msgstr "Prendre une capture d'écran et la décrire"
 
-#: addon\globalPlugins\openai\__init__.py:268
+#: addon\globalPlugins\openai\__init__.py:270
 msgid "Grab the current navigator object and describe it"
 msgstr "Prendre l'objet navigateur courant et le décrire"
 
+#: addon\globalPlugins\openai\__init__.py:307
+msgid "Please disable the screen curtain before taking a screenshot"
+msgstr ""
+"Veuillez désactiver le ridaeu d'écran avant de prendre une capture d'écran"
+
 #: addon\globalPlugins\openai\maindialog.py:38
 msgid "Describe the images in as much detail as possible."
 msgstr "Décris les images avec autant de détails que possible."
@@ -137,7 +142,7 @@ msgstr "GPT-4 Turbo avec vision"
 
 #: addon\globalPlugins\openai\maindialog.py:442
 msgid "GPT-4 Turbo, 128K context, maximum of 4096 output tokens."
-msgstr "GPT-4 Turbo, contexte de 128K, maximum de 4096 tokens de sortie."
+msgstr "GPT-4 Turbo, contexte de 128K, maximum de 4096 tokens en sortie."
 
 #: addon\globalPlugins\openai\maindialog.py:443
 msgid ""
@@ -188,7 +193,7 @@ msgid "&Debug mode"
 msgstr "Mode &débugage"
 
 #: addon\globalPlugins\openai\maindialog.py:585
-#: addon\globalPlugins\openai\maindialog.py:1027
+#: addon\globalPlugins\openai\maindialog.py:1031
 msgid "Start &recording"
 msgstr "Démarrer l'&enregistrement"
 
@@ -227,7 +232,7 @@ msgstr ""
 
 #: addon\globalPlugins\openai\maindialog.py:681
 #: addon\globalPlugins\openai\maindialog.py:688
-#: addon\globalPlugins\openai\maindialog.py:1010
+#: addon\globalPlugins\openai\maindialog.py:1014
 msgid "Open AI"
 msgstr "Open AI"
 
@@ -240,90 +245,90 @@ msgstr ""
 "sélectionner le modèle %s."
 
 #: addon\globalPlugins\openai\maindialog.py:699
-#: addon\globalPlugins\openai\maindialog.py:999
-#: addon\globalPlugins\openai\maindialog.py:1015
+#: addon\globalPlugins\openai\maindialog.py:1003
+#: addon\globalPlugins\openai\maindialog.py:1019
 msgid "Processing, please wait..."
 msgstr "Traitement en cours, veuillez patienter..."
 
-#: addon\globalPlugins\openai\maindialog.py:758
+#: addon\globalPlugins\openai\maindialog.py:762
 #, python-format
 msgid "Insertion of: %s"
 msgstr "Insertion de: %s"
 
-#: addon\globalPlugins\openai\maindialog.py:769
+#: addon\globalPlugins\openai\maindialog.py:773
 msgid "Open AI error"
 msgstr "Erreur open AI"
 
-#: addon\globalPlugins\openai\maindialog.py:779
+#: addon\globalPlugins\openai\maindialog.py:783
 msgid "Press alt+f4 to close the dialog"
 msgstr "Pressez alt+f4 pour fermer le dialogue"
 
-#: addon\globalPlugins\openai\maindialog.py:789
+#: addon\globalPlugins\openai\maindialog.py:793
 msgid "User:"
 msgstr "Utilisateur :"
 
-#: addon\globalPlugins\openai\maindialog.py:791
+#: addon\globalPlugins\openai\maindialog.py:795
 msgid "Assistant:"
 msgstr "Assistant :"
 
-#: addon\globalPlugins\openai\maindialog.py:853
+#: addon\globalPlugins\openai\maindialog.py:857
 msgid "Begin"
 msgstr "Début"
 
-#: addon\globalPlugins\openai\maindialog.py:873
+#: addon\globalPlugins\openai\maindialog.py:877
 msgid "End"
 msgstr "Fin"
 
-#: addon\globalPlugins\openai\maindialog.py:901
+#: addon\globalPlugins\openai\maindialog.py:905
 #, python-format
 msgid "Response copied to system: %s"
 msgstr "Réponse copiée vers le système : %s"
 
-#: addon\globalPlugins\openai\maindialog.py:910
+#: addon\globalPlugins\openai\maindialog.py:914
 msgid "Compied to prompt"
 msgstr "Copié vers le prompt"
 
-#: addon\globalPlugins\openai\maindialog.py:914
+#: addon\globalPlugins\openai\maindialog.py:918
 msgid "Copy"
 msgstr "Copié"
 
-#: addon\globalPlugins\openai\maindialog.py:922
+#: addon\globalPlugins\openai\maindialog.py:926
 msgid "Copy prompt"
 msgstr "Prompt copié"
 
-#: addon\globalPlugins\openai\maindialog.py:925
+#: addon\globalPlugins\openai\maindialog.py:929
 msgid "Copy response"
 msgstr "Réponse copié"
 
-#: addon\globalPlugins\openai\maindialog.py:950
+#: addon\globalPlugins\openai\maindialog.py:954
 msgid "Block deleted"
 msgstr "Block supprimé"
 
-#: addon\globalPlugins\openai\maindialog.py:960
+#: addon\globalPlugins\openai\maindialog.py:964
 msgid "Select image files"
 msgstr "Sélectionnez un fichier image"
 
-#: addon\globalPlugins\openai\maindialog.py:962
+#: addon\globalPlugins\openai\maindialog.py:966
 msgid "Image files"
 msgstr "Fichiers image"
 
-#: addon\globalPlugins\openai\maindialog.py:982
+#: addon\globalPlugins\openai\maindialog.py:986
 msgid "Stop &recording"
 msgstr "&Arrêter l'enregistrement"
 
-#: addon\globalPlugins\openai\maindialog.py:991
+#: addon\globalPlugins\openai\maindialog.py:995
 msgid "Select audio file"
 msgstr "Sélectionnez un fichier audio"
 
-#: addon\globalPlugins\openai\maindialog.py:993
+#: addon\globalPlugins\openai\maindialog.py:997
 msgid ""
 "Audio files (*.mp3;*.mp4;*.mpeg;*.mpga;*.m4a;*.wav;*.webm)|*.mp3;*.mp4;*."
 "mpeg;*.mpga;*.m4a;*.wav;*.webm"
 msgstr ""
 "Fichiers audio (*.mp3;*.mp4;*.mpeg;*.mpga;*.m4a;*.wav;*.webm)|*.mp3;*.mp4;*."
 "mpeg;*.mpga;*.m4a;*.wav;*.webm"
 
-#: addon\globalPlugins\openai\maindialog.py:1009
+#: addon\globalPlugins\openai\maindialog.py:1013
 msgid "Please enter some text in the prompt field first."
 msgstr "Veuillez saisir d'abord du texte dans le champ de saisie."