From 7d1ad1866ecaf0a62cb58be69a24811faa0e29a8 Mon Sep 17 00:00:00 2001 From: Mathieu Benoit Date: Sat, 7 Mar 2026 00:29:49 -0500 Subject: [PATCH] [FIX] doc markdown french accent --- README.base.md | 82 +++++++++--------- README.fr.md | 82 +++++++++--------- doc/CODE_GENERATOR.base.md | 20 ++--- doc/CODE_GENERATOR.fr.md | 20 ++--- doc/DEVELOPMENT.base.md | 110 ++++++++++++------------ doc/DEVELOPMENT.fr.md | 110 ++++++++++++------------ doc/PRODUCTION.base.md | 82 +++++++++--------- doc/PRODUCTION.fr.md | 82 +++++++++--------- doc/RELEASE.base.md | 72 ++++++++-------- doc/RELEASE.fr.md | 72 ++++++++-------- doc/WINDOWS_INSTALLATION.base.md | 140 +++++++++++++++---------------- doc/WINDOWS_INSTALLATION.fr.md | 140 +++++++++++++++---------------- 12 files changed, 506 insertions(+), 506 deletions(-) diff --git a/README.base.md b/README.base.md index 881f989..b07de49 100644 --- a/README.base.md +++ b/README.base.md @@ -18,13 +18,13 @@ pre-trained Generative Transformers (GPT), bringing an additional dimension to d -ERPLibre est une plateforme CRM/ERP incluant l'installation, la maintenance et le developpement automatises de modules +ERPLibre est une plateforme CRM/ERP incluant l'installation, la maintenance et le développement automatisés de modules open source de la version communautaire d'Odoo. C'est un "soft-fork" de l'Odoo Community Edition (OCE), ce qui signifie -qu'il vise a contribuer en amont. -Il est base sur un ensemble de modules prets pour la production, supportes par l'Odoo Community Association (OCA) et un -ecosysteme d'entreprises specialisees. Cette solution assure la souverainete numerique dans un environnement local tout -en integrant des Transformers Generatifs Pre-entraines (GPT), apportant une dimension supplementaire a la gestion des -donnees et a l'automatisation. +qu'il vise à contribuer en amont. +Il est basé sur un ensemble de modules prêts pour la production, supportés par l'Odoo Community Association (OCA) et un +écosystème d'entreprises spécialisées. Cette solution assure la souveraineté numérique dans un environnement local tout +en intégrant des Transformers Génératifs Pré-entraînés (GPT), apportant une dimension supplémentaire à la gestion des +données et à l'automatisation. @@ -50,17 +50,17 @@ Suivez-nous sur Mastodon : https://fosstodon.org/@erplibre -# Fonctionnalites +# Fonctionnalités -- **Support multi-version Odoo** : executez Odoo 12.0, 13.0, 14.0, 15.0, 16.0, 17.0 et 18.0 dans le meme espace de travail, avec des environnements virtuels Python independants (`.venv.erplibre` et `.venv.odooXX`) -- **CLI interactif (TODO.py)** : outil interactif guide pour l'installation, l'execution, la gestion de bases de donnees, le formatage de code, la compilation mobile, et plus encore. Lancez-le avec `make` -- **Generateur de code** : generez des modules Odoo automatiquement avec support des vues, portail, snippets, heritage, i18n et JavaScript -- **Automatisation Selenium** : tests web et automatisation avec Selenium Grid, enregistrement video et automatisation de connexion -- **Application mobile** : ERPLibre Home Mobile (Owl + Capacitor), compilee et deployee via TODO.py -- **Deploiement Docker** : images Docker pretes pour la production avec PostgreSQL 18 et PostGIS -- **Outils de deploiement** : Nginx, Apache, Cloudflare DDNS, Certbot SSL, services systemd -- **Outils de base de donnees** : sauvegarde, restauration, clonage, migration entre versions, migration production vers developpement -- **Outils de performance** : mesure de requetes par seconde, execution de tests en parallele, analyse de couverture +- **Support multi-version Odoo** : exécutez Odoo 12.0, 13.0, 14.0, 15.0, 16.0, 17.0 et 18.0 dans le même espace de travail, avec des environnements virtuels Python indépendants (`.venv.erplibre` et `.venv.odooXX`) +- **CLI interactif (TODO.py)** : outil interactif guidé pour l'installation, l'exécution, la gestion de bases de données, le formatage de code, la compilation mobile, et plus encore. Lancez-le avec `make` +- **Générateur de code** : générez des modules Odoo automatiquement avec support des vues, portail, snippets, héritage, i18n et JavaScript +- **Automatisation Selenium** : tests web et automatisation avec Selenium Grid, enregistrement vidéo et automatisation de connexion +- **Application mobile** : ERPLibre Home Mobile (Owl + Capacitor), compilée et déployée via TODO.py +- **Déploiement Docker** : images Docker prêtes pour la production avec PostgreSQL 18 et PostGIS +- **Outils de déploiement** : Nginx, Apache, Cloudflare DDNS, Certbot SSL, services systemd +- **Outils de base de données** : sauvegarde, restauration, clonage, migration entre versions, migration production vers développement +- **Outils de performance** : mesure de requêtes par seconde, exécution de tests en parallèle, analyse de couverture @@ -68,7 +68,7 @@ Suivez-nous sur Mastodon : https://fosstodon.org/@erplibre -# Versions Odoo supportees +# Versions Odoo supportées @@ -101,7 +101,7 @@ Changez de version avec `make switch_odoo_18`, `make switch_odoo_16`, etc. -# Plateformes supportees +# Plateformes supportées - **Linux** : Ubuntu 20.04, 22.04, 24.04, 25.04; Debian 12; Arch Linux - **macOS** : via pyenv @@ -125,10 +125,10 @@ Internet. ## Installation facile sur Ubuntu ou Debian avec Docker -Ceci a ete teste sur Debian 12 et Ubuntu 24.04 LTS. +Ceci a été testé sur Debian 12 et Ubuntu 24.04 LTS. -**Note** : Ceci est prevu pour un environnement de test, sur un reseau local ou un environnement similaire non expose -directement a Internet. +**Note** : Ceci est prévu pour un environnement de test, sur un réseau local ou un environnement similaire non exposé +directement à Internet. @@ -151,17 +151,17 @@ directement a Internet. -1. Assurez-vous que Docker et le serveur web nginx sont installes :
+1. Assurez-vous que Docker et le serveur web nginx sont installés :
`sudo apt install docker.io docker-compose-v2 nginx` 1. Obtenez le dernier fichier Docker compose d'ERPLibre :
`wget https://raw.githubusercontent.com/ERPLibre/ERPLibre/master/docker-compose.yml` 1. Installez et lancez ERPLibre avec Docker en mode daemon (serveur web) :
``sudo docker compose up -d` -1. Ouvrez l'etape finale d'installation a cette page web :
+1. Ouvrez l'étape finale d'installation à cette page web :
`http://[server IP]:8069/web/database/manager`
![odoo_first_installation.png](doc/image/odoo_first_installation.png) -1. Terminez l'installation en fournissant un nom de base de donnees, un courriel et un mot de passe, puis cliquez sur **Create Database**. - Selon les ressources de votre systeme, **cela peut prendre plus de 2 minutes sans retour visuel !** Verifiez +1. Terminez l'installation en fournissant un nom de base de données, un courriel et un mot de passe, puis cliquez sur **Create Database**. + Selon les ressources de votre système, **cela peut prendre plus de 2 minutes sans retour visuel !** Vérifiez l'indicateur de chargement de votre navigateur. 1. Ensuite, la page web se rechargera automatiquement et vous devriez voir la liste des applications dans ERPLibre :
![odoo_application_list.png](doc/image/odoo_application_list.png) @@ -182,7 +182,7 @@ Pour plus d'informations, consultez le [guide Docker](./docker/README.md). ## Installation depuis le code source -### Installation automatisee +### Installation automatisée @@ -219,7 +219,7 @@ Follow the instruction on the following script, it will try to detect your envir -Suivez les instructions du script suivant, il essaiera de detecter votre environnement. +Suivez les instructions du script suivant, il essaiera de détecter votre environnement. @@ -237,7 +237,7 @@ Into Ubuntu, minimal dependency: ### Manuellement -Sous Ubuntu, dependance minimale : +Sous Ubuntu, dépendance minimale : @@ -251,7 +251,7 @@ Into Ubuntu, developer dependency: -Sous Ubuntu, dependance developpeur : +Sous Ubuntu, dépendance développeur : @@ -295,7 +295,7 @@ Install a specific Odoo version: -Installez une version specifique d'Odoo : +Installez une version spécifique d'Odoo : @@ -311,7 +311,7 @@ Update your configuration if you need to run from another interface than 127.0.0 -Mettez a jour votre configuration si vous devez executer depuis une autre interface que 127.0.0.1, fichier `config.conf` +Mettez à jour votre configuration si vous devez exécuter depuis une autre interface que 127.0.0.1, fichier `config.conf` @@ -339,7 +339,7 @@ Ready to execute: -Pret a executer : +Prêt à exécuter : @@ -357,7 +357,7 @@ Execute ERPLibre test with his code generator. # Test -Executez les tests ERPLibre avec son generateur de code. +Exécutez les tests ERPLibre avec son générateur de code. @@ -389,14 +389,14 @@ time make test_full_fast | Guide | Description | |-------|-------------| -| [DISCOVER](doc/DISCOVER.md) | Decouvrir et explorer ERPLibre | -| [DEVELOPMENT](doc/DEVELOPMENT.md) | Configuration de l'environnement de developpement | -| [PRODUCTION](doc/PRODUCTION.md) | Deploiement du serveur de production | -| [RUN](doc/RUN.md) | Modes d'execution et cas d'utilisation | -| [CODE_GENERATOR](doc/CODE_GENERATOR.md) | Generation de code de modules Odoo | -| [MIGRATION](doc/MIGRATION.md) | Migration de base de donnees entre versions | -| [GIT_REPO](doc/GIT_REPO.md) | Gestion des depots Git | -| [POETRY](doc/POETRY.md) | Gestion des dependances Python | +| [DISCOVER](doc/DISCOVER.md) | Découvrir et explorer ERPLibre | +| [DEVELOPMENT](doc/DEVELOPMENT.md) | Configuration de l'environnement de développement | +| [PRODUCTION](doc/PRODUCTION.md) | Déploiement du serveur de production | +| [RUN](doc/RUN.md) | Modes d'exécution et cas d'utilisation | +| [CODE_GENERATOR](doc/CODE_GENERATOR.md) | Génération de code de modules Odoo | +| [MIGRATION](doc/MIGRATION.md) | Migration de base de données entre versions | +| [GIT_REPO](doc/GIT_REPO.md) | Gestion des dépôts Git | +| [POETRY](doc/POETRY.md) | Gestion des dépendances Python | | [FAQ](doc/FAQ.md) | Foire aux questions | | [HOWTO](doc/HOWTO.md) | Guides pratiques | | [WINDOWS_INSTALLATION](doc/WINDOWS_INSTALLATION.md) | Installation sous Windows | diff --git a/README.fr.md b/README.fr.md index dd83be4..bd81c44 100644 --- a/README.fr.md +++ b/README.fr.md @@ -3,32 +3,32 @@ # ERPLibre -ERPLibre est une plateforme CRM/ERP incluant l'installation, la maintenance et le developpement automatises de modules +ERPLibre est une plateforme CRM/ERP incluant l'installation, la maintenance et le développement automatisés de modules open source de la version communautaire d'Odoo. C'est un "soft-fork" de l'Odoo Community Edition (OCE), ce qui signifie -qu'il vise a contribuer en amont. -Il est base sur un ensemble de modules prets pour la production, supportes par l'Odoo Community Association (OCA) et un -ecosysteme d'entreprises specialisees. Cette solution assure la souverainete numerique dans un environnement local tout -en integrant des Transformers Generatifs Pre-entraines (GPT), apportant une dimension supplementaire a la gestion des -donnees et a l'automatisation. +qu'il vise à contribuer en amont. +Il est basé sur un ensemble de modules prêts pour la production, supportés par l'Odoo Community Association (OCA) et un +écosystème d'entreprises spécialisées. Cette solution assure la souveraineté numérique dans un environnement local tout +en intégrant des Transformers Génératifs Pré-entraînés (GPT), apportant une dimension supplémentaire à la gestion des +données et à l'automatisation. Suivez-nous sur Mastodon : https://fosstodon.org/@erplibre -# Fonctionnalites +# Fonctionnalités -- **Support multi-version Odoo** : executez Odoo 12.0, 13.0, 14.0, 15.0, 16.0, 17.0 et 18.0 dans le meme espace de travail, avec des environnements virtuels Python independants (`.venv.erplibre` et `.venv.odooXX`) -- **CLI interactif (TODO.py)** : outil interactif guide pour l'installation, l'execution, la gestion de bases de donnees, le formatage de code, la compilation mobile, et plus encore. Lancez-le avec `make` -- **Generateur de code** : generez des modules Odoo automatiquement avec support des vues, portail, snippets, heritage, i18n et JavaScript -- **Automatisation Selenium** : tests web et automatisation avec Selenium Grid, enregistrement video et automatisation de connexion -- **Application mobile** : ERPLibre Home Mobile (Owl + Capacitor), compilee et deployee via TODO.py -- **Deploiement Docker** : images Docker pretes pour la production avec PostgreSQL 18 et PostGIS -- **Outils de deploiement** : Nginx, Apache, Cloudflare DDNS, Certbot SSL, services systemd -- **Outils de base de donnees** : sauvegarde, restauration, clonage, migration entre versions, migration production vers developpement -- **Outils de performance** : mesure de requetes par seconde, execution de tests en parallele, analyse de couverture +- **Support multi-version Odoo** : exécutez Odoo 12.0, 13.0, 14.0, 15.0, 16.0, 17.0 et 18.0 dans le même espace de travail, avec des environnements virtuels Python indépendants (`.venv.erplibre` et `.venv.odooXX`) +- **CLI interactif (TODO.py)** : outil interactif guidé pour l'installation, l'exécution, la gestion de bases de données, le formatage de code, la compilation mobile, et plus encore. Lancez-le avec `make` +- **Générateur de code** : générez des modules Odoo automatiquement avec support des vues, portail, snippets, héritage, i18n et JavaScript +- **Automatisation Selenium** : tests web et automatisation avec Selenium Grid, enregistrement vidéo et automatisation de connexion +- **Application mobile** : ERPLibre Home Mobile (Owl + Capacitor), compilée et déployée via TODO.py +- **Déploiement Docker** : images Docker prêtes pour la production avec PostgreSQL 18 et PostGIS +- **Outils de déploiement** : Nginx, Apache, Cloudflare DDNS, Certbot SSL, services systemd +- **Outils de base de données** : sauvegarde, restauration, clonage, migration entre versions, migration production vers développement +- **Outils de performance** : mesure de requêtes par seconde, exécution de tests en parallèle, analyse de couverture -# Versions Odoo supportees +# Versions Odoo supportées | Odoo version | Python | Status | @@ -45,7 +45,7 @@ Suivez-nous sur Mastodon : https://fosstodon.org/@erplibre Changez de version avec `make switch_odoo_18`, `make switch_odoo_16`, etc. -# Plateformes supportees +# Plateformes supportées - **Linux** : Ubuntu 20.04, 22.04, 24.04, 25.04; Debian 12; Arch Linux - **macOS** : via pyenv @@ -57,23 +57,23 @@ Changez de version avec `make switch_odoo_18`, `make switch_odoo_16`, etc. ## Installation facile sur Ubuntu ou Debian avec Docker -Ceci a ete teste sur Debian 12 et Ubuntu 24.04 LTS. +Ceci a été testé sur Debian 12 et Ubuntu 24.04 LTS. -**Note** : Ceci est prevu pour un environnement de test, sur un reseau local ou un environnement similaire non expose -directement a Internet. +**Note** : Ceci est prévu pour un environnement de test, sur un réseau local ou un environnement similaire non exposé +directement à Internet. -1. Assurez-vous que Docker et le serveur web nginx sont installes :
+1. Assurez-vous que Docker et le serveur web nginx sont installés :
`sudo apt install docker.io docker-compose-v2 nginx` 1. Obtenez le dernier fichier Docker compose d'ERPLibre :
`wget https://raw.githubusercontent.com/ERPLibre/ERPLibre/master/docker-compose.yml` 1. Installez et lancez ERPLibre avec Docker en mode daemon (serveur web) :
``sudo docker compose up -d` -1. Ouvrez l'etape finale d'installation a cette page web :
+1. Ouvrez l'étape finale d'installation à cette page web :
`http://[server IP]:8069/web/database/manager`
![odoo_first_installation.png](doc/image/odoo_first_installation.png) -1. Terminez l'installation en fournissant un nom de base de donnees, un courriel et un mot de passe, puis cliquez sur **Create Database**. - Selon les ressources de votre systeme, **cela peut prendre plus de 2 minutes sans retour visuel !** Verifiez +1. Terminez l'installation en fournissant un nom de base de données, un courriel et un mot de passe, puis cliquez sur **Create Database**. + Selon les ressources de votre système, **cela peut prendre plus de 2 minutes sans retour visuel !** Vérifiez l'indicateur de chargement de votre navigateur. 1. Ensuite, la page web se rechargera automatiquement et vous devriez voir la liste des applications dans ERPLibre :
![odoo_application_list.png](doc/image/odoo_application_list.png) @@ -85,7 +85,7 @@ Pour plus d'informations, consultez le [guide Docker](./docker/README.md). ## Installation depuis le code source -### Installation automatisee +### Installation automatisée Pour Debian/Ubuntu @@ -105,7 +105,7 @@ cd ERPLibre ``` -Suivez les instructions du script suivant, il essaiera de detecter votre environnement. +Suivez les instructions du script suivant, il essaiera de détecter votre environnement. ```bash @@ -115,7 +115,7 @@ make ### Manuellement -Sous Ubuntu, dependance minimale : +Sous Ubuntu, dépendance minimale : ```bash @@ -123,7 +123,7 @@ sudo apt install make git curl ``` -Sous Ubuntu, dependance developpeur : +Sous Ubuntu, dépendance développeur : ```bash @@ -149,7 +149,7 @@ make install_odoo_18 ``` -Installez une version specifique d'Odoo : +Installez une version spécifique d'Odoo : ```bash @@ -159,7 +159,7 @@ make install_odoo_18 ``` -Mettez a jour votre configuration si vous devez executer depuis une autre interface que 127.0.0.1, fichier `config.conf` +Mettez à jour votre configuration si vous devez exécuter depuis une autre interface que 127.0.0.1, fichier `config.conf` ``` @@ -175,7 +175,7 @@ make version ``` -Pret a executer : +Prêt à exécuter : ```bash @@ -185,7 +185,7 @@ make run # Test -Executez les tests ERPLibre avec son generateur de code. +Exécutez les tests ERPLibre avec son générateur de code. ```bash @@ -197,14 +197,14 @@ time make test_full_fast | Guide | Description | |-------|-------------| -| [DISCOVER](doc/DISCOVER.md) | Decouvrir et explorer ERPLibre | -| [DEVELOPMENT](doc/DEVELOPMENT.md) | Configuration de l'environnement de developpement | -| [PRODUCTION](doc/PRODUCTION.md) | Deploiement du serveur de production | -| [RUN](doc/RUN.md) | Modes d'execution et cas d'utilisation | -| [CODE_GENERATOR](doc/CODE_GENERATOR.md) | Generation de code de modules Odoo | -| [MIGRATION](doc/MIGRATION.md) | Migration de base de donnees entre versions | -| [GIT_REPO](doc/GIT_REPO.md) | Gestion des depots Git | -| [POETRY](doc/POETRY.md) | Gestion des dependances Python | +| [DISCOVER](doc/DISCOVER.md) | Découvrir et explorer ERPLibre | +| [DEVELOPMENT](doc/DEVELOPMENT.md) | Configuration de l'environnement de développement | +| [PRODUCTION](doc/PRODUCTION.md) | Déploiement du serveur de production | +| [RUN](doc/RUN.md) | Modes d'exécution et cas d'utilisation | +| [CODE_GENERATOR](doc/CODE_GENERATOR.md) | Génération de code de modules Odoo | +| [MIGRATION](doc/MIGRATION.md) | Migration de base de données entre versions | +| [GIT_REPO](doc/GIT_REPO.md) | Gestion des dépôts Git | +| [POETRY](doc/POETRY.md) | Gestion des dépendances Python | | [FAQ](doc/FAQ.md) | Foire aux questions | | [HOWTO](doc/HOWTO.md) | Guides pratiques | | [WINDOWS_INSTALLATION](doc/WINDOWS_INSTALLATION.md) | Installation sous Windows | diff --git a/doc/CODE_GENERATOR.base.md b/doc/CODE_GENERATOR.base.md index 5366640..1b6ef55 100644 --- a/doc/CODE_GENERATOR.base.md +++ b/doc/CODE_GENERATOR.base.md @@ -286,7 +286,7 @@ Aller dans le module «Code generator» et créer un module «test». - Choisir le «Modèle» : «Contact»; - Choisir unité de temps en «Minutes» dans «Exécuter tous les»; - Modifier «Nombre d'appel» à -1 pour exécution sans arrêt; - - Activer «Force nextcall» pour permettre que l'interval soit basé sur le moment d'installation du module. + - Activer «Force nextcall» pour permettre que l'intervalle soit basé sur le moment d'installation du module. - Ajouter le code : @@ -444,7 +444,7 @@ Aller dans le module «Code generator» et créer un module «theme_test»: - Sur l'onglet «Technical Data», activer «Website theme»; - Appuyer sur le bouton «Views»: - Aller à l'onglet «theme_website»: - - Mettre les couleurs désirés; + - Mettre les couleurs désirées; - Appuyer «Generate». Générer le module avec «Action/Générer code». @@ -521,16 +521,16 @@ TODO ### Exporter un site web vers un module -Cette technique a été testé sans thème d'installé. +Cette technique a été testée sans thème installé. Ce qui est exporté : Les pages, les fichiers attachés et les fichiers CSS. Ce qui n'est pas exporté à notre connaissance : Les menus, les fichiers XML autres. À propos des fichiers attachés, ils sont importés et associés à un xml_id. Les doublons sont enlevés et les noms -duppliqués sont gérés. Les URL sont réécrites dans chaque page. +dupliqués sont gérés. Les URL sont réécrites dans chaque page. À propos des fichiers CSS, pour modifier les couleurs sans avoir de thème, aller en mode debug assets, dans le website -builder, activé `Inclure tous les fichiers SCSS`. Vous pourrez ainsi modifier les fichiers `user_color_palette` +builder, activer `Inclure tous les fichiers SCSS`. Vous pourrez ainsi modifier les fichiers `user_color_palette` et `user_theme_color_palette`. Exemple pour `/website/static/src/scss/options/colors/user_color_palette.scss` : @@ -571,7 +571,7 @@ Modifier le module `code_generator_demo_export_website` pour décider du nouveau Suggestion, faites un clone de votre BD de production avant de l'exporter pour ne pas l'affecter, l'exportation modifie des informations dans la base de données. -Le résultat généré montre les fichiers modifiés, mais il doit être adapté, surement être transformé en thème. +Le résultat généré montre les fichiers modifiés, mais il doit être adapté, sûrement être transformé en thème. Supposons que le nom de votre BD est `test_website` : @@ -598,7 +598,7 @@ Supposons que le nom de votre BD est `test_website` : Un fichier temporaire `./image_db/test_website_backup.zip` a été créé, vous pouvez aller l'effacer. -Maintenant, modifier chaques fichiers manuellements de la liste désiré à importer (comme ajouter un espace à la fin du +Maintenant, modifier chaque fichier manuellement de la liste désirée à importer (comme ajouter un espace à la fin du fichier, le formatage va l'effacer) et exécuter : ```bash @@ -711,7 +711,7 @@ make config_gen_all # Créer un générateur de code -Le script suivant sert à démarrer projet avec le générateur de code en appuie. +Le script suivant sert à démarrer un projet avec le générateur de code en appui. ```bash ./script/code_generator/new_project.py -d CHEMIN -m NOM_DU_MODULE @@ -793,7 +793,7 @@ Au besoin, renommer votre module qui débute par `MODULE_NAME = "code_generator_ To continue the example, you generated the template `code_generator_template_demo_website_snippet`, this will overwrite `code_generator_demo_website_snippet`: -Pour continuer avec l'exemple, généré le template `code_generator_template_demo_website_snippet`, ceci va écraser `code_generator_demo_website_snippet`: +Pour continuer avec l'exemple, générer le template `code_generator_template_demo_website_snippet`, ceci va écraser `code_generator_demo_website_snippet` : ```bash @@ -887,7 +887,7 @@ Maintenant, vous pouvez le tester! Pour info, on ne peut pas installer un module -Il est maintenant possible de modifier les paramètres via l'interface manuelle pour ce module, puis le regénérer en effaçant la BD. Ajouter un modèle et une vue. +Il est maintenant possible de modifier les paramètres via l'interface manuelle pour ce module, puis le régénérer en effaçant la BD. Ajouter un modèle et une vue. ```bash diff --git a/doc/CODE_GENERATOR.fr.md b/doc/CODE_GENERATOR.fr.md index 14da37d..b02e5c9 100644 --- a/doc/CODE_GENERATOR.fr.md +++ b/doc/CODE_GENERATOR.fr.md @@ -180,7 +180,7 @@ Aller dans le module «Code generator» et créer un module «test». - Choisir le «Modèle» : «Contact»; - Choisir unité de temps en «Minutes» dans «Exécuter tous les»; - Modifier «Nombre d'appel» à -1 pour exécution sans arrêt; - - Activer «Force nextcall» pour permettre que l'interval soit basé sur le moment d'installation du module. + - Activer «Force nextcall» pour permettre que l'intervalle soit basé sur le moment d'installation du module. - Ajouter le code : ```python @@ -280,7 +280,7 @@ Aller dans le module «Code generator» et créer un module «theme_test»: - Sur l'onglet «Technical Data», activer «Website theme»; - Appuyer sur le bouton «Views»: - Aller à l'onglet «theme_website»: - - Mettre les couleurs désirés; + - Mettre les couleurs désirées; - Appuyer «Generate». Générer le module avec «Action/Générer code». @@ -332,16 +332,16 @@ make db_restore_erplibre_base_db_test_module_test ### Exporter un site web vers un module -Cette technique a été testé sans thème d'installé. +Cette technique a été testée sans thème installé. Ce qui est exporté : Les pages, les fichiers attachés et les fichiers CSS. Ce qui n'est pas exporté à notre connaissance : Les menus, les fichiers XML autres. À propos des fichiers attachés, ils sont importés et associés à un xml_id. Les doublons sont enlevés et les noms -duppliqués sont gérés. Les URL sont réécrites dans chaque page. +dupliqués sont gérés. Les URL sont réécrites dans chaque page. À propos des fichiers CSS, pour modifier les couleurs sans avoir de thème, aller en mode debug assets, dans le website -builder, activé `Inclure tous les fichiers SCSS`. Vous pourrez ainsi modifier les fichiers `user_color_palette` +builder, activer `Inclure tous les fichiers SCSS`. Vous pourrez ainsi modifier les fichiers `user_color_palette` et `user_theme_color_palette`. Exemple pour `/website/static/src/scss/options/colors/user_color_palette.scss` : @@ -382,7 +382,7 @@ Modifier le module `code_generator_demo_export_website` pour décider du nouveau Suggestion, faites un clone de votre BD de production avant de l'exporter pour ne pas l'affecter, l'exportation modifie des informations dans la base de données. -Le résultat généré montre les fichiers modifiés, mais il doit être adapté, surement être transformé en thème. +Le résultat généré montre les fichiers modifiés, mais il doit être adapté, sûrement être transformé en thème. Supposons que le nom de votre BD est `test_website` : @@ -409,7 +409,7 @@ Supposons que le nom de votre BD est `test_website` : Un fichier temporaire `./image_db/test_website_backup.zip` a été créé, vous pouvez aller l'effacer. -Maintenant, modifier chaques fichiers manuellements de la liste désiré à importer (comme ajouter un espace à la fin du +Maintenant, modifier chaque fichier manuellement de la liste désirée à importer (comme ajouter un espace à la fin du fichier, le formatage va l'effacer) et exécuter : ```bash @@ -473,7 +473,7 @@ make config_gen_all # Créer un générateur de code -Le script suivant sert à démarrer projet avec le générateur de code en appuie. +Le script suivant sert à démarrer un projet avec le générateur de code en appui. ```bash ./script/code_generator/new_project.py -d CHEMIN -m NOM_DU_MODULE @@ -513,7 +513,7 @@ make addons_install_code_generator_demo Au besoin, renommer votre module qui débute par `MODULE_NAME = "code_generator_"` -Pour continuer avec l'exemple, généré le template `code_generator_template_demo_website_snippet`, ceci va écraser `code_generator_demo_website_snippet`: +Pour continuer avec l'exemple, générer le template `code_generator_template_demo_website_snippet`, ceci va écraser `code_generator_demo_website_snippet` : ```bash make db_restore_erplibre_base_db_template @@ -561,7 +561,7 @@ make db_restore_erplibre_base_db_code_generator Maintenant, vous pouvez le tester! Pour info, on ne peut pas installer un module généré avec son générateur de code associé, puisqu'il y a une duplication des modèles! -Il est maintenant possible de modifier les paramètres via l'interface manuelle pour ce module, puis le regénérer en effaçant la BD. Ajouter un modèle et une vue. +Il est maintenant possible de modifier les paramètres via l'interface manuelle pour ce module, puis le régénérer en effaçant la BD. Ajouter un modèle et une vue. ```bash make db_restore_erplibre_base_db_code_generator diff --git a/doc/DEVELOPMENT.base.md b/doc/DEVELOPMENT.base.md index 4df3930..bc17732 100644 --- a/doc/DEVELOPMENT.base.md +++ b/doc/DEVELOPMENT.base.md @@ -13,11 +13,11 @@ Setup your environment to develop modules and debug the platform. ### 1. Clone the project: -# Guide de developpement +# Guide de développement -Configurez votre environnement pour developper des modules et deboguer la plateforme. +Configurez votre environnement pour développer des modules et déboguer la plateforme. -## Procedure d'installation locale +## Procédure d'installation locale ### 1. Cloner le projet : @@ -30,7 +30,7 @@ git clone https://github.com/ERPLibre/ERPLibre.git ### 2. Execute the script: -### 2. Executer le script : +### 2. Exécuter le script : ```bash @@ -62,15 +62,15 @@ ERPLibre was created with this script. It's now deprecated. Use this script when original source. Don't use this script if you want to update from ERPLibre and follow mainstream development. -## Developper dans le depot Odoo +## Développer dans le dépôt Odoo Vous devez supprimer `clone-depth="10"` de `./manifest/default.dev.xml` afin de pouvoir faire des commits et des pushs. Faites un -commit temporaire et regenerez avec `./script/install/install_locally_dev.sh` +commit temporaire et régénérez avec `./script/install/install_locally_dev.sh` -## Forker le projet pour creer un nouveau projet independant d'ERPLibre (obsolete) +## Forker le projet pour créer un nouveau projet indépendant d'ERPLibre (obsolète) -ERPLibre a ete cree avec ce script. Il est maintenant obsolete. Utilisez ce script lorsque vous devez forker directement depuis la -source originale. N'utilisez pas ce script si vous voulez recevoir les mises a jour d'ERPLibre et suivre le developpement principal. +ERPLibre a été créé avec ce script. Il est maintenant obsolète. Utilisez ce script lorsque vous devez forker directement depuis la +source originale. N'utilisez pas ce script si vous voulez recevoir les mises à jour d'ERPLibre et suivre le développement principal. ```bash @@ -86,12 +86,12 @@ personal account and choose your user name. This command will fork all repos and ERPLibre to your own organization. It keeps track of ERPLibre. -# Forker tous les depots pour votre propre organisation +# Forker tous les dépôts pour votre propre organisation -Allez dans votre compte Github et generez un jeton pour acceder a l'option de fork avec votre utilisateur. Creez une organisation ou utilisez votre +Allez dans votre compte Github et générez un jeton pour accéder à l'option de fork avec votre utilisateur. Créez une organisation ou utilisez votre compte personnel et choisissez votre nom d'utilisateur. -Cette commande va forker tous les depots et ERPLibre vers votre propre organisation. Elle garde le suivi d'ERPLibre. +Cette commande va forker tous les dépôts et ERPLibre vers votre propre organisation. Elle garde le suivi d'ERPLibre. ```bash @@ -106,11 +106,11 @@ Add repo in file [./source_repo_addons.csv](./source_repo_addons.csv) Execute to generate Repo manifest -## Generer le manifeste a partir du csv des depots +## Générer le manifeste à partir du csv des dépôts -Ajoutez le depot dans le fichier [./source_repo_addons.csv](./source_repo_addons.csv) +Ajoutez le dépôt dans le fichier [./source_repo_addons.csv](./source_repo_addons.csv) -Executez pour generer le manifeste Repo +Exécutez pour générer le manifeste Repo ```bash @@ -128,14 +128,14 @@ When moving database from prod to your dev environment, you want to remove email in order to test the database. Run: -## Deplacer une base de donnees de la prod vers le dev +## Déplacer une base de données de la prod vers le dev -Copiez l'image de la base de donnees dans `./image_db/prod_client.zip` et executez `make db_restore_prod_client`. Cela va creer une -base de donnees -nommee `prod_client` prete a tester. +Copiez l'image de la base de données dans `./image_db/prod_client.zip` et exécutez `make db_restore_prod_client`. Cela va créer une +base de données +nommée `prod_client` prête à tester. -Lorsque vous deplacez une base de donnees de la prod vers votre environnement de dev, vous voulez supprimer les serveurs de courriel, les sauvegardes et installer l'utilisateur de test -afin de tester la base de donnees. Executez : +Lorsque vous déplacez une base de données de la prod vers votre environnement de dev, vous voulez supprimer les serveurs de courriel, les sauvegardes et installer l'utilisateur de test +afin de tester la base de données. Exécutez : ```bash @@ -150,7 +150,7 @@ This will update all urls in Git format: ## Changer les urls git de https vers Git -Cela va mettre a jour toutes les urls au format Git : +Cela va mettre à jour toutes les urls au format Git : ```bash @@ -163,9 +163,9 @@ Cela va mettre a jour toutes les urls au format Git : Tools to display the differences between the repo and another project. -## Afficher les differences de depots entre les projets +## Afficher les différences de dépôts entre les projets -Outils pour afficher les differences entre le depot et un autre projet. +Outils pour afficher les différences entre le dépôt et un autre projet. ```bash @@ -178,7 +178,7 @@ Outils pour afficher les differences entre le depot et un autre projet. To understand the divergences with the dev manifest. -## Afficher les differences de depots avec le manifeste de developpement +## Afficher les différences de dépôts avec le manifeste de développement Pour comprendre les divergences avec le manifeste de dev. @@ -194,10 +194,10 @@ Tools to synchronise the repo with another project. This will show differences a all repos. -## Synchroniser les depots avec un autre projet +## Synchroniser les dépôts avec un autre projet -Outils pour synchroniser le depot avec un autre projet. Cela va afficher les differences et essayer de se positionner sur le meme commit dans -tous les depots. +Outils pour synchroniser le dépôt avec un autre projet. Cela va afficher les différences et essayer de se positionner sur le même commit dans +tous les dépôts. ```bash @@ -212,7 +212,7 @@ To show differences between commits in different manifests ## Comparer deux fichiers manifestes -Pour afficher les differences entre les commits dans differents manifestes +Pour afficher les différences entre les commits dans différents manifestes ```bash @@ -225,9 +225,9 @@ Pour afficher les differences entre les commits dans differents manifestes To show differences between actual code and manifest -## Differences entre le code et le manifeste +## Différences entre le code et le manifeste -Pour afficher les differences entre le code actuel et le manifeste +Pour afficher les différences entre le code actuel et le manifeste ```bash @@ -242,11 +242,11 @@ To access a new repo, add your URL to file [source_repo_addons.csv](../source_re Fork the repo to be able to push new code: -## Ajouter un depot +## Ajouter un dépôt -Pour acceder a un nouveau depot, ajoutez votre URL dans le fichier [source_repo_addons.csv](../source_repo_addons.csv) +Pour accéder à un nouveau dépôt, ajoutez votre URL dans le fichier [source_repo_addons.csv](../source_repo_addons.csv) -Forkez le depot pour pouvoir pousser du nouveau code : +Forkez le dépôt pour pouvoir pousser du nouveau code : ```bash @@ -257,7 +257,7 @@ Forkez le depot pour pouvoir pousser du nouveau code : To regenerate only manifest.xml. -Pour regenerer uniquement le manifest.xml. +Pour régénérer uniquement le manifest.xml. ```bash @@ -268,7 +268,7 @@ Pour regenerer uniquement le manifest.xml. Check if manifest contains "auto_install" and change the value to False. -Verifier si le manifeste contient "auto_install" et changer la valeur a False. +Vérifier si le manifeste contient "auto_install" et changer la valeur à False. ```bash @@ -281,9 +281,9 @@ Verifier si le manifeste contient "auto_install" et changer la valeur a False. Only keep repo tagged by group 'base' and 'code_generator' -## Filtrer les depots par groupe +## Filtrer les dépôts par groupe -Garder uniquement les depots etiquetes par le groupe 'base' et 'code_generator' +Garder uniquement les dépôts étiquetés par le groupe 'base' et 'code_generator' ```bash @@ -298,7 +298,7 @@ Garder uniquement les depots etiquetes par le groupe 'base' et 'code_generator' You can limit your addons in ERPlibre config file depending on a group of your actual manifest. -# Execution +# Exécution ## Fichier de configuration @@ -314,7 +314,7 @@ Vous pouvez limiter vos addons dans le fichier de configuration ERPLibre en fonc Or go back to normal -Ou revenir a la normale +Ou revenir à la normale ```bash @@ -331,12 +331,12 @@ Sometime, it's not possible to delete a database from the database manager `http so you can do it manually. Replace `database_name` by your database name: -# Base de donnees +# Base de données -## Nettoyer une base de donnees PostgreSQL +## Nettoyer une base de données PostgreSQL -Parfois, il n'est pas possible de supprimer une base de donnees depuis le gestionnaire de base de donnees `http://127.0.0.1:8069/web/database/manager`, -vous pouvez donc le faire manuellement. Remplacez `database_name` par le nom de votre base de donnees : +Parfois, il n'est pas possible de supprimer une base de données depuis le gestionnaire de base de données `http://127.0.0.1:8069/web/database/manager`, +vous pouvez donc le faire manuellement. Remplacez `database_name` par le nom de votre base de données : ```bash @@ -348,7 +348,7 @@ psql And run: -Et executez : +Et exécutez : ```postgres-sql @@ -372,9 +372,9 @@ rm -r ~/.local/share/Odoo/filestore/database_name ## Create module scaffold -# Developpement +# Développement -## Creer un squelette de module +## Créer un squelette de module ```bash @@ -407,7 +407,7 @@ Create docker, `make docker_build`. When you need to change python 3.7.17 to 3.8.10, do : -## Utiliser le generateur de code +## Utiliser le générateur de code Lisez CODE_GENERATOR.md. @@ -418,17 +418,17 @@ Lisez GIT_REPO.md pour comprendre comment changer de version. ## Version Python Votre version actuelle est dans le fichier .python-odoo-version. Utilisez le script `./script/version/change_python_version.sh 3.7.16` pour changer -a la version 3.7.16 . +à la version 3.7.16 . Lancez l'installation, `make install_dev`. -Mettez a jour poetry, `./script/poetry/poetry_update.py`. +Mettez à jour poetry, `./script/poetry/poetry_update.py`. -Creez le docker, `make docker_build`. +Créez le docker, `make docker_build`. ### Changement majeur de version Python -Lorsque vous devez changer de python 3.7.17 a 3.8.10, faites : +Lorsque vous devez changer de python 3.7.17 à 3.8.10, faites : ```bash @@ -490,7 +490,7 @@ Utilisez [black](https://github.com/psf/black) Or if you prefer [oca-autopep8](https://github.com/psf/black) -Ou si vous preferez [oca-autopep8](https://github.com/psf/black) +Ou si vous préférez [oca-autopep8](https://github.com/psf/black) ```bash @@ -538,7 +538,7 @@ Check https://github.com/OCA/maintainer-tools/wiki/Install-pre-commit # Pre-commit -Vous pouvez installer pre-commit pour auto-formater et verifier le lint avec la configuration OCA. Cela -s'executera avant chaque commit avec git. +Vous pouvez installer pre-commit pour auto-formater et vérifier le lint avec la configuration OCA. Cela +s'exécutera avant chaque commit avec git. Consultez https://github.com/OCA/maintainer-tools/wiki/Install-pre-commit diff --git a/doc/DEVELOPMENT.fr.md b/doc/DEVELOPMENT.fr.md index 48477d4..061adbe 100644 --- a/doc/DEVELOPMENT.fr.md +++ b/doc/DEVELOPMENT.fr.md @@ -1,9 +1,9 @@ -# Guide de developpement +# Guide de développement -Configurez votre environnement pour developper des modules et deboguer la plateforme. +Configurez votre environnement pour développer des modules et déboguer la plateforme. -## Procedure d'installation locale +## Procédure d'installation locale ### 1. Cloner le projet : @@ -11,7 +11,7 @@ Configurez votre environnement pour developper des modules et deboguer la platef git clone https://github.com/ERPLibre/ERPLibre.git ``` -### 2. Executer le script : +### 2. Exécuter le script : ```bash cd ERPLibre @@ -25,49 +25,49 @@ cd ERPLibre ./run.sh ``` -## Developper dans le depot Odoo +## Développer dans le dépôt Odoo Vous devez supprimer `clone-depth="10"` de `./manifest/default.dev.xml` afin de pouvoir faire des commits et des pushs. Faites un -commit temporaire et regenerez avec `./script/install/install_locally_dev.sh` +commit temporaire et régénérez avec `./script/install/install_locally_dev.sh` -## Forker le projet pour creer un nouveau projet independant d'ERPLibre (obsolete) +## Forker le projet pour créer un nouveau projet indépendant d'ERPLibre (obsolète) -ERPLibre a ete cree avec ce script. Il est maintenant obsolete. Utilisez ce script lorsque vous devez forker directement depuis la -source originale. N'utilisez pas ce script si vous voulez recevoir les mises a jour d'ERPLibre et suivre le developpement principal. +ERPLibre a été créé avec ce script. Il est maintenant obsolète. Utilisez ce script lorsque vous devez forker directement depuis la +source originale. N'utilisez pas ce script si vous voulez recevoir les mises à jour d'ERPLibre et suivre le développement principal. ```bash ./script/git/fork_project.py --github_token GITHUB_KEY --organization NAME ``` -# Forker tous les depots pour votre propre organisation +# Forker tous les dépôts pour votre propre organisation -Allez dans votre compte Github et generez un jeton pour acceder a l'option de fork avec votre utilisateur. Creez une organisation ou utilisez votre +Allez dans votre compte Github et générez un jeton pour accéder à l'option de fork avec votre utilisateur. Créez une organisation ou utilisez votre compte personnel et choisissez votre nom d'utilisateur. -Cette commande va forker tous les depots et ERPLibre vers votre propre organisation. Elle garde le suivi d'ERPLibre. +Cette commande va forker tous les dépôts et ERPLibre vers votre propre organisation. Elle garde le suivi d'ERPLibre. ```bash ./script/git/fork_project_ERPLibre.py --github_token GITHUB_KEY --organization NAME ``` -## Generer le manifeste a partir du csv des depots +## Générer le manifeste à partir du csv des dépôts -Ajoutez le depot dans le fichier [./source_repo_addons.csv](./source_repo_addons.csv) +Ajoutez le dépôt dans le fichier [./source_repo_addons.csv](./source_repo_addons.csv) -Executez pour generer le manifeste Repo +Exécutez pour générer le manifeste Repo ```bash ./script/git/fork_project_ERPLibre.py --skip_fork ``` -## Deplacer une base de donnees de la prod vers le dev +## Déplacer une base de données de la prod vers le dev -Copiez l'image de la base de donnees dans `./image_db/prod_client.zip` et executez `make db_restore_prod_client`. Cela va creer une -base de donnees -nommee `prod_client` prete a tester. +Copiez l'image de la base de données dans `./image_db/prod_client.zip` et exécutez `make db_restore_prod_client`. Cela va créer une +base de données +nommée `prod_client` prête à tester. -Lorsque vous deplacez une base de donnees de la prod vers votre environnement de dev, vous voulez supprimer les serveurs de courriel, les sauvegardes et installer l'utilisateur de test -afin de tester la base de donnees. Executez : +Lorsque vous déplacez une base de données de la prod vers votre environnement de dev, vous voulez supprimer les serveurs de courriel, les sauvegardes et installer l'utilisateur de test +afin de tester la base de données. Exécutez : ```bash ./script/database/migrate_prod_to_test.sh DATABASE @@ -75,21 +75,21 @@ afin de tester la base de donnees. Executez : ## Changer les urls git de https vers Git -Cela va mettre a jour toutes les urls au format Git : +Cela va mettre à jour toutes les urls au format Git : ```bash ./script/git/git_change_remote_https_to_git.py ``` -## Afficher les differences de depots entre les projets +## Afficher les différences de dépôts entre les projets -Outils pour afficher les differences entre le depot et un autre projet. +Outils pour afficher les différences entre le dépôt et un autre projet. ```bash ./script/git/git_change_remote.py --sync_to /path/to/project/erplibre --dry_sync ``` -## Afficher les differences de depots avec le manifeste de developpement +## Afficher les différences de dépôts avec le manifeste de développement Pour comprendre les divergences avec le manifeste de dev. @@ -97,10 +97,10 @@ Pour comprendre les divergences avec le manifeste de dev. ./script/git/git_show_code_diff_repo_manifest.py -m ./manifest/default.dev.xml ``` -## Synchroniser les depots avec un autre projet +## Synchroniser les dépôts avec un autre projet -Outils pour synchroniser le depot avec un autre projet. Cela va afficher les differences et essayer de se positionner sur le meme commit dans -tous les depots. +Outils pour synchroniser le dépôt avec un autre projet. Cela va afficher les différences et essayer de se positionner sur le même commit dans +tous les dépôts. ```bash ./script/git/git_change_remote.py --sync_to /path/to/project/erplibre @@ -108,51 +108,51 @@ tous les depots. ## Comparer deux fichiers manifestes -Pour afficher les differences entre les commits dans differents manifestes +Pour afficher les différences entre les commits dans différents manifestes ```bash ./script/git/git_diff_repo_manifest.py --input1 ./manifest/MANIFEST1.xml --input2 ./manifest/MANIFEST2.xml ``` -## Differences entre le code et le manifeste +## Différences entre le code et le manifeste -Pour afficher les differences entre le code actuel et le manifeste +Pour afficher les différences entre le code actuel et le manifeste ```bash ./script/git/git_show_code_diff_repo_manifest.py --manifest ./manifest/MANIFEST1.xml ``` -## Ajouter un depot +## Ajouter un dépôt -Pour acceder a un nouveau depot, ajoutez votre URL dans le fichier [source_repo_addons.csv](../source_repo_addons.csv) +Pour accéder à un nouveau dépôt, ajoutez votre URL dans le fichier [source_repo_addons.csv](../source_repo_addons.csv) -Forkez le depot pour pouvoir pousser du nouveau code : +Forkez le dépôt pour pouvoir pousser du nouveau code : ```bash ./script/git/fork_project_ERPLibre.py ``` -Pour regenerer uniquement le manifest.xml. +Pour régénérer uniquement le manifest.xml. ```bash ./script/git/fork_project_ERPLibre.py --skip_fork ``` -Verifier si le manifeste contient "auto_install" et changer la valeur a False. +Vérifier si le manifeste contient "auto_install" et changer la valeur à False. ```bash ./script/git/repo_remove_auto_install.py ``` -## Filtrer les depots par groupe +## Filtrer les dépôts par groupe -Garder uniquement les depots etiquetes par le groupe 'base' et 'code_generator' +Garder uniquement les dépôts étiquetés par le groupe 'base' et 'code_generator' ```bash ./script/manifest/update_manifest_local_dev_code_generator.sh ``` -# Execution +# Exécution ## Fichier de configuration @@ -163,26 +163,26 @@ Vous pouvez limiter vos addons dans le fichier de configuration ERPLibre en fonc ./script/generate_config.sh ``` -Ou revenir a la normale +Ou revenir à la normale ```bash ./script/git/git_repo_update_group.py ./script/generate_config.sh ``` -# Base de donnees +# Base de données -## Nettoyer une base de donnees PostgreSQL +## Nettoyer une base de données PostgreSQL -Parfois, il n'est pas possible de supprimer une base de donnees depuis le gestionnaire de base de donnees `http://127.0.0.1:8069/web/database/manager`, -vous pouvez donc le faire manuellement. Remplacez `database_name` par le nom de votre base de donnees : +Parfois, il n'est pas possible de supprimer une base de données depuis le gestionnaire de base de données `http://127.0.0.1:8069/web/database/manager`, +vous pouvez donc le faire manuellement. Remplacez `database_name` par le nom de votre base de données : ```bash sudo -iu postgres psql ``` -Et executez : +Et exécutez : ```postgres-sql DROP DATABASE database_name; @@ -194,16 +194,16 @@ Quittez et supprimez le filestore : rm -r ~/.local/share/Odoo/filestore/database_name ``` -# Developpement +# Développement -## Creer un squelette de module +## Créer un squelette de module ```bash source ./.venv.erplibre/bin/activate python odoo/odoo-bin scaffold MODULE_NAME addons/REPO_NAME/ ``` -## Utiliser le generateur de code +## Utiliser le générateur de code Lisez CODE_GENERATOR.md. @@ -214,17 +214,17 @@ Lisez GIT_REPO.md pour comprendre comment changer de version. ## Version Python Votre version actuelle est dans le fichier .python-odoo-version. Utilisez le script `./script/version/change_python_version.sh 3.7.16` pour changer -a la version 3.7.16 . +à la version 3.7.16 . Lancez l'installation, `make install_dev`. -Mettez a jour poetry, `./script/poetry/poetry_update.py`. +Mettez à jour poetry, `./script/poetry/poetry_update.py`. -Creez le docker, `make docker_build`. +Créez le docker, `make docker_build`. ### Changement majeur de version Python -Lorsque vous devez changer de python 3.7.17 a 3.8.10, faites : +Lorsque vous devez changer de python 3.7.17 à 3.8.10, faites : ```bash rm -r .venv @@ -258,7 +258,7 @@ Utilisez [black](https://github.com/psf/black) ./script/maintenance/black.sh ./addons/TechnoLibre_odoo-code-generator ``` -Ou si vous preferez [oca-autopep8](https://github.com/psf/black) +Ou si vous préférez [oca-autopep8](https://github.com/psf/black) ```bash ./script/maintenance/autopep8.sh ./addons/TechnoLibre_odoo-code-generator @@ -282,7 +282,7 @@ Utilisez [prettier](https://github.com/prettier/prettier) # Pre-commit -Vous pouvez installer pre-commit pour auto-formater et verifier le lint avec la configuration OCA. Cela -s'executera avant chaque commit avec git. +Vous pouvez installer pre-commit pour auto-formater et vérifier le lint avec la configuration OCA. Cela +s'exécutera avant chaque commit avec git. Consultez https://github.com/OCA/maintainer-tools/wiki/Install-pre-commit \ No newline at end of file diff --git a/doc/PRODUCTION.base.md b/doc/PRODUCTION.base.md index 2d6de0d..2078db9 100644 --- a/doc/PRODUCTION.base.md +++ b/doc/PRODUCTION.base.md @@ -42,12 +42,12 @@ True. Redirect your DNS to the proxy's ip and add your A and AAAA into `EL_WEBSI #### With proxy nginx production, install certbot before for SSL -### 2. Modifier les parametres +### 2. Modifier les paramètres -Modifiez le fichier env_var.sh pour l'installation en production. Activez nginx si vous avez besoin d'un proxy avec `EL_INSTALL_NGINX` a -True. Redirigez votre DNS vers l'adresse IP du proxy et ajoutez vos enregistrements A et AAAA dans `EL_WEBSITE_NAME` separes par des espaces. +Modifiez le fichier env_var.sh pour l'installation en production. Activez nginx si vous avez besoin d'un proxy avec `EL_INSTALL_NGINX` à +True. Redirigez votre DNS vers l'adresse IP du proxy et ajoutez vos enregistrements A et AAAA dans `EL_WEBSITE_NAME` séparés par des espaces. -### 3. Executer les scripts : +### 3. Exécuter les scripts : #### Avec le proxy nginx en production, installer certbot avant pour le SSL @@ -85,7 +85,7 @@ A service is running by SystemD. You can access it with the DNS name found in `e Apply fix libpng12-0: https://www.linuxuprising.com/2018/05/fix-libpng12-0-missing-in-ubuntu-1804.html -Un service est en cours d'execution via SystemD. Vous pouvez y acceder avec le nom DNS trouve dans `env_var.sh` +Un service est en cours d'exécution via SystemD. Vous pouvez y accéder avec le nom DNS trouvé dans `env_var.sh` #### Serveur Ubuntu 20.04 @@ -105,11 +105,11 @@ A service is running by SystemD, you can access it with the DNS name found in `e Generate a ssl certificate -Un service est en cours d'execution via SystemD, vous pouvez y acceder avec le nom DNS trouve dans `env_var.sh` +Un service est en cours d'exécution via SystemD, vous pouvez y accéder avec le nom DNS trouvé dans `env_var.sh` ### 4. SSL : -Generer un certificat SSL +Générer un certificat SSL ```bash @@ -133,7 +133,7 @@ sudo systemctl -feu [EL_USER] Comment the following line in `/[EL_USER]/erplibre/config.conf` -## Executer par adresse IP +## Exécuter par adresse IP Commentez la ligne suivante dans `/[EL_USER]/erplibre/config.conf` @@ -151,7 +151,7 @@ Restart daemon: Ajoutez votre adresse IP comme server_name dans la configuration nginx `/etc/nginx/sites-available/[EL_WEBSITE_NAME]` -Redemarrer le daemon : +Redémarrer le daemon : ```bash @@ -163,7 +163,7 @@ sudo systemctl restart [EL_USER] ## Production execution -## Execution en production +## Exécution en production ```bash @@ -181,12 +181,12 @@ database. WARNING, this is not safe for production, you will expose all data. 1. Run -## Deplacer la base de donnees de production vers le developpement +## Déplacer la base de données de production vers le développement -Lorsque vous deplacez une base de donnees de production vers votre environnement de developpement, vous souhaitez supprimer les serveurs de messagerie et installer un utilisateur de test pour tester la base de donnees. ATTENTION, ceci n'est pas securitaire pour la production, vous exposerez toutes les donnees. +Lorsque vous déplacez une base de données de production vers votre environnement de développement, vous souhaitez supprimer les serveurs de messagerie et installer un utilisateur de test pour tester la base de données. ATTENTION, ceci n'est pas sécuritaire pour la production, vous exposerez toutes les données. -1. Copiez votre image de base de donnees dans le repertoire image_db, par exemple le nom de l'image est `my_db.zip` -1. Executez +1. Copiez votre image de base de données dans le répertoire image_db, par exemple le nom de l'image est `my_db.zip` +1. Exécutez ```bash @@ -200,9 +200,9 @@ Lorsque vous deplacez une base de donnees de production vers votre environnement Update all features. -## Mise a jour de la production +## Mise à jour de la production -Mettre a jour toutes les fonctionnalites. +Mettre à jour toutes les fonctionnalités. ```bash @@ -228,12 +228,12 @@ CAUTION, this will delete user's home, it's irrevocable. Pour afficher les fichiers de configuration : > psql -U postgres -c 'SHOW config_file' -Editez ce fichier pour accepter les interfaces de tous les reseaux : +Éditez ce fichier pour accepter les interfaces de tous les réseaux : > /var/lib/postgres/data/postgresql.conf # Supprimer une instance en production -ATTENTION, ceci supprimera le repertoire personnel de l'utilisateur, c'est irrevocable. +ATTENTION, ceci supprimera le répertoire personnel de l'utilisateur, c'est irrévocable. ```bash @@ -246,9 +246,9 @@ ATTENTION, ceci supprimera le repertoire personnel de l'utilisateur, c'est irrev First you need a valid python3 interpreter running with cloudflare module installed: (make sure your pip3 pointing the right python3) -# Mettre a jour l'IP lorsque l'IP publique change avec CloudFlare et crontab +# Mettre à jour l'IP lorsque l'IP publique change avec CloudFlare et crontab -Vous avez d'abord besoin d'un interpreteur python3 valide avec le module cloudflare installe : (assurez-vous que votre pip3 pointe vers le bon python3) +Vous avez d'abord besoin d'un interpréteur python3 valide avec le module cloudflare installé : (assurez-vous que votre pip3 pointe vers le bon python3) ```bash @@ -259,7 +259,7 @@ pip3 install cloudflare==2.20.0 Then you need to create the cfg files with credentials for your cloudflare account. -Ensuite, vous devez creer les fichiers cfg avec les identifiants de votre compte cloudflare. +Ensuite, vous devez créer les fichiers cfg avec les identifiants de votre compte cloudflare. ```bash @@ -270,7 +270,7 @@ mkdir ~/.cloudflare Edit ~/.cloudflare/cloudflare.cfg -Editez ~/.cloudflare/cloudflare.cfg +Éditez ~/.cloudflare/cloudflare.cfg ``` @@ -292,16 +292,16 @@ Notes: - For each crontab run, if public IP did not change compared to what is on cloudflare, the script will not do unnecessary changes and let everything as is. -Ajoutez votre cron et specifiez le python3 que vous souhaitez utiliser. -- USER est l'utilisateur local avec les permissions pour executer le script -- PATH est le chemin vers l'interieur du dossier ERPLibre/deployment/ +Ajoutez votre cron et spécifiez le python3 que vous souhaitez utiliser. +- USER est l'utilisateur local avec les permissions pour exécuter le script +- PATH est le chemin vers l'intérieur du dossier ERPLibre/deployment/ - PROFILE_NAME doit correspondre au PROFILE_NAME dans cloudflare.cfg - CLOUDFLARE_ZONE_NAME est le nom de la zone du site web sur cloudflare - DNS_NAME est le nom d'un enregistrement DNS A disponible sur cette zone Notes : -- Un seul crontab est necessaire car le script recherchera automatiquement toutes les zones disponibles avec une IP obsolete et les mettra a jour sur tous les enregistrements A. -- A chaque execution du crontab, si l'IP publique n'a pas change par rapport a ce qui est sur cloudflare, le script ne fera pas de changements inutiles et laissera tout en l'etat. +- Un seul crontab est nécessaire car le script recherchera automatiquement toutes les zones disponibles avec une IP obsolète et les mettra à jour sur tous les enregistrements A. +- À chaque exécution du crontab, si l'IP publique n'a pas changé par rapport à ce qui est sur cloudflare, le script ne fera pas de changements inutiles et laissera tout en l'état. ```bash @@ -314,7 +314,7 @@ vim /etc/crontab Check log with -Verifier les journaux avec +Vérifier les journaux avec ```bash @@ -325,7 +325,7 @@ sudo journalctl -feu cron If you want to log what is happening and when the script is run, like logging when ip changes, you can add a logging part to your cron -Si vous souhaitez journaliser ce qui se passe et quand le script est execute, comme la journalisation des changements d'IP, vous pouvez ajouter une partie de journalisation a votre cron +Si vous souhaitez journaliser ce qui se passe et quand le script est exécuté, comme la journalisation des changements d'IP, vous pouvez ajouter une partie de journalisation à votre cron ```bash @@ -339,7 +339,7 @@ vim /etc/crontab You can then read all logs with this command (Need to have ts installed: sudo apt install moreutils) -Vous pouvez ensuite lire tous les journaux avec cette commande (Necessite l'installation de ts : sudo apt install moreutils) +Vous pouvez ensuite lire tous les journaux avec cette commande (Nécessite l'installation de ts : sudo apt install moreutils) ```bash @@ -358,11 +358,11 @@ Run script to update configuration : # Docker -## Mise a jour +## Mise à jour -Lors de la mise a jour d'un docker, vous devez mettre a jour la liste des modules. +Lors de la mise à jour d'un docker, vous devez mettre à jour la liste des modules. -Executez le script pour mettre a jour la configuration : +Exécutez le script pour mettre à jour la configuration : ```bash @@ -373,7 +373,7 @@ Executez le script pour mettre a jour la configuration : Edit the docker-compose.yml and update the command line (change DATABASE) to : -Editez le docker-compose.yml et mettez a jour la ligne de commande (changez DATABASE) pour : +Éditez le docker-compose.yml et mettez à jour la ligne de commande (changez DATABASE) pour : ```yaml @@ -388,7 +388,7 @@ Restart the docker : Note, l'objectif est d'appeler `env['ir.module.module'].update_list()`. -Redemarrez le docker : +Redémarrez le docker : ```bash @@ -402,9 +402,9 @@ Revert the command in docker-compose.yml. You can validate in log the update, you need to find `odoo.modules.loading: updating modules list`, check -Revertez la commande dans docker-compose.yml. +Annulez la commande dans docker-compose.yml. -Vous pouvez valider la mise a jour dans les journaux, vous devez trouver `odoo.modules.loading: updating modules list`, verifiez +Vous pouvez valider la mise à jour dans les journaux, vous devez trouver `odoo.modules.loading: updating modules list`, vérifiez ```bash @@ -419,11 +419,11 @@ Do a backup on url https://HOST/web/database/manager Edit the docker-compose.yml and update the command line (change DATABASE) to : -## Tout mettre a jour +## Tout mettre à jour -Faites une sauvegarde a l'URL https://HOST/web/database/manager +Faites une sauvegarde à l'URL https://HOST/web/database/manager -Editez le docker-compose.yml et mettez a jour la ligne de commande (changez DATABASE) pour : +Éditez le docker-compose.yml et mettez à jour la ligne de commande (changez DATABASE) pour : ```yaml @@ -434,7 +434,7 @@ Editez le docker-compose.yml et mettez a jour la ligne de commande (changez DATA Watch log to see error, if you got error, you need to do some code to migrate your data, depend the case. -Surveillez les journaux pour voir les erreurs, si vous obtenez une erreur, vous devez ecrire du code pour migrer vos donnees, selon le cas. +Surveillez les journaux pour voir les erreurs, si vous obtenez une erreur, vous devez écrire du code pour migrer vos données, selon le cas. ```bash diff --git a/doc/PRODUCTION.fr.md b/doc/PRODUCTION.fr.md index 67bb1d2..0740652 100644 --- a/doc/PRODUCTION.fr.md +++ b/doc/PRODUCTION.fr.md @@ -14,12 +14,12 @@ git clone https://github.com/ERPLibre/ERPLibre.git cd ERPLibre ``` -### 2. Modifier les parametres +### 2. Modifier les paramètres -Modifiez le fichier env_var.sh pour l'installation en production. Activez nginx si vous avez besoin d'un proxy avec `EL_INSTALL_NGINX` a -True. Redirigez votre DNS vers l'adresse IP du proxy et ajoutez vos enregistrements A et AAAA dans `EL_WEBSITE_NAME` separes par des espaces. +Modifiez le fichier env_var.sh pour l'installation en production. Activez nginx si vous avez besoin d'un proxy avec `EL_INSTALL_NGINX` à +True. Redirigez votre DNS vers l'adresse IP du proxy et ajoutez vos enregistrements A et AAAA dans `EL_WEBSITE_NAME` séparés par des espaces. -### 3. Executer les scripts : +### 3. Exécuter les scripts : #### Avec le proxy nginx en production, installer certbot avant pour le SSL @@ -43,7 +43,7 @@ sudo ln -s /snap/bin/certbot /usr/bin/certbot ./script/install/install_production.sh ``` -Un service est en cours d'execution via SystemD. Vous pouvez y acceder avec le nom DNS trouve dans `env_var.sh` +Un service est en cours d'exécution via SystemD. Vous pouvez y accéder avec le nom DNS trouvé dans `env_var.sh` #### Serveur Ubuntu 20.04 @@ -54,11 +54,11 @@ Appliquer le correctif libpng12-0 : https://www.linuxuprising.com/2018/05/fix-li ./script/install/install_production.sh ``` -Un service est en cours d'execution via SystemD, vous pouvez y acceder avec le nom DNS trouve dans `env_var.sh` +Un service est en cours d'exécution via SystemD, vous pouvez y accéder avec le nom DNS trouvé dans `env_var.sh` ### 4. SSL : -Generer un certificat SSL +Générer un certificat SSL ```bash sudo certbot --nginx @@ -70,7 +70,7 @@ sudo certbot --nginx sudo systemctl -feu [EL_USER] ``` -## Executer par adresse IP +## Exécuter par adresse IP Commentez la ligne suivante dans `/[EL_USER]/erplibre/config.conf` @@ -81,35 +81,35 @@ proxy_mode = True Ajoutez votre adresse IP comme server_name dans la configuration nginx `/etc/nginx/sites-available/[EL_WEBSITE_NAME]` -Redemarrer le daemon : +Redémarrer le daemon : ```bash sudo systemctl restart nginx sudo systemctl restart [EL_USER] ``` -## Execution en production +## Exécution en production ```bash cd /[EL_USER]/erplibre ./run.sh -d [DATABASE] --no-database-list ``` -## Deplacer la base de donnees de production vers le developpement +## Déplacer la base de données de production vers le développement -Lorsque vous deplacez une base de donnees de production vers votre environnement de developpement, vous souhaitez supprimer les serveurs de messagerie et installer un utilisateur de test pour tester la base de donnees. ATTENTION, ceci n'est pas securitaire pour la production, vous exposerez toutes les donnees. +Lorsque vous déplacez une base de données de production vers votre environnement de développement, vous souhaitez supprimer les serveurs de messagerie et installer un utilisateur de test pour tester la base de données. ATTENTION, ceci n'est pas sécuritaire pour la production, vous exposerez toutes les données. -1. Copiez votre image de base de donnees dans le repertoire image_db, par exemple le nom de l'image est `my_db.zip` -1. Executez +1. Copiez votre image de base de données dans le répertoire image_db, par exemple le nom de l'image est `my_db.zip` +1. Exécutez ```bash ./script/database/db_restore.py --clean_cache --database test_my_db --image my_db ./script/addons/update_prod_to_dev.sh test_my_db ``` -## Mise a jour de la production +## Mise à jour de la production -Mettre a jour toutes les fonctionnalites. +Mettre à jour toutes les fonctionnalités. ```bash ./run.sh --limit-time-real 99999 --no-http --stop-after-init -u all -d DATABASE @@ -120,32 +120,32 @@ Mettre a jour toutes les fonctionnalites. Pour afficher les fichiers de configuration : > psql -U postgres -c 'SHOW config_file' -Editez ce fichier pour accepter les interfaces de tous les reseaux : +Éditez ce fichier pour accepter les interfaces de tous les réseaux : > /var/lib/postgres/data/postgresql.conf # Supprimer une instance en production -ATTENTION, ceci supprimera le repertoire personnel de l'utilisateur, c'est irrevocable. +ATTENTION, ceci supprimera le répertoire personnel de l'utilisateur, c'est irrévocable. ```bash ./script/database/delete_production.sh ``` -# Mettre a jour l'IP lorsque l'IP publique change avec CloudFlare et crontab +# Mettre à jour l'IP lorsque l'IP publique change avec CloudFlare et crontab -Vous avez d'abord besoin d'un interpreteur python3 valide avec le module cloudflare installe : (assurez-vous que votre pip3 pointe vers le bon python3) +Vous avez d'abord besoin d'un interpréteur python3 valide avec le module cloudflare installé : (assurez-vous que votre pip3 pointe vers le bon python3) ```bash pip3 install cloudflare==2.20.0 ``` -Ensuite, vous devez creer les fichiers cfg avec les identifiants de votre compte cloudflare. +Ensuite, vous devez créer les fichiers cfg avec les identifiants de votre compte cloudflare. ```bash mkdir ~/.cloudflare ``` -Editez ~/.cloudflare/cloudflare.cfg +Éditez ~/.cloudflare/cloudflare.cfg ``` [PROFILE_NAME] @@ -153,16 +153,16 @@ email=EMAIL token=TOKEN (Use the global API key so that it works) ``` -Ajoutez votre cron et specifiez le python3 que vous souhaitez utiliser. -- USER est l'utilisateur local avec les permissions pour executer le script -- PATH est le chemin vers l'interieur du dossier ERPLibre/deployment/ +Ajoutez votre cron et spécifiez le python3 que vous souhaitez utiliser. +- USER est l'utilisateur local avec les permissions pour exécuter le script +- PATH est le chemin vers l'intérieur du dossier ERPLibre/deployment/ - PROFILE_NAME doit correspondre au PROFILE_NAME dans cloudflare.cfg - CLOUDFLARE_ZONE_NAME est le nom de la zone du site web sur cloudflare - DNS_NAME est le nom d'un enregistrement DNS A disponible sur cette zone Notes : -- Un seul crontab est necessaire car le script recherchera automatiquement toutes les zones disponibles avec une IP obsolete et les mettra a jour sur tous les enregistrements A. -- A chaque execution du crontab, si l'IP publique n'a pas change par rapport a ce qui est sur cloudflare, le script ne fera pas de changements inutiles et laissera tout en l'etat. +- Un seul crontab est nécessaire car le script recherchera automatiquement toutes les zones disponibles avec une IP obsolète et les mettra à jour sur tous les enregistrements A. +- À chaque exécution du crontab, si l'IP publique n'a pas changé par rapport à ce qui est sur cloudflare, le script ne fera pas de changements inutiles et laissera tout en l'état. ```bash vim /etc/crontab @@ -170,13 +170,13 @@ vim /etc/crontab */5 * * * * USER cd PATH && python3 script/deployment/update_dns_cloudflare.py --profile PROFILE_NAME --zone_name CLOUDFLARE_ZONE_NAME --dns_name DNS_NAME --auto_sync ``` -Verifier les journaux avec +Vérifier les journaux avec ```bash sudo journalctl -feu cron ``` -Si vous souhaitez journaliser ce qui se passe et quand le script est execute, comme la journalisation des changements d'IP, vous pouvez ajouter une partie de journalisation a votre cron +Si vous souhaitez journaliser ce qui se passe et quand le script est exécuté, comme la journalisation des changements d'IP, vous pouvez ajouter une partie de journalisation à votre cron ```bash vim /etc/crontab @@ -185,7 +185,7 @@ vim /etc/crontab ``` -Vous pouvez ensuite lire tous les journaux avec cette commande (Necessite l'installation de ts : sudo apt install moreutils) +Vous pouvez ensuite lire tous les journaux avec cette commande (Nécessite l'installation de ts : sudo apt install moreutils) ```bash tail -f /home/USER/logs/update_dns_ZONE_NAME.log | ts @@ -193,17 +193,17 @@ tail -f /home/USER/logs/update_dns_ZONE_NAME.log | ts # Docker -## Mise a jour +## Mise à jour -Lors de la mise a jour d'un docker, vous devez mettre a jour la liste des modules. +Lors de la mise à jour d'un docker, vous devez mettre à jour la liste des modules. -Executez le script pour mettre a jour la configuration : +Exécutez le script pour mettre à jour la configuration : ```bash ./script/docker/docker_gen_config.sh ``` -Editez le docker-compose.yml et mettez a jour la ligne de commande (changez DATABASE) pour : +Éditez le docker-compose.yml et mettez à jour la ligne de commande (changez DATABASE) pour : ```yaml command: odoo --workers 2 -u erplibre_info -d DATABASE @@ -211,32 +211,32 @@ Editez le docker-compose.yml et mettez a jour la ligne de commande (changez DATA Note, l'objectif est d'appeler `env['ir.module.module'].update_list()`. -Redemarrez le docker : +Redémarrez le docker : ```bash docker compose down docker compose up -d ``` -Revertez la commande dans docker-compose.yml. +Annulez la commande dans docker-compose.yml. -Vous pouvez valider la mise a jour dans les journaux, vous devez trouver `odoo.modules.loading: updating modules list`, verifiez +Vous pouvez valider la mise à jour dans les journaux, vous devez trouver `odoo.modules.loading: updating modules list`, vérifiez ```bash docker compose logs -f ``` -## Tout mettre a jour +## Tout mettre à jour -Faites une sauvegarde a l'URL https://HOST/web/database/manager +Faites une sauvegarde à l'URL https://HOST/web/database/manager -Editez le docker-compose.yml et mettez a jour la ligne de commande (changez DATABASE) pour : +Éditez le docker-compose.yml et mettez à jour la ligne de commande (changez DATABASE) pour : ```yaml command: odoo --workers 2 -u all -d DATABASE ``` -Surveillez les journaux pour voir les erreurs, si vous obtenez une erreur, vous devez ecrire du code pour migrer vos donnees, selon le cas. +Surveillez les journaux pour voir les erreurs, si vous obtenez une erreur, vous devez écrire du code pour migrer vos données, selon le cas. ```bash make docker_show_logs_live diff --git a/doc/RELEASE.base.md b/doc/RELEASE.base.md index f4be1de..4d1fabd 100644 --- a/doc/RELEASE.base.md +++ b/doc/RELEASE.base.md @@ -11,7 +11,7 @@ A guide on how to generate a release. # Publication -Un guide sur la generation d'une publication. +Un guide sur la génération d'une publication. ## Clean environment before generating new release @@ -19,9 +19,9 @@ Un guide sur la generation d'une publication. Before the cleaning, check if existing file isn't committed, not pushed or in stash. -## Nettoyer l'environnement avant de generer une nouvelle publication +## Nettoyer l'environnement avant de générer une nouvelle publication -Avant le nettoyage, verifiez si des fichiers existants ne sont pas commites, pousses ou dans le stash. +Avant le nettoyage, vérifiez si des fichiers existants ne sont pas commités, poussés ou dans le stash. ```bash @@ -33,7 +33,7 @@ Avant le nettoyage, verifiez si des fichiers existants ne sont pas commites, pou This will erase everything in addons. Useful before creating docker, manifest and do a release. -Ceci effacera tout dans les addons. Utile avant de creer un docker, un manifeste et de faire une publication. +Ceci effacera tout dans les addons. Utile avant de créer un docker, un manifeste et de faire une publication. ```bash @@ -46,9 +46,9 @@ And update all from dev to merge into prod. Test all supported Odoo version : -Et mettre a jour tout depuis dev pour fusionner dans prod. +Et mettre à jour tout depuis dev pour fusionner dans prod. -Tester toutes les versions Odoo supportees : +Tester toutes les versions Odoo supportées : ```bash @@ -64,8 +64,8 @@ make install_odoo_all_version ## Valider l'environnement -- Verifier si chaque version de manifeste comme [manifest/default.dev.odoo16.0.xml](../manifest/default.dev.odoo16.0.xml) est prete pour la production. -- Executer les tests : +- Vérifier si chaque version de manifeste comme [manifest/default.dev.odoo16.0.xml](../manifest/default.dev.odoo16.0.xml) est prête pour la production. +- Exécuter les tests : ```bash @@ -80,7 +80,7 @@ To format all code, run: ### Formater le code -Pour formater tout le code, executez : +Pour formater tout le code, exécutez : ```bash @@ -93,9 +93,9 @@ make format To generate Markdown in directory `./doc`, run: -### Mettre a jour les documentations +### Mettre à jour les documentations -Pour generer le Markdown dans le repertoire `./doc`, executez : +Pour générer le Markdown dans le répertoire `./doc`, exécutez : ```bash @@ -108,9 +108,9 @@ make doc_markdown To generate a docker, run: -### Tester la generation docker +### Tester la génération docker -Pour generer un docker, executez : +Pour générer un docker, exécutez : ```bash @@ -138,9 +138,9 @@ Replace if need it to new version. Update file `./pyproject.toml` in [tool.poetry], line `version =`. -Remplacer si necessaire par la nouvelle version. +Remplacer si nécessaire par la nouvelle version. -Mettre a jour le fichier `./pyproject.toml` dans [tool.poetry], ligne `version =`. +Mettre à jour le fichier `./pyproject.toml` dans [tool.poetry], ligne `version =`. ### Test production Ubuntu environment @@ -154,7 +154,7 @@ Test installation with code generator Geomap: Suivre les instructions dans [PRODUCTION.md](./PRODUCTION.md). -Tester l'installation avec le generateur de code Geomap : +Tester l'installation avec le générateur de code Geomap : ```bash @@ -167,9 +167,9 @@ make addons_install_code_generator_full To generate database images in directory `./image_db`, run: -### Mettre a jour image_db +### Mettre à jour image_db -Pour generer les images de base de donnees dans le repertoire `./image_db`, executez : +Pour générer les images de base de données dans le répertoire `./image_db`, exécutez : ```bash @@ -196,9 +196,9 @@ Pour le tester, vous devez nettoyer les caches et l'installer : Generate production manifest and freeze all repos versions. -## Generer la nouvelle production et publication +## Générer la nouvelle production et publication -Generer le manifeste de production et geler toutes les versions des depots. +Générer le manifeste de production et geler toutes les versions des dépôts. ```bash @@ -212,10 +212,10 @@ and [docker-compose](../docker-compose.yml). Generate [poetry](./POETRY.md) and keep only missing dependencies, remove updates. -Mettre a jour la variable ERPLIBRE_VERSION dans [env_var.sh](../env_var.sh), [Dockerfile.prod](../docker/Dockerfile.prod.pkg) +Mettre à jour la variable ERPLIBRE_VERSION dans [env_var.sh](../env_var.sh), [Dockerfile.prod](../docker/Dockerfile.prod.pkg) et [docker-compose](../docker-compose.yml). -Generer [poetry](./POETRY.md) et garder uniquement les dependances manquantes, retirer les mises a jour. +Générer [poetry](./POETRY.md) et garder uniquement les dépendances manquantes, retirer les mises à jour. ```bash @@ -227,7 +227,7 @@ When running script ./script/poetry/poetry_update.py, note manually inserted dep manually. -Lors de l'execution du script ./script/poetry/poetry_update.py, noter les dependances inserees manuellement, stasher tous les changements et les ajouter +Lors de l'exécution du script ./script/poetry/poetry_update.py, noter les dépendances insérées manuellement, stasher tous les changements et les ajouter manuellement. @@ -239,7 +239,7 @@ poetry add DEPENDENCY Understand differences from last release: -Comprendre les differences depuis la derniere publication : +Comprendre les différences depuis la dernière publication : ```bash @@ -273,9 +273,9 @@ Update file [CHANGELOG.md](../CHANGELOG.md) and create a section with new versio Create a branch release/#.#.# and create a pull request to branch master with your commit: -Mettre a jour le fichier [CHANGELOG.md](../CHANGELOG.md) et creer une section avec la nouvelle version, utiliser la commande suivante pour lire tous les changements. +Mettre à jour le fichier [CHANGELOG.md](../CHANGELOG.md) et créer une section avec la nouvelle version, utiliser la commande suivante pour lire tous les changements. -Creer une branche release/#.#.# et creer une demande de fusion vers la branche master avec votre commit : +Créer une branche release/#.#.# et créer une demande de fusion vers la branche master avec votre commit : ```bash @@ -286,7 +286,7 @@ git commit -am "Release v#.#.#" Review by your peers, test the docker file and **merge to master**. -Faire reviser par vos pairs, tester le fichier docker et **fusionner dans master**. +Faire réviser par vos pairs, tester le fichier docker et **fusionner dans master**. ```bash @@ -306,9 +306,9 @@ Ajouter le commentaire `Release v#.#.#`. Add a tag on the commit in branch master with your release. When adding tag, be sure to update default.xml -## Creer le tag +## Créer le tag -Ajouter un tag sur le commit dans la branche master avec votre publication. Lors de l'ajout du tag, assurez-vous de mettre a jour default.xml +Ajouter un tag sur le commit dans la branche master avec votre publication. Lors de l'ajout du tag, assurez-vous de mettre à jour default.xml ```bash @@ -335,9 +335,9 @@ You need to push your docker image and update your tag, like 1.0.1: > docker push technolibre/erplibre:VERSION -## Generer et pousser le docker +## Générer et pousser le docker -Important de generer le conteneur apres avoir pousse les tags git, sinon la version git sera incorrecte. +Important de générer le conteneur après avoir poussé les tags git, sinon la version git sera incorrecte. Lors de la construction de votre docker avec le script > make docker_build_release @@ -345,7 +345,7 @@ Lors de la construction de votre docker avec le script Lister votre version docker > docker images -Vous devez pousser votre image docker et mettre a jour votre tag, comme 1.0.1 : +Vous devez pousser votre image docker et mettre à jour votre tag, comme 1.0.1 : > docker push technolibre/erplibre:VERSION @@ -357,7 +357,7 @@ CHANGELOG.md. ## Faire une publication sur github -Visiter `https://github.com/ERPLibre/ERPLibre/releases/new` et creer une publication nommee `v#.#.#` et copier les informations depuis +Visiter `https://github.com/ERPLibre/ERPLibre/releases/new` et créer une publication nommée `v#.#.#` et copier les informations depuis CHANGELOG.md. @@ -370,9 +370,9 @@ To generate a list of differences between repo git commit # ASTUCES -## Comparer les differences de depots avec un autre projet ERPLibre +## Comparer les différences de dépôts avec un autre projet ERPLibre -Pour generer une liste de differences entre les commits git des depots +Pour générer une liste de différences entre les commits git des dépôts ```bash @@ -383,7 +383,7 @@ Pour generer une liste de differences entre les commits git des depots ## Semantic versioning -## Versionnage semantique +## Versionnage sémantique ``` diff --git a/doc/RELEASE.fr.md b/doc/RELEASE.fr.md index 1dd7b57..b8d27fc 100644 --- a/doc/RELEASE.fr.md +++ b/doc/RELEASE.fr.md @@ -1,26 +1,26 @@ # Publication -Un guide sur la generation d'une publication. +Un guide sur la génération d'une publication. -## Nettoyer l'environnement avant de generer une nouvelle publication +## Nettoyer l'environnement avant de générer une nouvelle publication -Avant le nettoyage, verifiez si des fichiers existants ne sont pas commites, pousses ou dans le stash. +Avant le nettoyage, vérifiez si des fichiers existants ne sont pas commités, poussés ou dans le stash. ```bash .venv.erplibre/bin/repo forall -pc "git stash list" ./script/git/git_show_code_diff_repo_manifest.py ``` -Ceci effacera tout dans les addons. Utile avant de creer un docker, un manifeste et de faire une publication. +Ceci effacera tout dans les addons. Utile avant de créer un docker, un manifeste et de faire une publication. ```bash ./script/git/clean_repo_manifest.sh ``` -Et mettre a jour tout depuis dev pour fusionner dans prod. +Et mettre à jour tout depuis dev pour fusionner dans prod. -Tester toutes les versions Odoo supportees : +Tester toutes les versions Odoo supportées : ```bash make install_odoo_all_version @@ -28,8 +28,8 @@ make install_odoo_all_version ## Valider l'environnement -- Verifier si chaque version de manifeste comme [manifest/default.dev.odoo16.0.xml](../manifest/default.dev.odoo16.0.xml) est prete pour la production. -- Executer les tests : +- Vérifier si chaque version de manifeste comme [manifest/default.dev.odoo16.0.xml](../manifest/default.dev.odoo16.0.xml) est prête pour la production. +- Exécuter les tests : ```bash make test_full_fast @@ -37,23 +37,23 @@ make test_full_fast ### Formater le code -Pour formater tout le code, executez : +Pour formater tout le code, exécutez : ```bash make format ``` -### Mettre a jour les documentations +### Mettre à jour les documentations -Pour generer le Markdown dans le repertoire `./doc`, executez : +Pour générer le Markdown dans le répertoire `./doc`, exécutez : ```bash make doc_markdown ``` -### Tester la generation docker +### Tester la génération docker -Pour generer un docker, executez : +Pour générer un docker, exécutez : ```bash make docker_build_odoo_18 @@ -67,23 +67,23 @@ Rechercher l'ancienne version, comme : grep --color=always --exclude-dir={.repo,.venv,.git} --exclude="*.svg" -nri v1.6.0 ``` -Remplacer si necessaire par la nouvelle version. +Remplacer si nécessaire par la nouvelle version. -Mettre a jour le fichier `./pyproject.toml` dans [tool.poetry], ligne `version =`. +Mettre à jour le fichier `./pyproject.toml` dans [tool.poetry], ligne `version =`. ### Tester l'environnement de production Ubuntu Suivre les instructions dans [PRODUCTION.md](./PRODUCTION.md). -Tester l'installation avec le generateur de code Geomap : +Tester l'installation avec le générateur de code Geomap : ```bash make addons_install_code_generator_full ``` -### Mettre a jour image_db +### Mettre à jour image_db -Pour generer les images de base de donnees dans le repertoire `./image_db`, executez : +Pour générer les images de base de données dans le répertoire `./image_db`, exécutez : ```bash make db_clean_cache @@ -98,31 +98,31 @@ Pour le tester, vous devez nettoyer les caches et l'installer : ./script/database/db_restore.py --database test --image erplibre_website ``` -## Generer la nouvelle production et publication +## Générer la nouvelle production et publication -Generer le manifeste de production et geler toutes les versions des depots. +Générer le manifeste de production et geler toutes les versions des dépôts. ```bash .venv.erplibre/bin/repo manifest -r -o ./default.xml ``` -Mettre a jour la variable ERPLIBRE_VERSION dans [env_var.sh](../env_var.sh), [Dockerfile.prod](../docker/Dockerfile.prod.pkg) +Mettre à jour la variable ERPLIBRE_VERSION dans [env_var.sh](../env_var.sh), [Dockerfile.prod](../docker/Dockerfile.prod.pkg) et [docker-compose](../docker-compose.yml). -Generer [poetry](./POETRY.md) et garder uniquement les dependances manquantes, retirer les mises a jour. +Générer [poetry](./POETRY.md) et garder uniquement les dépendances manquantes, retirer les mises à jour. ```bash ./script/poetry/poetry_update.py ``` -Lors de l'execution du script ./script/poetry/poetry_update.py, noter les dependances inserees manuellement, stasher tous les changements et les ajouter +Lors de l'exécution du script ./script/poetry/poetry_update.py, noter les dépendances insérées manuellement, stasher tous les changements et les ajouter manuellement. ```bash poetry add DEPENDENCY ``` -Comprendre les differences depuis la derniere publication : +Comprendre les différences depuis la dernière publication : ```bash # Get all differences between the last tag and HEAD, to update the CHANGELOG.md @@ -144,15 +144,15 @@ make repo_diff_stat_from_last_version make repo_diff_from_last_version ``` -Mettre a jour le fichier [CHANGELOG.md](../CHANGELOG.md) et creer une section avec la nouvelle version, utiliser la commande suivante pour lire tous les changements. +Mettre à jour le fichier [CHANGELOG.md](../CHANGELOG.md) et créer une section avec la nouvelle version, utiliser la commande suivante pour lire tous les changements. -Creer une branche release/#.#.# et creer une demande de fusion vers la branche master avec votre commit : +Créer une branche release/#.#.# et créer une demande de fusion vers la branche master avec votre commit : ```bash git commit -am "Release v#.#.#" ``` -Faire reviser par vos pairs, tester le fichier docker et **fusionner dans master**. +Faire réviser par vos pairs, tester le fichier docker et **fusionner dans master**. ```bash git checkout master @@ -161,9 +161,9 @@ git merge --no-ff RELEASE_BRANCH Ajouter le commentaire `Release v#.#.#`. -## Creer le tag +## Créer le tag -Ajouter un tag sur le commit dans la branche master avec votre publication. Lors de l'ajout du tag, assurez-vous de mettre a jour default.xml +Ajouter un tag sur le commit dans la branche master avec votre publication. Lors de l'ajout du tag, assurez-vous de mettre à jour default.xml ```bash git tag v#.#.# @@ -174,9 +174,9 @@ git push --tags make tag_push_all ``` -## Generer et pousser le docker +## Générer et pousser le docker -Important de generer le conteneur apres avoir pousse les tags git, sinon la version git sera incorrecte. +Important de générer le conteneur après avoir poussé les tags git, sinon la version git sera incorrecte. Lors de la construction de votre docker avec le script > make docker_build_release @@ -184,25 +184,25 @@ Lors de la construction de votre docker avec le script Lister votre version docker > docker images -Vous devez pousser votre image docker et mettre a jour votre tag, comme 1.0.1 : +Vous devez pousser votre image docker et mettre à jour votre tag, comme 1.0.1 : > docker push technolibre/erplibre:VERSION ## Faire une publication sur github -Visiter `https://github.com/ERPLibre/ERPLibre/releases/new` et creer une publication nommee `v#.#.#` et copier les informations depuis +Visiter `https://github.com/ERPLibre/ERPLibre/releases/new` et créer une publication nommée `v#.#.#` et copier les informations depuis CHANGELOG.md. # ASTUCES -## Comparer les differences de depots avec un autre projet ERPLibre +## Comparer les différences de dépôts avec un autre projet ERPLibre -Pour generer une liste de differences entre les commits git des depots +Pour générer une liste de différences entre les commits git des dépôts ```bash ./script/git/git_change_remote.py --sync_to /path/to/directory ``` -## Versionnage semantique +## Versionnage sémantique ``` ::= "-" "+" diff --git a/doc/WINDOWS_INSTALLATION.base.md b/doc/WINDOWS_INSTALLATION.base.md index 2226202..8c8f054 100644 --- a/doc/WINDOWS_INSTALLATION.base.md +++ b/doc/WINDOWS_INSTALLATION.base.md @@ -17,17 +17,17 @@ A guide on how to set up a workspace and run ERPLibre on Windows 10 version 2004 Run Powershell with administrator rights and run the following command: -# Windows 10 version 2004 et plus ou 11 - publication et developpement +# Windows 10 version 2004 et plus ou 11 - publication et développement -Un guide pour configurer un espace de travail et executer ERPLibre sur Windows 10 version 2004 et plus ou Windows 11. Il existe deux methodes d'installation, une automatique et l'autre manuelle. +Un guide pour configurer un espace de travail et exécuter ERPLibre sur Windows 10 version 2004 et plus ou Windows 11. Il existe deux méthodes d'installation, une automatique et l'autre manuelle. -**"WSL2 Ubuntu 22.04" sera designe par "WSL2"** +**"WSL2 Ubuntu 22.04" sera désigné par "WSL2"** -**"PyCharm Professional" sera designe par "PyCharm"** +**"PyCharm Professional" sera désigné par "PyCharm"** ## Installer WSL2 -Executez Powershell avec les droits administrateur et lancez la commande suivante : +Exécutez Powershell avec les droits administrateur et lancez la commande suivante : ```bash @@ -38,7 +38,7 @@ wsl --install -d Ubuntu-22.04 If you have trouble opening the Powershell with administrator rights, press `Windows + R`, enter the following line and press `OK`. You will be automatically prompted for administrator rights. -Si vous avez des difficultes a ouvrir Powershell avec les droits administrateur, appuyez sur `Windows + R`, entrez la ligne suivante et appuyez sur `OK`. Les droits administrateur vous seront automatiquement demandes. +Si vous avez des difficultés à ouvrir Powershell avec les droits administrateur, appuyez sur `Windows + R`, entrez la ligne suivante et appuyez sur `OK`. Les droits administrateur vous seront automatiquement demandés. ```bash @@ -52,8 +52,8 @@ If you have issues enable virtualization options in BIOS is available (hyper-v, You can also try theses powershell commands: -### Depannage - Optionnel -Si vous rencontrez des problemes, activez les options de virtualisation dans le BIOS si disponibles (hyper-v, vt-x, etc). Recherchez `Activer ou desactiver des fonctionnalites Windows` dans la barre de recherche Windows et assurez-vous que `Sous-systeme Windows pour Linux` est active avant de redemarrer votre machine. +### Dépannage - Optionnel +Si vous rencontrez des problèmes, activez les options de virtualisation dans le BIOS si disponibles (hyper-v, vt-x, etc). Recherchez `Activer ou désactiver des fonctionnalités Windows` dans la barre de recherche Windows et assurez-vous que `Sous-système Windows pour Linux` est activé avant de redémarrer votre machine. Vous pouvez aussi essayer ces commandes powershell : @@ -67,7 +67,7 @@ wsl --set-default-version 2 Download and install the lastest Linux kernel update package from Microsoft with the following [link](https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi): -Telechargez et installez le dernier package de mise a jour du noyau Linux de Microsoft avec le [lien](https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi) suivant : +Téléchargez et installez le dernier package de mise à jour du noyau Linux de Microsoft avec le [lien](https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi) suivant : ```bash @@ -78,7 +78,7 @@ https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi Only run this command as your last resort as it can break other virtual machines: -N'executez cette commande qu'en dernier recours car elle peut casser d'autres machines virtuelles : +N'exécutez cette commande qu'en dernier recours car elle peut casser d'autres machines virtuelles : ```bash @@ -91,9 +91,9 @@ bcdedit /set hypervisorlaunchtype auto Run Powershell with administrator rights and run the following command: -### Autres methodes d'installation pour WSL2 +### Autres méthodes d'installation pour WSL2 -Executez Powershell avec les droits administrateur et lancez la commande suivante : +Exécutez Powershell avec les droits administrateur et lancez la commande suivante : ```bash @@ -104,7 +104,7 @@ curl.exe -L -o ubuntu-2004.appx https://aka.ms/wslubuntu2004 Run Powershell with administrator rights and run the following commands: -Executez Powershell avec les droits administrateur et lancez les commandes suivantes : +Exécutez Powershell avec les droits administrateur et lancez les commandes suivantes : ```bash @@ -138,14 +138,14 @@ If you are using the Windows Terminal, you just have to click the little arrow n ## Configurer WSL2 pour ERPLibre -Une fois WSL2 installe correctement, redemarrez votre ordinateur. +Une fois WSL2 installé correctement, redémarrez votre ordinateur. -### Vous pouvez ouvrir votre Ubuntu de plusieurs facons : +### Vous pouvez ouvrir votre Ubuntu de plusieurs façons : * Recherchez "Ubuntu" en cliquant sur la touche Windows -* [Telechargez le Terminal Windows depuis le Microsoft Store](https://apps.microsoft.com/store/detail/windows-terminal/9N0DX20HK701) +* [Téléchargez le Terminal Windows depuis le Microsoft Store](https://apps.microsoft.com/store/detail/windows-terminal/9N0DX20HK701) -Si vous utilisez le Terminal Windows, vous n'avez qu'a cliquer sur la petite fleche a cote du signe + et vous verrez Ubuntu. +Si vous utilisez le Terminal Windows, vous n'avez qu'à cliquer sur la petite flèche à côté du signe + et vous verrez Ubuntu. ![image](https://user-images.githubusercontent.com/59217113/230186101-579d8a5b-0825-404f-bd28-3642adce0948.png) @@ -160,7 +160,7 @@ Si vous utilisez le Terminal Windows, vous n'avez qu'a cliquer sur la petite fle ### Configurer une interface graphique pour votre Ubuntu -1. Mettre a jour votre Ubuntu +1. Mettre à jour votre Ubuntu ```bash @@ -197,7 +197,7 @@ echo xfce4-session > ~/.xsession 4. Setup the Remote Desktop Connection -4. Configurer la connexion Bureau a distance +4. Configurer la connexion Bureau à distance ```bash @@ -220,7 +220,7 @@ exec /bin/sh /etc/X11/Xsession Add this line at the end of the file -Ajoutez cette ligne a la fin du fichier +Ajoutez cette ligne à la fin du fichier ```bash @@ -237,7 +237,7 @@ Open Ubuntu Terminal on your Windows and enter this command Quittez avec Ctrl+S, Ctrl+X -5. Demarrer l'interface graphique du bureau Ubuntu +5. Démarrer l'interface graphique du bureau Ubuntu Ouvrez le terminal Ubuntu sur votre Windows et entrez cette commande @@ -254,11 +254,11 @@ If WSL is taking too much memory, you can reduce with an easy step. You just have to go to *C:\Users\YourUsername\.wslconfig* and create a *.wslconfig* file and write: -Ensuite ouvrez *Connexion Bureau a distance* en cliquant sur la touche Windows et connectez-vous a *localhost:3390* +Ensuite ouvrez *Connexion Bureau à distance* en cliquant sur la touche Windows et connectez-vous à *localhost:3390* -### Memoire - Optionnel -Si WSL utilise trop de memoire, vous pouvez la reduire avec une etape simple. -Il suffit d'aller dans *C:\Users\VotreNomUtilisateur\.wslconfig* et de creer un fichier *.wslconfig* et d'ecrire : +### Mémoire - Optionnel +Si WSL utilise trop de mémoire, vous pouvez la réduire avec une étape simple. +Il suffit d'aller dans *C:\Users\VotreNomUtilisateur\.wslconfig* et de créer un fichier *.wslconfig* et d'écrire : ```bash @@ -272,7 +272,7 @@ memory=3GB ### Installation of the necessary and up-to-date tools -### Installation des outils necessaires et a jour +### Installation des outils nécessaires et à jour ```bash @@ -288,7 +288,7 @@ Make sure to be in the directory where you want to clone the project. ## Installation d'ERPLibre sous WSL2 -Assurez-vous d'etre dans le repertoire ou vous souhaitez cloner le projet. +Assurez-vous d'être dans le répertoire où vous souhaitez cloner le projet. ```bash @@ -301,7 +301,7 @@ make install Add role to PostgresSQL, change `USERNAME` field in the command with your UNIX username from your WSL2 environment. -Ajoutez un role a PostgreSQL, changez le champ `USERNAME` dans la commande avec votre nom d'utilisateur UNIX de votre environnement WSL2. +Ajoutez un rôle à PostgreSQL, changez le champ `USERNAME` dans la commande avec votre nom d'utilisateur UNIX de votre environnement WSL2. ```bash @@ -316,10 +316,10 @@ sudo su - postgres -c "createuser -s USERNAME" 2>/dev/null || true Ensure all dependencies are installed correctly. Re-run the following command to fix any broken dependencies: -## Problemes courants lors de l'installation +## Problèmes courants lors de l'installation ### Erreur lors de `make install` -Assurez-vous que toutes les dependances sont installees correctement. Relancez la commande suivante pour corriger les dependances cassees : +Assurez-vous que toutes les dépendances sont installées correctement. Relancez la commande suivante pour corriger les dépendances cassées : ```bash @@ -331,8 +331,8 @@ sudo apt-get install -f Check the PostgreSQL service status with the following command: -### PostgreSQL ne demarre pas -Verifiez le statut du service PostgreSQL avec la commande suivante : +### PostgreSQL ne démarre pas +Vérifiez le statut du service PostgreSQL avec la commande suivante : ```bash @@ -343,7 +343,7 @@ sudo service postgresql status If PostgreSQL is not running, try restarting it with: -Si PostgreSQL ne fonctionne pas, essayez de le redemarrer avec : +Si PostgreSQL ne fonctionne pas, essayez de le redémarrer avec : ```bash @@ -358,9 +358,9 @@ Everytime you restart your machine, the following command has to be executed to -## Executer ERPLibre +## Exécuter ERPLibre -A chaque redemarrage de votre machine, la commande suivante doit etre executee pour demarrer le service PostgreSQL s'il n'est pas deja en cours d'execution : +À chaque redémarrage de votre machine, la commande suivante doit être exécutée pour démarrer le service PostgreSQL s'il n'est pas déjà en cours d'exécution : ```bash @@ -371,7 +371,7 @@ sudo service postgresql start After that run this command in the root of the project: -Ensuite lancez cette commande a la racine du projet : +Ensuite lancez cette commande à la racine du projet : ```bash @@ -389,10 +389,10 @@ While ERPLibre is running, make sure that you can connect to the following URL ` Install PyCharm from the following [link](https://www.jetbrains.com/pycharm/download/#section=windows): -## Verification d'ERPLibre -Pendant qu'ERPLibre est en cours d'execution, assurez-vous que vous pouvez vous connecter a l'URL suivante `http://localhost:8069` et que vous avez la possibilite de creer, modifier et supprimer des bases de donnees. +## Vérification d'ERPLibre +Pendant qu'ERPLibre est en cours d'exécution, assurez-vous que vous pouvez vous connecter à l'URL suivante `http://localhost:8069` et que vous avez la possibilité de créer, modifier et supprimer des bases de données. -## Configurer l'environnement de developpement - PyCharm +## Configurer l'environnement de développement - PyCharm ### Installer PyCharm @@ -411,7 +411,7 @@ Select `Connect to WSL` under `Remote Development`. After that select your Ubunt ### Configurer Pycharm -Selectionnez `Connect to WSL` sous `Remote Development`. Ensuite selectionnez votre instance Ubuntu ("Ubuntu-22.04"). Pointez `Project directory` vers la racine du projet. Une fois que tout a ete selectionne et rempli correctement, cliquez sur `Start IDE and Connect`. +Sélectionnez `Connect to WSL` sous `Remote Development`. Ensuite sélectionnez votre instance Ubuntu ("Ubuntu-22.04"). Pointez `Project directory` vers la racine du projet. Une fois que tout a été sélectionné et rempli correctement, cliquez sur `Start IDE and Connect`. ![Welcome to PyCharm Wizard](image/remote_development.png) @@ -420,7 +420,7 @@ Selectionnez `Connect to WSL` sous `Remote Development`. Ensuite selectionnez vo Press `CTRL+ALT+S`, search for `interpreter` and inside the `Python Interpreter` page, click on `Add Interpreter` and select `Add Local Interpreter...`. -Appuyez sur `CTRL+ALT+S`, recherchez `interpreter` et dans la page `Python Interpreter`, cliquez sur `Add Interpreter` et selectionnez `Add Local Interpreter...`. +Appuyez sur `CTRL+ALT+S`, recherchez `interpreter` et dans la page `Python Interpreter`, cliquez sur `Add Interpreter` et sélectionnez `Add Local Interpreter...`. ![Interpreter Settings](image/add_local_interpreter.png) @@ -429,7 +429,7 @@ Appuyez sur `CTRL+ALT+S`, recherchez `interpreter` et dans la page `Python Inter Make sure to select `Virtualenv Environment` on the left and the `Existing` radio button. Once theses are both selected properly, point your interpreter to the `../ERPLibre/.venv/bin/python` directory of the project and click on `OK`. -Assurez-vous de selectionner `Virtualenv Environment` a gauche et le bouton radio `Existing`. Une fois les deux correctement selectionnes, pointez votre interpreteur vers le repertoire `../ERPLibre/.venv/bin/python` du projet et cliquez sur `OK`. +Assurez-vous de sélectionner `Virtualenv Environment` à gauche et le bouton radio `Existing`. Une fois les deux correctement sélectionnés, pointez votre interpréteur vers le répertoire `../ERPLibre/.venv/bin/python` du projet et cliquez sur `OK`. ![Environment Settings](image/existing_venv.png) @@ -443,12 +443,12 @@ If these last steps to set up your development environment were unsuccessful, fo You can delete the files that are left over in your home directory regarding the python installation when the steps have been completed succesfully. -Si ces dernieres etapes pour configurer votre environnement de developpement n'ont pas fonctionne, suivez les etapes "Manuelles" suivantes pour configurer votre environnement. +Si ces dernières étapes pour configurer votre environnement de développement n'ont pas fonctionné, suivez les étapes "Manuelles" suivantes pour configurer votre environnement. ## Installation manuelle ### Installer Python 3.10.14 -Vous pouvez supprimer les fichiers restants dans votre repertoire personnel concernant l'installation de Python une fois les etapes completees avec succes. +Vous pouvez supprimer les fichiers restants dans votre répertoire personnel concernant l'installation de Python une fois les étapes complétées avec succès. ```bash @@ -465,7 +465,7 @@ sudo make install ### Verify the installation -### Verifier l'installation +### Vérifier l'installation ```bash @@ -476,7 +476,7 @@ python3.10 ### Set Python 3.10.14 as default -### Definir Python 3.10.14 par defaut +### Définir Python 3.10.14 par défaut ```bash @@ -494,9 +494,9 @@ Press `CTRL+ALT+S`, search for `interpreter` and inside the `Python Interpreter` ### Configurer Pycharm -Ouvrez le repertoire du projet dans PyCharm. +Ouvrez le répertoire du projet dans PyCharm. -Appuyez sur `CTRL+ALT+S`, recherchez `interpreter` et dans la page `Python Interpreter`, cliquez sur `Add Interpreter` et selectionnez `On WSL...`. +Appuyez sur `CTRL+ALT+S`, recherchez `interpreter` et dans la page `Python Interpreter`, cliquez sur `Add Interpreter` et sélectionnez `On WSL...`. ![Interpreter Settings](image/on_wsl.png) @@ -505,7 +505,7 @@ Appuyez sur `CTRL+ALT+S`, recherchez `interpreter` et dans la page `Python Inter Wait until PyCharm detects your WSL2 instance and press `NEXT`. Click on `System Interpreter` on the left, select the correct interpreter if it hasn't done so automatically and click `Create`. -Attendez que PyCharm detecte votre instance WSL2 et appuyez sur `NEXT`. Cliquez sur `System Interpreter` a gauche, selectionnez le bon interpreteur s'il ne l'a pas fait automatiquement et cliquez sur `Create`. +Attendez que PyCharm détecte votre instance WSL2 et appuyez sur `NEXT`. Cliquez sur `System Interpreter` à gauche, sélectionnez le bon interpréteur s'il ne l'a pas fait automatiquement et cliquez sur `Create`. ![System Interpreter](image/system_python.png) @@ -520,13 +520,13 @@ Close the project's settings. Once PyCharm prompts you to import modules and all Search for `terminal` in the settings, and under `Application Settings` in the `Shell path:` field enter the following line: -Fermez les parametres du projet. Lorsque PyCharm vous propose d'importer des modules, autorisez-le. +Fermez les paramètres du projet. Lorsque PyCharm vous propose d'importer des modules, autorisez-le. -## Problemes courants avec le developpement Windows +## Problèmes courants avec le développement Windows -### Terminal casse +### Terminal cassé -Recherchez `terminal` dans les parametres, et sous `Application Settings` dans le champ `Shell path:` entrez la ligne suivante : +Recherchez `terminal` dans les paramètres, et sous `Application Settings` dans le champ `Shell path:` entrez la ligne suivante : ```bash @@ -547,15 +547,15 @@ PyCharm might not fully recognize some details from `requirements.txt` and `pypr If ERPLibre fails to run from PyCharm, execute the following command in the root directory of the project from the terminal in PyCharm or WSL2: -### Avertissements d'utilisation elevee de la memoire -Si vous constatez une utilisation elevee de la memoire, cliquez sur `Help` dans la barre d'outils et choisissez `Change Memory Settings` pour augmenter la memoire allouee a l'IDE. +### Avertissements d'utilisation élevée de la mémoire +Si vous constatez une utilisation élevée de la mémoire, cliquez sur `Help` dans la barre d'outils et choisissez `Change Memory Settings` pour augmenter la mémoire allouée à l'IDE. -### Modules importes manquants ou incorrects -PyCharm peut ne pas reconnaitre completement certains details de `requirements.txt` et `pyproject.toml` (par exemple, des versions specifiques de modules). Si vous rencontrez des problemes a l'execution ou lors du debogage, recherchez la bonne version du module et reinstallez-le avec le gestionnaire de paquets de PyCharm. +### Modules importés manquants ou incorrects +PyCharm peut ne pas reconnaître complètement certains détails de `requirements.txt` et `pyproject.toml` (par exemple, des versions spécifiques de modules). Si vous rencontrez des problèmes à l'exécution ou lors du débogage, recherchez la bonne version du module et réinstallez-le avec le gestionnaire de paquets de PyCharm. -### Impossible d'executer ERPLibre depuis PyCharm +### Impossible d'exécuter ERPLibre depuis PyCharm -Si ERPLibre ne se lance pas depuis PyCharm, executez la commande suivante dans le repertoire racine du projet depuis le terminal de PyCharm ou WSL2 : +Si ERPLibre ne se lance pas depuis PyCharm, exécutez la commande suivante dans le répertoire racine du projet depuis le terminal de PyCharm ou WSL2 : ```bash @@ -586,24 +586,24 @@ Instructions for setting up a graphical user interface (GUI) in WSL, which might Guide on how to manage and limit memory usage in WSL 2 to avoid high memory consumption issues. -### Impossible de redemarrer ERPLibre -Lancez `htop` depuis le terminal de PyCharm ou WSL2 et fermez les processus Python lies a ERPLibre pour liberer le socket. +### Impossible de redémarrer ERPLibre +Lancez `htop` depuis le terminal de PyCharm ou WSL2 et fermez les processus Python liés à ERPLibre pour libérer le socket. -## References +## Références [Installation de WSL](https://learn.microsoft.com/en-us/windows/wsl/install) -Guide complet sur l'installation du Sous-systeme Windows pour Linux (WSL) sur Windows. +Guide complet sur l'installation du Sous-système Windows pour Linux (WSL) sur Windows. [Documentation officielle de PostgreSQL](https://www.postgresql.org/docs/) -Documentation officielle de PostgreSQL pour le depannage des problemes courants et pour en apprendre davantage sur les commandes et la configuration de PostgreSQL. +Documentation officielle de PostgreSQL pour le dépannage des problèmes courants et pour en apprendre davantage sur les commandes et la configuration de PostgreSQL. [Installation et configuration de PyCharm](https://www.jetbrains.com/pycharm/quickstart/) -Guide de demarrage rapide pour la configuration de PyCharm, incluant la gestion des modules Python et la configuration de l'environnement. +Guide de démarrage rapide pour la configuration de PyCharm, incluant la gestion des modules Python et la configuration de l'environnement. -[Depannage de WSL](https://learn.microsoft.com/en-us/windows/wsl/troubleshoot) -Guide de depannage pour les problemes courants rencontres avec WSL, fournissant des solutions pour divers problemes qui peuvent survenir. +[Dépannage de WSL](https://learn.microsoft.com/en-us/windows/wsl/troubleshoot) +Guide de dépannage pour les problèmes courants rencontrés avec WSL, fournissant des solutions pour divers problèmes qui peuvent survenir. [Interface graphique Linux](https://hub.tcno.co/windows/wsl/desktop-gui/) -Instructions pour configurer une interface graphique (GUI) dans WSL, ce qui peut etre utile pour une meilleure integration des applications Linux. +Instructions pour configurer une interface graphique (GUI) dans WSL, ce qui peut être utile pour une meilleure intégration des applications Linux. -[Probleme de memoire](https://www.aleksandrhovhannisyan.com/blog/limiting-memory-usage-in-wsl-2/) -Guide sur la gestion et la limitation de l'utilisation de la memoire dans WSL 2 pour eviter les problemes de consommation elevee de memoire. +[Problème de mémoire](https://www.aleksandrhovhannisyan.com/blog/limiting-memory-usage-in-wsl-2/) +Guide sur la gestion et la limitation de l'utilisation de la mémoire dans WSL 2 pour éviter les problèmes de consommation élevée de mémoire. diff --git a/doc/WINDOWS_INSTALLATION.fr.md b/doc/WINDOWS_INSTALLATION.fr.md index 4842260..16c3851 100644 --- a/doc/WINDOWS_INSTALLATION.fr.md +++ b/doc/WINDOWS_INSTALLATION.fr.md @@ -1,28 +1,28 @@ -# Windows 10 version 2004 et plus ou 11 - publication et developpement +# Windows 10 version 2004 et plus ou 11 - publication et développement -Un guide pour configurer un espace de travail et executer ERPLibre sur Windows 10 version 2004 et plus ou Windows 11. Il existe deux methodes d'installation, une automatique et l'autre manuelle. +Un guide pour configurer un espace de travail et exécuter ERPLibre sur Windows 10 version 2004 et plus ou Windows 11. Il existe deux méthodes d'installation, une automatique et l'autre manuelle. -**"WSL2 Ubuntu 22.04" sera designe par "WSL2"** +**"WSL2 Ubuntu 22.04" sera désigné par "WSL2"** -**"PyCharm Professional" sera designe par "PyCharm"** +**"PyCharm Professional" sera désigné par "PyCharm"** ## Installer WSL2 -Executez Powershell avec les droits administrateur et lancez la commande suivante : +Exécutez Powershell avec les droits administrateur et lancez la commande suivante : ```bash wsl --install -d Ubuntu-22.04 ``` -Si vous avez des difficultes a ouvrir Powershell avec les droits administrateur, appuyez sur `Windows + R`, entrez la ligne suivante et appuyez sur `OK`. Les droits administrateur vous seront automatiquement demandes. +Si vous avez des difficultés à ouvrir Powershell avec les droits administrateur, appuyez sur `Windows + R`, entrez la ligne suivante et appuyez sur `OK`. Les droits administrateur vous seront automatiquement demandés. ```bash powershell.exe ``` -### Depannage - Optionnel -Si vous rencontrez des problemes, activez les options de virtualisation dans le BIOS si disponibles (hyper-v, vt-x, etc). Recherchez `Activer ou desactiver des fonctionnalites Windows` dans la barre de recherche Windows et assurez-vous que `Sous-systeme Windows pour Linux` est active avant de redemarrer votre machine. +### Dépannage - Optionnel +Si vous rencontrez des problèmes, activez les options de virtualisation dans le BIOS si disponibles (hyper-v, vt-x, etc). Recherchez `Activer ou désactiver des fonctionnalités Windows` dans la barre de recherche Windows et assurez-vous que `Sous-système Windows pour Linux` est activé avant de redémarrer votre machine. Vous pouvez aussi essayer ces commandes powershell : @@ -31,27 +31,27 @@ dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /nores wsl --set-default-version 2 ``` -Telechargez et installez le dernier package de mise a jour du noyau Linux de Microsoft avec le [lien](https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi) suivant : +Téléchargez et installez le dernier package de mise à jour du noyau Linux de Microsoft avec le [lien](https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi) suivant : ```bash https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi ``` -N'executez cette commande qu'en dernier recours car elle peut casser d'autres machines virtuelles : +N'exécutez cette commande qu'en dernier recours car elle peut casser d'autres machines virtuelles : ```bash bcdedit /set hypervisorlaunchtype auto ``` -### Autres methodes d'installation pour WSL2 +### Autres méthodes d'installation pour WSL2 -Executez Powershell avec les droits administrateur et lancez la commande suivante : +Exécutez Powershell avec les droits administrateur et lancez la commande suivante : ```bash curl.exe -L -o ubuntu-2004.appx https://aka.ms/wslubuntu2004 ``` -Executez Powershell avec les droits administrateur et lancez les commandes suivantes : +Exécutez Powershell avec les droits administrateur et lancez les commandes suivantes : ```bash Invoke-WebRequest -Uri https://aka.ms/wslubuntu2004 -OutFile Ubuntu.appx -UseBasicParsing @@ -66,21 +66,21 @@ https://apps.microsoft.com/store/detail/ubuntu-22041-lts/9PN20MSR04DW ## Configurer WSL2 pour ERPLibre -Une fois WSL2 installe correctement, redemarrez votre ordinateur. +Une fois WSL2 installé correctement, redémarrez votre ordinateur. -### Vous pouvez ouvrir votre Ubuntu de plusieurs facons : +### Vous pouvez ouvrir votre Ubuntu de plusieurs façons : * Recherchez "Ubuntu" en cliquant sur la touche Windows -* [Telechargez le Terminal Windows depuis le Microsoft Store](https://apps.microsoft.com/store/detail/windows-terminal/9N0DX20HK701) +* [Téléchargez le Terminal Windows depuis le Microsoft Store](https://apps.microsoft.com/store/detail/windows-terminal/9N0DX20HK701) -Si vous utilisez le Terminal Windows, vous n'avez qu'a cliquer sur la petite fleche a cote du signe + et vous verrez Ubuntu. +Si vous utilisez le Terminal Windows, vous n'avez qu'à cliquer sur la petite flèche à côté du signe + et vous verrez Ubuntu. ![image](https://user-images.githubusercontent.com/59217113/230186101-579d8a5b-0825-404f-bd28-3642adce0948.png) ### Configurer une interface graphique pour votre Ubuntu -1. Mettre a jour votre Ubuntu +1. Mettre à jour votre Ubuntu ```bash sudo apt-get update -y && sudo apt-get upgrade -y @@ -102,7 +102,7 @@ sudo sed -i 's/xserverbpp=24/#xserverbpp=24\nxserverbpp=128/g' /etc/xrdp/xrdp.in echo xfce4-session > ~/.xsession ``` -4. Configurer la connexion Bureau a distance +4. Configurer la connexion Bureau à distance ```bash sudo nano /etc/xrdp/startwm.sh @@ -115,7 +115,7 @@ test -x /etc/X11/Xsession && exec /etc/X11/Xsession exec /bin/sh /etc/X11/Xsession ``` -Ajoutez cette ligne a la fin du fichier +Ajoutez cette ligne à la fin du fichier ```bash startxfce4 @@ -123,7 +123,7 @@ startxfce4 Quittez avec Ctrl+S, Ctrl+X -5. Demarrer l'interface graphique du bureau Ubuntu +5. Démarrer l'interface graphique du bureau Ubuntu Ouvrez le terminal Ubuntu sur votre Windows et entrez cette commande @@ -131,11 +131,11 @@ Ouvrez le terminal Ubuntu sur votre Windows et entrez cette commande sudo /etc/init.d/xrdp start ``` -Ensuite ouvrez *Connexion Bureau a distance* en cliquant sur la touche Windows et connectez-vous a *localhost:3390* +Ensuite ouvrez *Connexion Bureau à distance* en cliquant sur la touche Windows et connectez-vous à *localhost:3390* -### Memoire - Optionnel -Si WSL utilise trop de memoire, vous pouvez la reduire avec une etape simple. -Il suffit d'aller dans *C:\Users\VotreNomUtilisateur\.wslconfig* et de creer un fichier *.wslconfig* et d'ecrire : +### Mémoire - Optionnel +Si WSL utilise trop de mémoire, vous pouvez la réduire avec une étape simple. +Il suffit d'aller dans *C:\Users\VotreNomUtilisateur\.wslconfig* et de créer un fichier *.wslconfig* et d'écrire : ```bash sudo /etc/init.d/xrdp start @@ -144,7 +144,7 @@ sudo /etc/init.d/xrdp start memory=3GB ``` -### Installation des outils necessaires et a jour +### Installation des outils nécessaires et à jour ```bash sudo apt update @@ -153,7 +153,7 @@ sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3- ## Installation d'ERPLibre sous WSL2 -Assurez-vous d'etre dans le repertoire ou vous souhaitez cloner le projet. +Assurez-vous d'être dans le répertoire où vous souhaitez cloner le projet. ```bash git clone https://github.com/ERPLibre/ERPLibre.git @@ -161,54 +161,54 @@ cd ERPLibre make install ``` -Ajoutez un role a PostgreSQL, changez le champ `USERNAME` dans la commande avec votre nom d'utilisateur UNIX de votre environnement WSL2. +Ajoutez un rôle à PostgreSQL, changez le champ `USERNAME` dans la commande avec votre nom d'utilisateur UNIX de votre environnement WSL2. ```bash sudo service postgresql start sudo su - postgres -c "createuser -s USERNAME" 2>/dev/null || true ``` -## Problemes courants lors de l'installation +## Problèmes courants lors de l'installation ### Erreur lors de `make install` -Assurez-vous que toutes les dependances sont installees correctement. Relancez la commande suivante pour corriger les dependances cassees : +Assurez-vous que toutes les dépendances sont installées correctement. Relancez la commande suivante pour corriger les dépendances cassées : ```bash sudo apt-get install -f ``` -### PostgreSQL ne demarre pas -Verifiez le statut du service PostgreSQL avec la commande suivante : +### PostgreSQL ne démarre pas +Vérifiez le statut du service PostgreSQL avec la commande suivante : ```bash sudo service postgresql status ``` -Si PostgreSQL ne fonctionne pas, essayez de le redemarrer avec : +Si PostgreSQL ne fonctionne pas, essayez de le redémarrer avec : ```bash sudo service postgresql restart ``` -## Executer ERPLibre +## Exécuter ERPLibre -A chaque redemarrage de votre machine, la commande suivante doit etre executee pour demarrer le service PostgreSQL s'il n'est pas deja en cours d'execution : +À chaque redémarrage de votre machine, la commande suivante doit être exécutée pour démarrer le service PostgreSQL s'il n'est pas déjà en cours d'exécution : ```bash sudo service postgresql start ``` -Ensuite lancez cette commande a la racine du projet : +Ensuite lancez cette commande à la racine du projet : ```bash ./run.sh ``` -## Verification d'ERPLibre -Pendant qu'ERPLibre est en cours d'execution, assurez-vous que vous pouvez vous connecter a l'URL suivante `http://localhost:8069` et que vous avez la possibilite de creer, modifier et supprimer des bases de donnees. +## Vérification d'ERPLibre +Pendant qu'ERPLibre est en cours d'exécution, assurez-vous que vous pouvez vous connecter à l'URL suivante `http://localhost:8069` et que vous avez la possibilité de créer, modifier et supprimer des bases de données. -## Configurer l'environnement de developpement - PyCharm +## Configurer l'environnement de développement - PyCharm ### Installer PyCharm @@ -220,24 +220,24 @@ https://www.jetbrains.com/pycharm/download/#section=windows ### Configurer Pycharm -Selectionnez `Connect to WSL` sous `Remote Development`. Ensuite selectionnez votre instance Ubuntu ("Ubuntu-22.04"). Pointez `Project directory` vers la racine du projet. Une fois que tout a ete selectionne et rempli correctement, cliquez sur `Start IDE and Connect`. +Sélectionnez `Connect to WSL` sous `Remote Development`. Ensuite sélectionnez votre instance Ubuntu ("Ubuntu-22.04"). Pointez `Project directory` vers la racine du projet. Une fois que tout a été sélectionné et rempli correctement, cliquez sur `Start IDE and Connect`. ![Welcome to PyCharm Wizard](image/remote_development.png) -Appuyez sur `CTRL+ALT+S`, recherchez `interpreter` et dans la page `Python Interpreter`, cliquez sur `Add Interpreter` et selectionnez `Add Local Interpreter...`. +Appuyez sur `CTRL+ALT+S`, recherchez `interpreter` et dans la page `Python Interpreter`, cliquez sur `Add Interpreter` et sélectionnez `Add Local Interpreter...`. ![Interpreter Settings](image/add_local_interpreter.png) -Assurez-vous de selectionner `Virtualenv Environment` a gauche et le bouton radio `Existing`. Une fois les deux correctement selectionnes, pointez votre interpreteur vers le repertoire `../ERPLibre/.venv/bin/python` du projet et cliquez sur `OK`. +Assurez-vous de sélectionner `Virtualenv Environment` à gauche et le bouton radio `Existing`. Une fois les deux correctement sélectionnés, pointez votre interpréteur vers le répertoire `../ERPLibre/.venv/bin/python` du projet et cliquez sur `OK`. ![Environment Settings](image/existing_venv.png) -Si ces dernieres etapes pour configurer votre environnement de developpement n'ont pas fonctionne, suivez les etapes "Manuelles" suivantes pour configurer votre environnement. +Si ces dernières étapes pour configurer votre environnement de développement n'ont pas fonctionné, suivez les étapes "Manuelles" suivantes pour configurer votre environnement. ## Installation manuelle ### Installer Python 3.10.14 -Vous pouvez supprimer les fichiers restants dans votre repertoire personnel concernant l'installation de Python une fois les etapes completees avec succes. +Vous pouvez supprimer les fichiers restants dans votre répertoire personnel concernant l'installation de Python une fois les étapes complétées avec succès. ```bash cd ~ @@ -249,13 +249,13 @@ make -j $(nproc) sudo make install ``` -### Verifier l'installation +### Vérifier l'installation ```bash python3.10 ``` -### Definir Python 3.10.14 par defaut +### Définir Python 3.10.14 par défaut ```bash alias python='/usr/local/bin/python3.10' @@ -264,23 +264,23 @@ source ~/.bashrc ### Configurer Pycharm -Ouvrez le repertoire du projet dans PyCharm. +Ouvrez le répertoire du projet dans PyCharm. -Appuyez sur `CTRL+ALT+S`, recherchez `interpreter` et dans la page `Python Interpreter`, cliquez sur `Add Interpreter` et selectionnez `On WSL...`. +Appuyez sur `CTRL+ALT+S`, recherchez `interpreter` et dans la page `Python Interpreter`, cliquez sur `Add Interpreter` et sélectionnez `On WSL...`. ![Interpreter Settings](image/on_wsl.png) -Attendez que PyCharm detecte votre instance WSL2 et appuyez sur `NEXT`. Cliquez sur `System Interpreter` a gauche, selectionnez le bon interpreteur s'il ne l'a pas fait automatiquement et cliquez sur `Create`. +Attendez que PyCharm détecte votre instance WSL2 et appuyez sur `NEXT`. Cliquez sur `System Interpreter` à gauche, sélectionnez le bon interpréteur s'il ne l'a pas fait automatiquement et cliquez sur `Create`. ![System Interpreter](image/system_python.png) -Fermez les parametres du projet. Lorsque PyCharm vous propose d'importer des modules, autorisez-le. +Fermez les paramètres du projet. Lorsque PyCharm vous propose d'importer des modules, autorisez-le. -## Problemes courants avec le developpement Windows +## Problèmes courants avec le développement Windows -### Terminal casse +### Terminal cassé -Recherchez `terminal` dans les parametres, et sous `Application Settings` dans le champ `Shell path:` entrez la ligne suivante : +Recherchez `terminal` dans les paramètres, et sous `Application Settings` dans le champ `Shell path:` entrez la ligne suivante : ```bash wsl.exe @@ -288,38 +288,38 @@ wsl.exe ![Shell Path - Terminal](image/shell_path.png) -### Avertissements d'utilisation elevee de la memoire -Si vous constatez une utilisation elevee de la memoire, cliquez sur `Help` dans la barre d'outils et choisissez `Change Memory Settings` pour augmenter la memoire allouee a l'IDE. +### Avertissements d'utilisation élevée de la mémoire +Si vous constatez une utilisation élevée de la mémoire, cliquez sur `Help` dans la barre d'outils et choisissez `Change Memory Settings` pour augmenter la mémoire allouée à l'IDE. -### Modules importes manquants ou incorrects -PyCharm peut ne pas reconnaitre completement certains details de `requirements.txt` et `pyproject.toml` (par exemple, des versions specifiques de modules). Si vous rencontrez des problemes a l'execution ou lors du debogage, recherchez la bonne version du module et reinstallez-le avec le gestionnaire de paquets de PyCharm. +### Modules importés manquants ou incorrects +PyCharm peut ne pas reconnaître complètement certains détails de `requirements.txt` et `pyproject.toml` (par exemple, des versions spécifiques de modules). Si vous rencontrez des problèmes à l'exécution ou lors du débogage, recherchez la bonne version du module et réinstallez-le avec le gestionnaire de paquets de PyCharm. -### Impossible d'executer ERPLibre depuis PyCharm +### Impossible d'exécuter ERPLibre depuis PyCharm -Si ERPLibre ne se lance pas depuis PyCharm, executez la commande suivante dans le repertoire racine du projet depuis le terminal de PyCharm ou WSL2 : +Si ERPLibre ne se lance pas depuis PyCharm, exécutez la commande suivante dans le répertoire racine du projet depuis le terminal de PyCharm ou WSL2 : ```bash ./script/ide/pycharm_configuration.py ``` -### Impossible de redemarrer ERPLibre -Lancez `htop` depuis le terminal de PyCharm ou WSL2 et fermez les processus Python lies a ERPLibre pour liberer le socket. +### Impossible de redémarrer ERPLibre +Lancez `htop` depuis le terminal de PyCharm ou WSL2 et fermez les processus Python liés à ERPLibre pour libérer le socket. -## References +## Références [Installation de WSL](https://learn.microsoft.com/en-us/windows/wsl/install) -Guide complet sur l'installation du Sous-systeme Windows pour Linux (WSL) sur Windows. +Guide complet sur l'installation du Sous-système Windows pour Linux (WSL) sur Windows. [Documentation officielle de PostgreSQL](https://www.postgresql.org/docs/) -Documentation officielle de PostgreSQL pour le depannage des problemes courants et pour en apprendre davantage sur les commandes et la configuration de PostgreSQL. +Documentation officielle de PostgreSQL pour le dépannage des problèmes courants et pour en apprendre davantage sur les commandes et la configuration de PostgreSQL. [Installation et configuration de PyCharm](https://www.jetbrains.com/pycharm/quickstart/) -Guide de demarrage rapide pour la configuration de PyCharm, incluant la gestion des modules Python et la configuration de l'environnement. +Guide de démarrage rapide pour la configuration de PyCharm, incluant la gestion des modules Python et la configuration de l'environnement. -[Depannage de WSL](https://learn.microsoft.com/en-us/windows/wsl/troubleshoot) -Guide de depannage pour les problemes courants rencontres avec WSL, fournissant des solutions pour divers problemes qui peuvent survenir. +[Dépannage de WSL](https://learn.microsoft.com/en-us/windows/wsl/troubleshoot) +Guide de dépannage pour les problèmes courants rencontrés avec WSL, fournissant des solutions pour divers problèmes qui peuvent survenir. [Interface graphique Linux](https://hub.tcno.co/windows/wsl/desktop-gui/) -Instructions pour configurer une interface graphique (GUI) dans WSL, ce qui peut etre utile pour une meilleure integration des applications Linux. +Instructions pour configurer une interface graphique (GUI) dans WSL, ce qui peut être utile pour une meilleure intégration des applications Linux. -[Probleme de memoire](https://www.aleksandrhovhannisyan.com/blog/limiting-memory-usage-in-wsl-2/) -Guide sur la gestion et la limitation de l'utilisation de la memoire dans WSL 2 pour eviter les problemes de consommation elevee de memoire. \ No newline at end of file +[Problème de mémoire](https://www.aleksandrhovhannisyan.com/blog/limiting-memory-usage-in-wsl-2/) +Guide sur la gestion et la limitation de l'utilisation de la mémoire dans WSL 2 pour éviter les problèmes de consommation élevée de mémoire. \ No newline at end of file