From 7c6604c056bcb177bc9882d70bc7ec39751d9a2a Mon Sep 17 00:00:00 2001 From: Pierre Date: Thu, 16 Nov 2023 15:40:31 +0100 Subject: [PATCH] README*.md update --- README.md | 158 +++++++++++++++++++++++++-------------------------- README_fr.md | 156 +++++++++++++++++++++++++------------------------- 2 files changed, 157 insertions(+), 157 deletions(-) diff --git a/README.md b/README.md index d6c21e03..6328a2b2 100644 --- a/README.md +++ b/README.md @@ -23,23 +23,23 @@ ║ ║ ╚════════════════════════════════════════════════════════════════════════════════════╝ --> -# [![vCardOOo logo][0]][-1] Documentation +# [![vCardOOo logo][1]][2] Documentation -**Ce [document][1] en français.** +**Ce [document][3] en français.** -**The use of this software subjects you to our [Terms Of Use][2] and [Data Protection Policy][3].** +**The use of this software subjects you to our [Terms Of Use][4] and [Data Protection Policy][5].** -# version [1.0.3][4] +# version [1.0.3][6] ## Introduction: -**vCardOOo** is part of a [Suite][5] of [LibreOffice][6] ~~and/or [OpenOffice][7]~~ extensions allowing to offer you innovative services in these office suites. +**vCardOOo** is part of a [Suite][7] of [LibreOffice][8] ~~and/or [OpenOffice][9]~~ extensions allowing to offer you innovative services in these office suites. This extension gives you access, in LibreOffice, to your contacts present on a CardDAV server (or vCard Extensions to WebDAV). Being free software I encourage you: -- To duplicate its [source code][8]. +- To duplicate its [source code][10]. - To make changes, corrections, improvements. -- To open [issue][9] if needed. +- To open [issue][11] if needed. In short, to participate in the development of this extension. Because it is together that we can make Free Software smarter. @@ -52,15 +52,15 @@ In order to take advantage of the latest versions of the Python libraries used i This means that **vCardOOo no longer supports OpenOffice and LibreOffice 6.x on Windows since version 1.0.0**. I can only advise you **to migrate to LibreOffice 7.x**. -vCardOOo uses a local [HsqlDB][10] database version 2.7.2. -HsqlDB being a database written in Java, its use requires the [installation and configuration][11] in LibreOffice / OpenOffice of a **JRE version 11 or later**. -I recommend [Adoptium][12] as your Java installation source. +vCardOOo uses a local [HsqlDB][12] database version 2.7.2. +HsqlDB being a database written in Java, its use requires the [installation and configuration][13] in LibreOffice / OpenOffice of a **JRE version 11 or later**. +I recommend [Adoptium][14] as your Java installation source. -If you are using **LibreOffice Community on Linux**, you are subject to [bug 139538][13]. To work around the problem, please **uninstall the packages** with commands: +If you are using **LibreOffice Community on Linux**, you are subject to [bug 139538][15]. To work around the problem, please **uninstall the packages** with commands: - `sudo apt remove libreoffice-sdbc-hsqldb` (to uninstall the libreoffice-sdbc-hsqldb package) - `sudo apt remove libhsqldb1.8.0-java` (to uninstall the libhsqldb1.8.0-java package) -If you still want to use the Embedded HsqlDB functionality provided by LibreOffice, then install the [HyperSQLOOo][14] extension. +If you still want to use the Embedded HsqlDB functionality provided by LibreOffice, then install the [HyperSQLOOo][16] extension. ___ @@ -69,15 +69,15 @@ ___ It seems important that the file was not renamed when it was downloaded. If necessary, rename it before installing it. -- [![OAuth2OOo logo][15]][16] Install **[OAuth2OOo.oxt][17]** extension [![Version][18]][17] +- [![OAuth2OOo logo][17]][18] Install **[OAuth2OOo.oxt][19]** extension [![Version][20]][19] You must install this extension, if it is not already installed. -- [![jdbcDriverOOo logo][19]][20] Install **[jdbcDriverOOo.oxt][21]** extension [![Version][22]][21] +- [![jdbcDriverOOo logo][21]][22] Install **[jdbcDriverOOo.oxt][23]** extension [![Version][24]][23] You must install this extension, if it is not already installed. -- ![vCardOOo logo][23] Install **[vCardOOo.oxt][24]** extension [![Version][25]][24] +- ![vCardOOo logo][25] Install **[vCardOOo.oxt][26]** extension [![Version][27]][26] Restart LibreOffice / OpenOffice after installation. @@ -87,7 +87,7 @@ ___ In LibreOffice / OpenOffice go to: **File -> Wizards -> Address Data Source...** -![vCardOOo screenshot 1][26] +![vCardOOo screenshot 1][28] The **Address Book Datasource Wizard** open. @@ -95,12 +95,12 @@ In step: **1.Address Book Type**: - Select: **Other external data source**. - Click button: **Next**. -![vCardOOo screenshot 2][27] +![vCardOOo screenshot 2][29] In step: **2.Connection Settings**: - Click button: **Settings**. -![vCardOOo screenshot 3][28] +![vCardOOo screenshot 3][30] A new wizard opens. **Data source properties**. @@ -109,7 +109,7 @@ In Database type list: - Select: **vCard Contacts**. - click button: **Next**. -![vCardOOo screenshot 4][29] +![vCardOOo screenshot 4][31] In step: **2.Connection Settings**. In General: Enter the DBMS/driver-specific connection string here. @@ -122,20 +122,20 @@ In User Authentication: User name: Then: - Click button: **Test connection**. -![vCardOOo screenshot 5][30] +![vCardOOo screenshot 5][32] In Authentication required: Password: - Put your password. -![vCardOOo screenshot 6][31] +![vCardOOo screenshot 6][33] Normally you should see: Connection Test: The connection was established successfully. -![vCardOOo screenshot 7][32] +![vCardOOo screenshot 7][34] If the connection has been established, you can complete this wizard with the **Finish** button. -![vCardOOo screenshot 8][33] +![vCardOOo screenshot 8][35] In step: **3.Table Selection**. If your data source has multiple tables, you will be asked to select the primary table. @@ -145,7 +145,7 @@ In step: **4.Field Assignment**. If necessary it is possible to rename the names of the columns of the data source using the button: **Field Assignment**. Please continue this wizard with the button: **Next**. -![vCardOOo screenshot 9][34] +![vCardOOo screenshot 9][36] In step: **5.Data Source Title**. @@ -157,7 +157,7 @@ This odb file must also be made accessible. To do this you must: - **Check the box**: Make this address book available to all modules in LibreOffice - Named the address book in the field: **Address book name**. -![vCardOOo screenshot 10][35] +![vCardOOo screenshot 10][37] Have fun... @@ -171,10 +171,10 @@ ___ * LibreOffice 7.4.3.2(x64) - Windows 10(x64) - Python version 3.8.15 - Adoptium JDK Hotspot 11.0.17 (x64) (under Lubuntu 22.04 / VirtualBox 6.1.38) -* **Does not work with OpenOffice on Windows** see [bug 128569][36]. Having no solution, I encourage you to install **LibreOffice**. +* **Does not work with OpenOffice on Windows** see [bug 128569][38]. Having no solution, I encourage you to install **LibreOffice**. I encourage you in case of problem :confused: -to create an [issue][9] +to create an [issue][11] I will try to solve it :smile: ___ @@ -185,24 +185,24 @@ ___ This extension was written in order to make usable in free software (LibreOffice or OpenOffice) your personal data (your vCard) stored on a Nextcloud server. -With the [eMailerOOo][37] extension, it can be the data source for [mail merge][38] by email, to your correspondents (your vCard) coming from the Nextcloud server. +With the [eMailerOOo][39] extension, it can be the data source for [mail merge][40] by email, to your correspondents (your vCard) coming from the Nextcloud server. It will give you access to an information system that only larges companies are able, today, to implement. ### What has been done for version 0.0.1: -- Writing of the UNO service [com.sun.star.sdbc.Driver][39] responding to the call from the url `sdbc:address:vcard:*` - The `connect(url, info)` method of this Driver use the [DataSource][40] singleton to return the UNO service `com.sun.star.sdbc.Connection`. +- Writing of the UNO service [com.sun.star.sdbc.Driver][41] responding to the call from the url `sdbc:address:vcard:*` + The `connect(url, info)` method of this Driver use the [DataSource][42] singleton to return the UNO service `com.sun.star.sdbc.Connection`. - This DataSource singleton is responsible for: - - When created, create a [Replicator][41] thread to track remote changes on Nextcloud servers. - - Create and cache a [User][42] Interface needed for: + - When created, create a [Replicator][43] thread to track remote changes on Nextcloud servers. + - Create and cache a [User][44] Interface needed for: - Creating the connection to the underlying database. - Connect the Replicator to Nextcloud servers. - Start the Replicator each time you connect to the database. -- After retrieving the remote modifications, the Replicator uses to analyze the content of the vCards a UNO `com.sun.star.task.Job` service [CardSync][43] written in Java and using the [ez-vcard][44] library. +- After retrieving the remote modifications, the Replicator uses to analyze the content of the vCards a UNO `com.sun.star.task.Job` service [CardSync][45] written in Java and using the [ez-vcard][46] library. ### What has been done for version 1.0.1: @@ -226,49 +226,49 @@ It will give you access to an information system that only larges companies are - Anything welcome... -[0]: -[-1]: -[1]: -[2]: -[3]: -[4]: -[5]: -[6]: -[7]: -[8]: -[9]: -[10]: -[11]: -[12]: -[13]: -[14]: -[15]: -[16]: -[17]: -[18]: -[19]: -[20]: -[21]: -[22]: -[23]: -[24]: -[25]: -[26]: -[27]: -[28]: -[29]: -[30]: -[31]: -[32]: -[33]: -[34]: -[35]: -[36]: -[37]: -[38]: -[39]: -[40]: -[41]: -[42]: -[43]: -[44]: +[1]: +[2]: +[3]: +[4]: +[5]: +[6]: +[7]: +[8]: +[9]: +[10]: +[11]: +[12]: +[13]: +[14]: +[15]: +[16]: +[17]: +[18]: +[19]: +[20]: +[21]: +[22]: +[23]: +[24]: +[25]: +[26]: +[27]: +[28]: +[29]: +[30]: +[31]: +[32]: +[33]: +[34]: +[35]: +[36]: +[37]: +[38]: +[39]: +[40]: +[41]: +[42]: +[43]: +[44]: +[45]: +[46]: diff --git a/README_fr.md b/README_fr.md index ff6fdaf2..111bf8c9 100644 --- a/README_fr.md +++ b/README_fr.md @@ -25,21 +25,21 @@ --> # Documentation -**This [document][1] in English.** +**This [document][3] in English.** -**L'utilisation de ce logiciel vous soumet à nos [Conditions d'utilisation][2] et à notre [Politique de protection des données][3]**. +**L'utilisation de ce logiciel vous soumet à nos [Conditions d'utilisation][4] et à notre [Politique de protection des données][5]**. -# version [1.0.3][4] +# version [1.0.3][6] ## Introduction: -**vCardOOo** fait partie d'une [Suite][5] d'extensions [LibreOffice][6] ~~et/ou [OpenOffice][7]~~ permettant de vous offrir des services inovants dans ces suites bureautique. +**vCardOOo** fait partie d'une [Suite][7] d'extensions [LibreOffice][8] ~~et/ou [OpenOffice][9]~~ permettant de vous offrir des services inovants dans ces suites bureautique. Cette extension vous donne l'accès, dans LibreOffice, à vos contacts présent sur un serveur CardDAV (ou vCard Extensions to WebDAV). Etant un logiciel libre je vous encourage: -- A dupliquer son [code source][8]. +- A dupliquer son [code source][10]. - A apporter des modifications, des corrections, des améliorations. -- D'ouvrir un [dysfonctionnement][9] si nécessaire. +- D'ouvrir un [dysfonctionnement][11] si nécessaire. Bref, à participer au developpement de cette extension. Car c'est ensemble que nous pouvons rendre le Logiciel Libre plus intelligent. @@ -52,15 +52,15 @@ Afin de profiter des dernières versions des bibliothèques Python utilisées da Cela signifie que **vCardOOo ne supporte plus OpenOffice et LibreOffice 6.x sous Windows depuis sa version 1.0.0**. Je ne peux que vous conseiller **de migrer vers LibreOffice 7.x**. -vCardOOo utilise une base de données locale [HsqlDB][10] version 2.7.2. -HsqlDB étant une base de données écrite en Java, son utilisation nécessite [l'installation et la configuration][11] dans LibreOffice / OpenOffice d'un **JRE version 11 ou ultérieure**. -Je vous recommande [Adoptium][12] comme source d'installation de Java. +vCardOOo utilise une base de données locale [HsqlDB][12] version 2.7.2. +HsqlDB étant une base de données écrite en Java, son utilisation nécessite [l'installation et la configuration][13] dans LibreOffice / OpenOffice d'un **JRE version 11 ou ultérieure**. +Je vous recommande [Adoptium][14] comme source d'installation de Java. -Si vous utilisez **LibreOffice Community sous Linux**, vous êtes sujet au [dysfonctionnement 139538][13]. Pour contourner le problème, veuillez **désinstaller les paquets** avec les commandes: +Si vous utilisez **LibreOffice Community sous Linux**, vous êtes sujet au [dysfonctionnement 139538][15]. Pour contourner le problème, veuillez **désinstaller les paquets** avec les commandes: - `sudo apt remove libreoffice-sdbc-hsqldb` (pour désinstaller le paquet libreoffice-sdbc-hsqldb) - `sudo apt remove libhsqldb1.8.0-java` (pour désinstaller le paquet libhsqldb1.8.0-java) -Si vous souhaitez quand même utiliser la fonctionnalité HsqlDB intégré fournie par LibreOffice, alors installez l'extension [HyperSQLOOo][14]. +Si vous souhaitez quand même utiliser la fonctionnalité HsqlDB intégré fournie par LibreOffice, alors installez l'extension [HyperSQLOOo][16]. ___ @@ -69,15 +69,15 @@ ___ Il semble important que le fichier n'ait pas été renommé lors de son téléchargement. Si nécessaire, renommez-le avant de l'installer. -- [![OAuth2OOo logo][15]][16] Installer l'extension **[OAuth2OOo.oxt][17]** [![Version][18]][17] +- [![OAuth2OOo logo][17]][18] Installer l'extension **[OAuth2OOo.oxt][19]** [![Version][20]][19] Vous devez installer cette extension, si elle n'est pas déjà installée. -- [![jdbcDriverOOo logo][19]][20] Installer l'extension **[jdbcDriverOOo.oxt][21]** [![Version][22]][21] +- [![jdbcDriverOOo logo][21]][22] Installer l'extension **[jdbcDriverOOo.oxt][23]** [![Version][24]][23] Vous devez installer cette extension, si elle n'est pas déjà installée. -- ![vCardOOo logo][23] Installer l'extension **[vCardOOo.oxt][24]** [![Version][25]][24] +- ![vCardOOo logo][25] Installer l'extension **[vCardOOo.oxt][26]** [![Version][27]][26] Redémarrez LibreOffice / OpenOffice après l'installation. @@ -87,7 +87,7 @@ ___ Dans LibreOffice / OpenOffice aller à: **Fichier -> Assistants -> Source de données des adresses...** -![vCardOOo screenshot 1][26] +![vCardOOo screenshot 1][28] L'**Assistant source de données du carnet d'adresses** s'ouvre. @@ -95,12 +95,12 @@ L'**Assistant source de données du carnet d'adresses** s'ouvre. - Sélectionner: **Autre source de données externes**. - Cliquez sur le bouton: **Suivant**. -![vCardOOo screenshot 2][27] +![vCardOOo screenshot 2][29] À l'étape: **2.Paramètres de Connexion**: - Cliquez sur le bouton: **Paramètres**. -![vCardOOo screenshot 3][28] +![vCardOOo screenshot 3][30] Un nouvel assistant s'ouvre. **Propriétés de la source de données**. @@ -109,7 +109,7 @@ Dans Type de base de données: - Sélectionner: **Contacts vCard**. - Cliquez sur le bouton: **Suivant**. -![vCardOOo screenshot 4][29] +![vCardOOo screenshot 4][31] A l'étape: **2.Paramètres de connexion**. Dans Général: Entrer ici la chaîne de connexion spécifique au SGDB / pilote. @@ -122,20 +122,20 @@ Dans Authentification de l'utilisateur: Nom d'utilisateur: Puis: - Cliquez sur le bouton: **Tester la connexion**. -![vCardOOo screenshot 5][30] +![vCardOOo screenshot 5][32] Dans Authentification requise: Mot de passe: - Mettre votre mot de passe. -![vCardOOo screenshot 6][31] +![vCardOOo screenshot 6][33] Normalement vous devez voir s'afficher: Test de connexion: Connexion établie. -![vCardOOo screenshot 7][32] +![vCardOOo screenshot 7][34] Si la connexion a été etablie, vous pouvez terminer cet assistant avec le bouton **Terminer**. -![vCardOOo screenshot 8][33] +![vCardOOo screenshot 8][35] A l'étape: **3.Sélection de table**. Si votre source de données comporte plusieurs tables, il vous sera demandé de sélectionner la table principale. @@ -145,7 +145,7 @@ A l'étape: **4.Assignation de champ**. Si nécessaire il est possible de renommer les noms des colonnes de la source de données à l'aide du bouton: **Assignation de champ**. Veuillez poursuivre cet assistant par le bouton: **Suivant**. -![vCardOOo screenshot 9][34] +![vCardOOo screenshot 9][36] A l'étape: **5.Titre de la source de données**. @@ -157,7 +157,7 @@ Il faut également rendre accessible ce fichier odb. Pour cela vous devez: - **Cocher la case**: Rendre ce carnet d'adresses accessible à tous les modules de LibreOffice - Nommer le carnet d'adresses dans le champ: **Nom du carnet d'adresses**. -![vCardOOo screenshot 10][35] +![vCardOOo screenshot 10][37] Maintenant à vous d'en profiter... @@ -171,10 +171,10 @@ ___ * LibreOffice 7.4.3.2(x64) - Windows 10(x64) - Python version 3.8.15 - Adoptium JDK Hotspot 11.0.17 (x64) (under Lubuntu 22.04 / VirtualBox 6.1.38) -* **Ne fonctionne pas avec OpenOffice sous Windows** voir [dysfonctionnement 128569][36]. N'ayant aucune solution, je vous encourrage d'installer **LibreOffice**. +* **Ne fonctionne pas avec OpenOffice sous Windows** voir [dysfonctionnement 128569][38]. N'ayant aucune solution, je vous encourrage d'installer **LibreOffice**. Je vous encourage en cas de problème :confused: -de créer un [dysfonctionnement][9] +de créer un [dysfonctionnement][11] J'essaierai de le résoudre :smile: ___ @@ -185,24 +185,24 @@ ___ Cette extension a été écrite afin de rendre utilisables dans un logiciel libre (LibreOffice ou OpenOffice) vos données personnelles (vos vCard) stockées sur un serveur Nextcloud. -Avec l'extension [eMailerOOo][37], elle peut être la source de données pour des [publipostages][38] par courriel (email), à vos correspondants (vos vCard) provenant du serveur Nextcloud. +Avec l'extension [eMailerOOo][39], elle peut être la source de données pour des [publipostages][40] par courriel (email), à vos correspondants (vos vCard) provenant du serveur Nextcloud. Elle vous donnera accès à un système d'information que seules les grandes entreprises sont capables, aujourd'hui, de mettre en œuvre. ### Ce qui a été fait pour la version 0.0.1: -- Ecriture du service UNO [com.sun.star.sdbc.Driver][39] repondant à l'appel de l'url `sdbc:address:vcard:*` - La méthode `connect(url, info)` de ce pilote utilise le singleton [DataSource][40] pour renvoyer le service UNO `com.sun.star.sdbc.Connection`. +- Ecriture du service UNO [com.sun.star.sdbc.Driver][41] repondant à l'appel de l'url `sdbc:address:vcard:*` + La méthode `connect(url, info)` de ce pilote utilise le singleton [DataSource][42] pour renvoyer le service UNO `com.sun.star.sdbc.Connection`. - Ce singleton DataSource est responsable de: - - Lors de sa création, créer un thread [Replicator][41] pour suivre les modifications distantes sur les serveurs Nextcloud. - - Créer et de mettre en cache une interface [User][42] nécessaire pour: + - Lors de sa création, créer un thread [Replicator][43] pour suivre les modifications distantes sur les serveurs Nextcloud. + - Créer et de mettre en cache une interface [User][44] nécessaire pour: - La création de la connexion à la base de données sous-jacente. - La connexion du Replicator au serveurs Nextcloud. - Démarrer le Replicator à chaque connexion à la base de données. -- Après avoir récupéré les modifications distantes, le Replicator utilise pour analyser le contenu des vCards un service UNO `com.sun.star.task.Job` [CardSync][43] écrit en Java et utilisant la bibliothèque [ez-vcard][44]. +- Après avoir récupéré les modifications distantes, le Replicator utilise pour analyser le contenu des vCards un service UNO `com.sun.star.task.Job` [CardSync][45] écrit en Java et utilisant la bibliothèque [ez-vcard][46]. ### Ce qui a été fait pour la version 1.0.1: @@ -226,49 +226,49 @@ Elle vous donnera accès à un système d'information que seules les grandes ent - Tout ce qui est bienvenu... - - -[1]: -[2]: -[3]: -[4]: -[5]: -[6]: -[7]: -[8]: -[9]: -[10]: -[11]: -[12]: -[13]: -[14]: -[15]: -[16]: -[17]: -[18]: -[19]: -[20]: -[21]: -[22]: -[23]: -[24]: -[25]: -[26]: -[27]: -[28]: -[29]: -[30]: -[31]: -[32]: -[33]: -[34]: -[35]: -[36]: -[37]: -[38]: -[39]: -[40]: -[41]: -[42]: -[43]: -[44]: +[1]: +[2]: +[3]: +[4]: +[5]: +[6]: +[7]: +[8]: +[9]: +[10]: +[11]: +[12]: +[13]: +[14]: +[15]: +[16]: +[17]: +[18]: +[19]: +[20]: +[21]: +[22]: +[23]: +[24]: +[25]: +[26]: +[27]: +[28]: +[29]: +[30]: +[31]: +[32]: +[33]: +[34]: +[35]: +[36]: +[37]: +[38]: +[39]: +[40]: +[41]: +[42]: +[43]: +[44]: +[45]: +[46]: