Skip to content

Commit

Permalink
README*.md update
Browse files Browse the repository at this point in the history
  • Loading branch information
prrvchr committed Jan 26, 2024
1 parent 9181a02 commit c233ce2
Show file tree
Hide file tree
Showing 3 changed files with 45 additions and 39 deletions.
35 changes: 19 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,13 +33,15 @@

## Introduction:

**mContactOOo** 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 Microsoft Outlook contacts.
**mContactOOo** 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 Microsoft Outlook contacts.
It uses [Microsoft Graph API][10] to synchronize your remote Microsoft Outlook contacts into a local HsqlDB 2.7.2 database.

Being free software I encourage you:
- To duplicate its [source code][10].
- To duplicate its [source code][11].
- To make changes, corrections, improvements.
- To open [issue][11] if needed.
- To open [issue][12] if needed.

In short, to participate in the development of this extension.
Because it is together that we can make Free Software smarter.
Expand All @@ -49,18 +51,18 @@ ___
## Requirement:

The mContactOOo extension uses the OAuth2OOo extension to work.
It must therefore meet the [requirement of the OAuth2OOo extension][12].
It must therefore meet the [requirement of the OAuth2OOo extension][13].

The mContactOOo extension uses the jdbcDriverOOo extension to work.
It must therefore meet the [requirement of the jdbcDriverOOo extension][13].
It must therefore meet the [requirement of the jdbcDriverOOo extension][14].

**On Linux and macOS the Python packages** used by the extension, if already installed, may come from the system and therefore **may not be up to date**.
To ensure that your Python packages are up to date it is recommended to use the **System Info** option in the extension Options accessible by:
**Tools -> Options -> Internet -> mContactOOo -> View log -> System Info**
If outdated packages appear, you can update them with the command:
`pip install --upgrade <package-name>`

For more information see: [What has been done for version 1.1.0][14].
For more information see: [What has been done for version 1.1.0][15].

___

Expand All @@ -79,10 +81,10 @@ If necessary, rename it before installing it.

- ![mContactOOo logo][25] Install **[mContactOOo.oxt][26]** extension version [![Version][27]][26]

Restart LibreOffice after installation.

**On Windows, restarting LibreOffice may not be enough.**
To ensure that LibreOffice restarts correctly, use the Windows Task Manager to verify that no LibreOffice services are visible after LibreOffice is shut down.
Restart LibreOffice after installation.
**Be careful, restarting LibreOffice may not be enough.**
- **On Windows** to ensure that LibreOffice restarts correctly, use Windows Task Manager to verify that no LibreOffice services are visible after LibreOffice shuts down (and kill it if so).
- **Under Linux or macOS** you can also ensure that LibreOffice restarts correctly, by launching it from a terminal with the command `soffice` and using the key combination `Ctrl + C` if after stopping LibreOffice, the terminal is not active (no command prompt).

___

Expand Down Expand Up @@ -222,11 +224,12 @@ It will give you access to an information system that only larges companies are
[7]: <https://prrvchr.github.io/>
[8]: <https://www.libreoffice.org/download/download/>
[9]: <https://www.openoffice.org/download/index.html>
[10]: <https://github.com/prrvchr/mContactOOo>
[11]: <https://github.com/prrvchr/mContactOOo/issues/new>
[12]: <https://prrvchr.github.io/OAuth2OOo/#requirement>
[13]: <https://prrvchr.github.io/jdbcDriverOOo/#requirement>
[14]: <https://prrvchr.github.io/mContactOOo/#what-has-been-done-for-version-110>
[10]: <https://learn.microsoft.com/en-us/graph/outlook-contacts-concept-overview>
[11]: <https://github.com/prrvchr/mContactOOo>
[12]: <https://github.com/prrvchr/mContactOOo/issues/new>
[13]: <https://prrvchr.github.io/OAuth2OOo/#requirement>
[14]: <https://prrvchr.github.io/jdbcDriverOOo/#requirement>
[15]: <https://prrvchr.github.io/mContactOOo/#what-has-been-done-for-version-110>
[17]: <https://prrvchr.github.io/OAuth2OOo/img/OAuth2OOo.svg#middle>
[18]: <https://prrvchr.github.io/OAuth2OOo/>
[19]: <https://github.com/prrvchr/OAuth2OOo/releases/latest/download/OAuth2OOo.oxt>
Expand Down
35 changes: 19 additions & 16 deletions README_fr.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,13 +33,15 @@

## Introduction:

**mContactOOo** 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 Microsoft Outlook.
**mContactOOo** 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 Microsoft Outlook.
Elle utilise [l'API Microsoft Graph][10] pour synchroniser vos contacts Microsoft Outlook distant dans une base de données locale HsqlDB 2.7.2.

Etant un logiciel libre je vous encourage:
- A dupliquer son [code source][10].
- A dupliquer son [code source][11].
- A apporter des modifications, des corrections, des améliorations.
- D'ouvrir un [dysfonctionnement][11] si nécessaire.
- D'ouvrir un [dysfonctionnement][12] si nécessaire.

Bref, à participer au developpement de cette extension.
Car c'est ensemble que nous pouvons rendre le Logiciel Libre plus intelligent.
Expand All @@ -49,18 +51,18 @@ ___
## Prérequis:

L'extension mContactOOo utilise l'extension OAuth2OOo pour fonctionner.
Elle doit donc répondre aux [prérequis de l'extension OAuth2OOo][12].
Elle doit donc répondre aux [prérequis de l'extension OAuth2OOo][13].

L'extension mContactOOo utilise l'extension jdbcDriverOOo pour fonctionner.
Elle doit donc répondre aux [prérequis de l'extension jdbcDriverOOo][13].
Elle doit donc répondre aux [prérequis de l'extension jdbcDriverOOo][14].

**Sous Linux et macOS les paquets Python** utilisés par l'extension, peuvent s'il sont déja installé provenir du système et donc, **peuvent ne pas être à jour**.
Afin de s'assurer que vos paquets Python sont à jour il est recommandé d'utiliser l'option **Info système** dans les Options de l'extension accessible par:
**Outils -> Options -> Internet -> mContactOOo -> Voir journal -> Info système**
Si des paquets obsolètes apparaissent, vous pouvez les mettre à jour avec la commande:
`pip install --upgrade <package-name>`

Pour plus d'information voir: [Ce qui a été fait pour la version 1.1.0][14].
Pour plus d'information voir: [Ce qui a été fait pour la version 1.1.0][15].

___

Expand All @@ -79,10 +81,10 @@ Si nécessaire, renommez-le avant de l'installer.

- ![mContactOOo logo][25] Installer l'extension **[mContactOOo.oxt][26]** [![Version][27]][26]

Redémarrez LibreOffice après l'installation.

**Sous Windows, redémarrer LibreOffice peut ne pas suffire.**
Pour vous assurer que LibreOffice redémarre correctement, utilisez le Gestionnaire de tâche de Windows pour vérifier qu'aucun service LibreOffice n'est visible après l'arrêt de LibreOffice.
Redémarrez LibreOffice après l'installation.
**Attention, redémarrer LibreOffice peut ne pas suffire.**
- **Sous Windows** pour vous assurer que LibreOffice redémarre correctement, utilisez le Gestionnaire de tâche de Windows pour vérifier qu'aucun service LibreOffice n'est visible après l'arrêt de LibreOffice (et tuez-le si ç'est le cas).
- **Sous Linux ou macOS** vous pouvez également vous assurer que LibreOffice redémarre correctement, en le lançant depuis un terminal avec la commande `soffice` et en utilisant la combinaison de touches `Ctrl + C` si après l'arrêt de LibreOffice, le terminal n'est pas actif (pas d'invité de commande).

___

Expand Down Expand Up @@ -222,11 +224,12 @@ Elle vous donnera accès à un système d'information que seules les grandes ent
[7]: <https://prrvchr.github.io/README_fr>
[8]: <https://fr.libreoffice.org/download/telecharger-libreoffice/>
[9]: <https://www.openoffice.org/fr/Telecharger/>
[10]: <https://github.com/prrvchr/mContactOOo>
[11]: <https://github.com/prrvchr/mContactOOo/issues/new>
[12]: <https://prrvchr.github.io/OAuth2OOo/README_fr#pr%C3%A9requis>
[13]: <https://prrvchr.github.io/jdbcDriverOOo/README_fr#pr%C3%A9requis>
[14]: <https://prrvchr.github.io/mContactOOo/README_fr#ce-qui-a-%C3%A9t%C3%A9-fait-pour-la-version-110>
[10]: <https://learn.microsoft.com/en-us/graph/outlook-contacts-concept-overview>
[11]: <https://github.com/prrvchr/mContactOOo>
[12]: <https://github.com/prrvchr/mContactOOo/issues/new>
[13]: <https://prrvchr.github.io/OAuth2OOo/README_fr#pr%C3%A9requis>
[14]: <https://prrvchr.github.io/jdbcDriverOOo/README_fr#pr%C3%A9requis>
[15]: <https://prrvchr.github.io/mContactOOo/README_fr#ce-qui-a-%C3%A9t%C3%A9-fait-pour-la-version-110>
[17]: <https://prrvchr.github.io/OAuth2OOo/img/OAuth2OOo.svg#middle>
[18]: <https://prrvchr.github.io/OAuth2OOo/README_fr>
[19]: <https://github.com/prrvchr/OAuth2OOo/releases/latest/download/OAuth2OOo.oxt>
Expand Down
14 changes: 7 additions & 7 deletions source/mContactOOo/requirements.txt
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
dateutil>=2.8.2
decorator>=5.1.1
ijson>=3.2.3
packaging>=23.2
setuptools>=69.0.3
six>=1.16.0
validators>=0.22.0
dateutil==2.8.2
decorator==5.1.1
ijson==3.2.3
packaging==23.2
setuptools==69.0.3
six==1.16.0
validators==0.22.0

0 comments on commit c233ce2

Please sign in to comment.