diff --git a/README.md b/README.md index fb35ac4e..676881f6 100644 --- a/README.md +++ b/README.md @@ -23,23 +23,23 @@ ║ ║ ╚════════════════════════════════════════════════════════════════════════════════════╝ --> -# [![mDriveOOo logo][0]][-1] Documentation +# [![mDriveOOo 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.4][4] +# version [1.0.4][6] ## Introduction: -**mDriveOOo** is part of a [Suite][5] of [LibreOffice][6] ~~and/or [OpenOffice][7]~~ extensions allowing to offer you innovative services in these office suites. +**mDriveOOo** 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 allows you to work in LibreOffice on your Microsoft oneDrive files, even while offline. 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 **mDriveOOo 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**. -mDriveOOo 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. +mDriveOOo 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 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 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 first 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. -- ![mDriveOOo logo][23] Install **[mDriveOOo.oxt][24]** extension [![Version][25]][24] +- ![mDriveOOo logo][25] Install **[mDriveOOo.oxt][26]** extension [![Version][27]][26] Restart LibreOffice / OpenOffice after installation. @@ -101,7 +101,7 @@ If you don't give **your_email@your_provider**, you will be asked for... Anonymous Urls allow you to remain anonymous (your account does not appear in the Url) while named Urls allow you to access several accounts simultaneously. -After authorizing the [OAuth2OOo][16] application to access your Microsoft OneDrive files, your OneDrive files should appear!!! normally :wink: +After authorizing the [OAuth2OOo][18] application to access your Microsoft OneDrive files, your OneDrive files should appear!!! normally :wink: ___ @@ -113,10 +113,10 @@ ___ * LibreOffice 7.4.3.2(x64) - Windows 10(x64) - Python version 3.8.15 (under Lubuntu 22.04 / VirtualBox 6.1.38) -* **Does not work with OpenOffice** see [bug 128569][26]. Having no solution, I encourage you to install **LibreOffice**. +* **Does not work with OpenOffice** see [bug 128569][28]. 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: ___ @@ -127,7 +127,7 @@ ___ - Integration and use of the new Hsqldb v2.5.1 system versioning. -- Writing of a new [Replicator][27] interface, launched in the background (python Thread) responsible for: +- Writing of a new [Replicator][29] interface, launched in the background (python Thread) responsible for: - Perform the necessary procedures when creating a new user (initial Pull). @@ -135,37 +135,37 @@ ___ - Replicate on demand all changes to the hsqldb 2.5.1 database using system versioning (Push all changes). -- Writing of a new [DataBase][28] interface, responsible for making all calls to the database. +- Writing of a new [DataBase][30] interface, responsible for making all calls to the database. -- Setting up a cache on the Identifiers, see method: [_getUser()][29], allowing access to a Content (file or folder) without access to the database for subsequent calls. +- Setting up a cache on the Identifiers, see method: [_getUser()][31], allowing access to a Content (file or folder) without access to the database for subsequent calls. -- Management of duplicate file/folder names by [SQL Views][30]: Child, Twin, Uri, and Title generating unique names if duplicates names exist. +- Management of duplicate file/folder names by [SQL Views][32]: Child, Twin, Uri, and Title generating unique names if duplicates names exist. Although this functionality is only needed for gDriveOOo, it is implemented globally... - Many other fix... ### What has been done for version 0.0.6: -- Using new scheme: **vnd-microsoft://** as claimed by [draft-king-vnd-urlscheme-03.txt][31] +- Using new scheme: **vnd-microsoft://** as claimed by [draft-king-vnd-urlscheme-03.txt][33] - Achievement of handling duplicate file/folder names by SQL views in HsqlDB: - - A [**Twin**][32] view grouping all the duplicates by parent folder and ordering them by creation date, modification date. - - A [**Uri**][33] view generating unique indexes for each duplicate. - - A [**Title**][34] view generating unique names for each duplicate. - - A recursive view [**Path**][35] to generate a unique path for each file / folder. + - A [**Twin**][34] view grouping all the duplicates by parent folder and ordering them by creation date, modification date. + - A [**Uri**][35] view generating unique indexes for each duplicate. + - A [**Title**][36] view generating unique names for each duplicate. + - A recursive view [**Path**][37] to generate a unique path for each file / folder. -- Creation of a [Provider][36] able to respond to the two types of Urls supported (named and anonymous). - Regular expressions (regex), declared in the [UCB configuration file][37], are now used by OpenOffice/LibreOffice to send URLs to the appropriate ContentProvider. +- Creation of a [Provider][38] able to respond to the two types of Urls supported (named and anonymous). + Regular expressions (regex), declared in the [UCB configuration file][39], are now used by OpenOffice/LibreOffice to send URLs to the appropriate ContentProvider. -- Use of the new UNO struct [DateTimeWithTimezone][38] provided by the extension [jdbcDriverOOo][20] since its version 0.0.4. - Although this struct already exists in LibreOffice, its creation was necessary in order to remain compatible with OpenOffice (see [Enhancement Request 128560][39]). +- Use of the new UNO struct [DateTimeWithTimezone][40] provided by the extension [jdbcDriverOOo][22] since its version 0.0.4. + Although this struct already exists in LibreOffice, its creation was necessary in order to remain compatible with OpenOffice (see [Enhancement Request 128560][41]). -- Modification of the [Replicator][27] interface, in order to allow: +- Modification of the [Replicator][29] interface, in order to allow: - To choose the data synchronization order (local first then remote or vice versa). - Synchronization of local changes by atomic operations performed in chronological order to fully support offline work. - To do this, three SQL procedures [GetPushItems][40], [GetPushProperties][41] and [UpdatePushItems][42] are used for each user who has accessed his files / folders. + To do this, three SQL procedures [GetPushItems][42], [GetPushProperties][43] and [UpdatePushItems][44] are used for each user who has accessed his files / folders. -- Rewrite of the [options window][43] accessible by: **Tools -> Options -> Internet -> mDriveOOo** in order to allow: +- Rewrite of the [options window][45] accessible by: **Tools -> Options -> Internet -> mDriveOOo** in order to allow: - Access to the two log files concerning the activities of the UCP and the data replicator. - Choice of synchronization order. - The modification of the interval between two synchronizations. @@ -181,7 +181,7 @@ Although this functionality is only needed for gDriveOOo, it is implemented glob ### What has been done for version 1.0.1: -- Implementation of the management of shared files as requested in the request for improvement, see [issue 9][44]. +- Implementation of the management of shared files as requested in the request for improvement, see [issue 9][46]. - The name of the shared folder can be defined before any connection in: **Tools -> Options -> Internet -> mDriveOOo -> Handle shared documents in folder:** @@ -207,49 +207,49 @@ Although this functionality is only needed for gDriveOOo, it is implemented glob - 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 9824c0c5..e0e0d382 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.4][4] +# version [1.0.4][6] ## Introduction: -**mDriveOOo** 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. +**mDriveOOo** 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 permet de travailler dans LibreOffice sur vos fichiers Microsoft OneDrive, même hors ligne. 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 ameliorations. -- 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 **mDriveOOo 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**. -mDriveOOo 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. +mDriveOOo 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 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 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 d'abord 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. -- ![mDriveOOo logo][23] Installer l'extension **[mDriveOOo.oxt][24]** [![Version][25]][24] +- ![mDriveOOo logo][25] Installer l'extension **[mDriveOOo.oxt][26]** [![Version][27]][26] Redémarrez LibreOffice / OpenOffice après l'installation. @@ -101,7 +101,7 @@ Si vous ne donnez pas **votre_adresse@votre_fournisseur**, elle vous sera demand Les Urls anonymes vous permettent de rester anonyme (votre compte n'apparaît pas dans l'Url) tandis que les Urls nommées vous permettent d'accéder à plusieurs comptes simultanément. -Après avoir autorisé l'application [OAuth2OOo][16] à accéder à vos fichiers de votre Microsoft OneDrive, vos fichiers OneDrive devraient apparaître!!! normalement :wink: +Après avoir autorisé l'application [OAuth2OOo][18] à accéder à vos fichiers de votre Microsoft OneDrive, vos fichiers OneDrive devraient apparaître!!! normalement :wink: ___ @@ -113,10 +113,10 @@ ___ * LibreOffice 7.4.3.2(x64) - Windows 10(x64) - Python version 3.8.15 (sous Lubuntu 22.04 / VirtualBox 6.1.38) -* **Ne fonctionne pas avec OpenOffice** voir [dysfonctionnement 128569][26]. N'ayant aucune solution, je vous encourrage d'installer **LibreOffice**. +* **Ne fonctionne pas avec OpenOffice** voir [dysfonctionnement 128569][28]. 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: ___ @@ -127,7 +127,7 @@ ___ - Intégration et utilisation de la nouvelle version de Hsqldb 2.5.1. -- Ecriture d'une nouvelle interface [Replicator][27], lancé en arrière-plan (python Thread) responsable de: +- Ecriture d'une nouvelle interface [Replicator][29], lancé en arrière-plan (python Thread) responsable de: - Effectuer les procédures nécessaires lors de la création d'un nouvel utilisateur (Pull initial). @@ -135,37 +135,37 @@ ___ - Répliquer à la demande toutes les modifications apportées à la base de données hsqldb 2.5.1 à l'aide du contrôle de version du système (Pousser toutes les modifications). -- Ecriture d'une nouvelle interface [DataBase][28], responsable de tous les appels à la base de données. +- Ecriture d'une nouvelle interface [DataBase][30], responsable de tous les appels à la base de données. -- Mise en place d'un cache sur les identifiants, voir la méthode: [_getUser()][29], autorisant l'accès à un Contenu (fichier ou dossier) sans accès à la base de données pour les appels ultérieurs. +- Mise en place d'un cache sur les identifiants, voir la méthode: [_getUser()][31], autorisant l'accès à un Contenu (fichier ou dossier) sans accès à la base de données pour les appels ultérieurs. -- Gestion des doublons des noms des fichiers / dossiers par [Vues SQL][30]: Child, Twin, Uri, et Title générant des noms uniques s'il existe des doublons. +- Gestion des doublons des noms des fichiers / dossiers par [Vues SQL][32]: Child, Twin, Uri, et Title générant des noms uniques s'il existe des doublons. Bien que cette fonctionnalité ne soit nécessaire que pour gDriveOOo, elle est implémentée globalement... - Beaucoup d'autres correctifs... ### Ce qui a été fait pour la version 0.0.6: -- Utilisation du nouveau schéma: **vnd-microsoft://** comme revendiqué par [draft-king-vnd-urlscheme-03.txt][31] +- Utilisation du nouveau schéma: **vnd-microsoft://** comme revendiqué par [draft-king-vnd-urlscheme-03.txt][33] - Aboutissement de la gestion des doublons des noms de fichiers / dossiers par des vues SQL dans HsqlDB: - - Une vue [**Twin**][32] regroupant tous les doublons par dossier parent et les ordonnant par date de création, date de modification. - - Une vue [**Uri**][33] générant des indexes uniques pour chaque doublon. - - Une vue [**Title**][34] générant des nom uniques pour chaque doublon. - - Une vue récursive [**Path**][35] pour générer un chemin unique pour chaque fichier/dossier. + - Une vue [**Twin**][34] regroupant tous les doublons par dossier parent et les ordonnant par date de création, date de modification. + - Une vue [**Uri**][35] générant des indexes uniques pour chaque doublon. + - Une vue [**Title**][36] générant des nom uniques pour chaque doublon. + - Une vue récursive [**Path**][37] pour générer un chemin unique pour chaque fichier/dossier. -- Création d'un [Provider][36] capable de répondre aux deux types d'Urls supportées (nommées et anonymes). - Des expressions régulières (regex), déclarées dans le [fichier de configuration de l'UCB][37], sont maintenant utilisées par OpenOffice/LibreOffice pour envoyer les Urls au ContentProvider approprié. +- Création d'un [Provider][38] capable de répondre aux deux types d'Urls supportées (nommées et anonymes). + Des expressions régulières (regex), déclarées dans le [fichier de configuration de l'UCB][39], sont maintenant utilisées par OpenOffice/LibreOffice pour envoyer les Urls au ContentProvider approprié. -- Utilisation de la nouvelle struct UNO [DateTimeWithTimezone][38] fournie par l'extension [jdbcDriverOOo][20] depuis sa version 0.0.4. - Bien que cette struct existe déjà dans LibreOffice, sa création était nécessaire afin de rester compatible avec OpenOffice (voir [Demande d'amélioration 128560][39]). +- Utilisation de la nouvelle struct UNO [DateTimeWithTimezone][40] fournie par l'extension [jdbcDriverOOo][22] depuis sa version 0.0.4. + Bien que cette struct existe déjà dans LibreOffice, sa création était nécessaire afin de rester compatible avec OpenOffice (voir [Demande d'amélioration 128560][41]). -- Modification de l'interface [Replicator][27], afin de permettre: +- Modification de l'interface [Replicator][29], afin de permettre: - De choisir l'ordre de synchronisation des données (locales d'abord puis distantes ensuite ou inversement). - La synchronisation des modifications locales par des opérations atomiques effectuées dans l'ordre chronologique pour supporter pleinement le travail hors ligne. - Pour ce faire, trois procédures SQL [GetPushItems][40], [GetPushProperties][41] et [UpdatePushItems][42] sont utilisées pour chaque utilisateur ayant accédé à ses fichiers / dossiers. + Pour ce faire, trois procédures SQL [GetPushItems][42], [GetPushProperties][43] et [UpdatePushItems][44] sont utilisées pour chaque utilisateur ayant accédé à ses fichiers / dossiers. -- Réécriture de la [fenêtre des options][43] accessible par : **Outils -> Options -> Internet -> mDriveOOo** afin de permettre : +- Réécriture de la [fenêtre des options][45] accessible par : **Outils -> Options -> Internet -> mDriveOOo** afin de permettre : - L'accès aux deux fichiers journaux concernant les activités de l'UCP et du réplicateur de données. - Le choix de l'ordre de synchronisation. - La modification de l'intervalle entre deux synchronisations. @@ -181,7 +181,7 @@ Bien que cette fonctionnalité ne soit nécessaire que pour gDriveOOo, elle est ### Ce qui a été fait pour la version 1.0.1: -- Mise en place de la gestion des fichiers partagés comme réclamé dans la demande d'amélioration, voir [dysfonctionnement 9][44]. +- Mise en place de la gestion des fichiers partagés comme réclamé dans la demande d'amélioration, voir [dysfonctionnement 9][46]. - Le nom du dossier partagé peut être défini avant toute connexion dans: **Outils -> Options -> Internet -> mDriveOOo -> Gérer les documents partagés dans le dossier:** @@ -207,47 +207,49 @@ Bien que cette fonctionnalité ne soit nécessaire que pour gDriveOOo, elle est - 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]: