diff --git a/doc/source/administrator/configuration/base_de_donnees.md b/doc/source/administrator/configuration/base_de_donnees.md index 7774e5ed8f0c6a1c9b0f9e4ebb29d3e29778dfa4..c99ac0169889c46d75b31e06e3863a43cc0c502c 100644 --- a/doc/source/administrator/configuration/base_de_donnees.md +++ b/doc/source/administrator/configuration/base_de_donnees.md @@ -2,7 +2,7 @@ Les informations suivantes ne sont pas modifiables : elles sont décidées durant [l'installation de vMap](../../installation/index.rst). -- **SGBD** : nom du système de gestion de base de données sur lequel est installé vMap -- **Serveur** : nom du serveur sur lequel est installé vMap -- **Port** : port du serveur utilisé par vMap -- **Base de données** : nom de la base de données PostgreSQL de vMap +- **SGBD** : nom du système de gestion de base de données sur lequel est installé vMap2 +- **Serveur** : nom du serveur sur lequel est installé vMap2 +- **Port** : port du serveur utilisé par vMap2 +- **Base de données** : nom de la base de données PostgreSQL de vMap2 diff --git a/doc/source/administrator/configuration/index.rst b/doc/source/administrator/configuration/index.rst index 0b0c0335bdfc0ae717bd9063537bf31cebc7514b..234de604f6f6e991ebbe9f712bf252c94f4f9dbc 100644 --- a/doc/source/administrator/configuration/index.rst +++ b/doc/source/administrator/configuration/index.rst @@ -3,7 +3,7 @@ Mode Configuration -------------- -La configuration générale de vMap présente 3 sous-sections : +La configuration générale de vMap2 présente 3 sous-sections : ============================================ diff --git a/doc/source/administrator/configuration/informations_generales.md b/doc/source/administrator/configuration/informations_generales.md index 1edfb3a1eddfd043a797b3526d79b3da790675d2..c1e097a69d642615b09397e5017619070fc8e70e 100644 --- a/doc/source/administrator/configuration/informations_generales.md +++ b/doc/source/administrator/configuration/informations_generales.md @@ -2,7 +2,7 @@ Cette sous-section du [mode Configuration](./index.rst) présente un ensemble d'options : -- **Langue** : la langue d'affichage de vMap (Français - par défaut - ; Anglais) +- **Langue** : la langue d'affichage de vMap2 (Français - par défaut - ; Anglais) - **Afficher uniquement un bouton dans les grilles** : si "Oui", un seul bouton est affiché dans les tableaux (il s'agit du bouton avec le plus de permissions, généralement celui d'édition). Si "Non", plusieurs bouton peuvent être affichés dans une grille (généralement un bouton pour la consultation, un pour l'édition) @@ -11,7 +11,7 @@ Cette sous-section du [mode Configuration](./index.rst) présente un ensemble d' - **Nombre de lignes par page** : nombre de lignes maximum affichées dans chaque page d'un tableau (par défaut : 20) -- **Autoriser "Se souvenir de moi"** : affiche l'option "Se souvenir de moi" sur la page de connexion de vMap +- **Autoriser "Se souvenir de moi"** : affiche l'option "Se souvenir de moi" sur la page de connexion de vMap2 - **Valeur par défaut de "Se souvenir de moi"** : indique si cette option est par défaut activée ou désactivée diff --git a/doc/source/administrator/configuration/interface.md b/doc/source/administrator/configuration/interface.md index 188530dad3515c8cc5a7691d842ce5d64d557208..3f5ee5dea44d0ceac59d6aa42168a6a7ef2dcad4 100644 --- a/doc/source/administrator/configuration/interface.md +++ b/doc/source/administrator/configuration/interface.md @@ -2,7 +2,7 @@ ## Général -Le champ présent vous permet de modifier le texte affiché sur la section latérale gauche de la page de connexion de vMap. +Le champ présent vous permet de modifier le texte affiché sur la section latérale gauche de la page de connexion de vMap2. Le langage de balisage utilisé est le [Markdown](https://www.markdownguide.org/basic-syntax/). diff --git a/doc/source/administrator/configuration/journaux.md b/doc/source/administrator/configuration/journaux.md index 3a2f32be97f537193e66c6655807ea4ddd2fec9b..2361511de5c2923efab9f53c68654a862608672b 100644 --- a/doc/source/administrator/configuration/journaux.md +++ b/doc/source/administrator/configuration/journaux.md @@ -1,6 +1,6 @@ # Journaux -Trois options sont présentes concernant les logs des traitements lancés avec vMap : +Trois options sont présentes concernant les logs des traitements lancés avec vMap2 : - **Période de journalisation** : intervalle de collecte des messages (Mois - par défaut -, Jour) diff --git a/doc/source/administrator/configuration/serveur_php.md b/doc/source/administrator/configuration/serveur_php.md index 56f84da412a8d9e2b367712b1265de21f0fb864d..322aae0c28e63be8dd45cdb42f56a37293b369d5 100644 --- a/doc/source/administrator/configuration/serveur_php.md +++ b/doc/source/administrator/configuration/serveur_php.md @@ -1,6 +1,6 @@ # Serveur PHP -- **URL de l'API** : adresse web pour accéder à l'[API](../api/api.md) de vMap. Champ non modifiable +- **URL de l'API** : adresse web pour accéder à l'[API](../api/api.md) de vMap2. Champ non modifiable - **Taille maximale des fichiers envoyés sur le serveur en Mo** : pour que la propriété soit valable, il faut vérifier dans le fichier *php.ini* que la valeur de *upload_max_filesize* soit supérieure - **Durée maximale d'exécution des services PHP en secondes** - **Mémoire vive maximale pour les services PHP en Mo** diff --git a/doc/source/administrator/index.rst b/doc/source/administrator/index.rst index 78b51e9376549b27697ff5a9c0fe137303b2277e..7a0597ebe75125886b9e6c58e4a1426161cc9caf 100644 --- a/doc/source/administrator/index.rst +++ b/doc/source/administrator/index.rst @@ -1,9 +1,9 @@ -Documentation de vMap pour les administrateurs +Documentation de vMap2 pour les administrateurs ============================================ -------------- -Il est conseillé aux administrateurs de consulter en premier la `Documentation de vMap pour les utilisateurs <../user/index.html>`_ afin de se familiariser avec les outils disponibles sur le composant cartographique. +Il est conseillé aux administrateurs de consulter en premier la `Documentation de vMap2 pour les utilisateurs <../user/index.html>`_ afin de se familiariser avec les outils disponibles sur le composant cartographique. ============================================ diff --git a/doc/source/administrator/users.md b/doc/source/administrator/users.md index 685cde8c4cb0613977fafe9646af7992b425a996..adf9887b6d21852bfc45c244a66a620a6320efc0 100644 --- a/doc/source/administrator/users.md +++ b/doc/source/administrator/users.md @@ -1,6 +1,6 @@ # Mode Utilisateurs -vMap offre à l'administrateur la possibilité de gérer les droits à plusieurs niveaux. +vMap2 offre à l'administrateur la possibilité de gérer les droits à plusieurs niveaux. Les privilèges changent l'affichage de l'interface en donnant accès ou non à différents modes et objets. @@ -8,11 +8,11 @@ Les groupes quant à eux permettent d'accéder a certains traitements FME. ## Gestion des utilisateurs -Un utilisateur vMap est un compte connu par l’application vMap et qui peut se connecter pour utiliser ses services. +Un utilisateur vMap2 est un compte connu par l’application vMap2 et qui peut se connecter pour utiliser ses services. Deux profils d’utilisateurs sont à distinguer : -- **Utilisateurs locaux** : utilisateurs authentifiés par la base de données interne à vMap, PostgreSQL, créés directement dans vMap -- **Utilisateurs externes (importés depuis l'AD ou LDAP)** : utilisateurs d’un domaine et authentifiés par un annuaire Active Directory, importés dans vMap +- **Utilisateurs locaux** : utilisateurs authentifiés par la base de données interne à vMap2, PostgreSQL, créés directement dans vMap2 +- **Utilisateurs externes (importés depuis l'AD ou LDAP)** : utilisateurs d’un domaine et authentifiés par un annuaire Active Directory, importés dans vMap2 Les utilisateurs peuvent être gérés et listés via l'objet **Utilisateurs** dans l'interface. @@ -124,14 +124,14 @@ La synchronisation est à activer dans la [configuration](./configuration/active ### Privilèges Vitis -Les privilèges préfixés par **vitis_** correspondent aux droits propres du socle de développement Vitis, sur lequel repose vMap : +Les privilèges préfixés par **vitis_** correspondent aux droits propres du socle de développement Vitis, sur lequel repose vMap2 : - **vitis_user** : permet de se connecter à l'application et de configurer son utilisateur. -- **vitis_admin** : permet l'accès aux modes pour gérer les utilisateurs, domaines, groupes, jetons de connexions, logs, modèles d'email, interface et configuration de l'application. Il a en charge la gestion des paramètres système et de la configuration de vMap. Il accède également dans le mode **API** à la documentation relative à l'API de vMap. +- **vitis_admin** : permet l'accès aux modes pour gérer les utilisateurs, domaines, groupes, jetons de connexions, logs, modèles d'email, interface et configuration de l'application. Il a en charge la gestion des paramètres système et de la configuration de vMap2. Il accède également dans le mode **API** à la documentation relative à l'API de vMap2. - **vitis_shared** : permet de gérer l'arborescence du dossier **shared**, qui est un dossier partagé entre plusieurs utilisateurs pour partager des ressources. -### Privilèges vMap +### Privilèges vMap2 Todo @@ -147,7 +147,7 @@ L'administrateur doit connaitre le mot de passe de l'utilisateur pour générer  -Le jeton pourra ensuite être exploité dans l'application par les widgets de vMap. +Le jeton pourra ensuite être exploité dans l'application par les widgets de vMap2. ```{Note} diff --git a/doc/source/autres/studio.md b/doc/source/autres/studio.md index d3b91c58e3df32596fd9267b9e808c063f8495a4..f85040745089a4e8321ddf82ea5d8fd7d9a1006f 100644 --- a/doc/source/autres/studio.md +++ b/doc/source/autres/studio.md @@ -1,29 +1,29 @@ -# Utilisation du studio de formulaire dans vMap (WIP) +# Utilisation du studio de formulaire dans vMap2 (WIP) ## Généralités -Le studio vMap est l'un des points forts de l'application, .... +Le studio vMap2 est l'un des points forts de l'application, ....  ## Sources de données -Dans les formulaires vMap il est possible de faire apparaître des listes déroulantes. +Dans les formulaires vMap2 il est possible de faire apparaître des listes déroulantes. - + Pour que ces dernières fonctionnent et pour définir leur contenu il faudra définir des **sources de données**. Ces dernières sont accessibles via le bouton portant le même nom et afficheront le gestionnaire permettant l'édition, l'ajout ou la suppression. - + -Sur vMap plusieurs types de sources sont disponibles : +Sur vMap2 plusieurs types de sources sont disponibles : * **Texte** correspond à de la donnée en dur qui est stocké dans le formulaire -* **Valeur d'une table locale** utilisera la connexion de l'utilisateur pour récupérer des données contenues sur le Postgres hébergeant vMap +* **Valeur d'une table locale** utilisera la connexion de l'utilisateur pour récupérer des données contenues sur le Postgres hébergeant vMap2 * **Base de données externe** permettra de récupérer le contenu d'une table distante sur Postgres ou Oracle en utilisant une connexion fournie * **API externe** donne la possibilité d'utiliser le résultat d'une API publique (exemple BAN) -* **Service Web** permet d'utiliser l'API de vMap +* **Service Web** permet d'utiliser l'API de vMap2  @@ -45,10 +45,10 @@ Pour ce faire il faudra aller dans la section `Options avancées` > `Valeur` et  Analysons cette expression : -* `=` signifie à vMap qu'il s'agit d'une expression dynamique. +* `=` signifie à vMap2 qu'il s'agit d'une expression dynamique. * `'EPSG:'` correspond à la première partie du résultat voulu, vous remarquerez que l'expression est entourée par des simple quottes car il s'agit d'une chaîne de caractères. * ` + ` sert à la concaténation. -* `{{srid}}` srid correspond au nom du paramètre publié auquel nous faisons référence, les accolades permettent de dire à vMap qu'il faut remplacer le contenu par la valeur du champ. +* `{{srid}}` srid correspond au nom du paramètre publié auquel nous faisons référence, les accolades permettent de dire à vMap2 qu'il faut remplacer le contenu par la valeur du champ. ### Visibilité des champs diff --git a/doc/source/changelog/2022.01.00/changelog.md b/doc/source/changelog/2022.01.00/changelog.md index ea829fd40eb698d514280c7eb8e69c368986755a..37bf4fd39f5822494173be9c980bbfc21438cbd0 100644 --- a/doc/source/changelog/2022.01.00/changelog.md +++ b/doc/source/changelog/2022.01.00/changelog.md @@ -1,4 +1,4 @@ -# vMap 2022.01.00 +# vMap2 2022.01.00 ## Evolutions diff --git a/doc/source/changelog/index.rst b/doc/source/changelog/index.rst index 36583bce4e0d546b80f1e066c7de906ec15d368a..6a9499c928eaf1e7b93ba36ed438577552ba752a 100644 --- a/doc/source/changelog/index.rst +++ b/doc/source/changelog/index.rst @@ -1,4 +1,4 @@ -Évolutions de vMap +Évolutions de vMap2 ============================================ .. toctree:: diff --git a/doc/source/credits.md b/doc/source/credits.md index b4491616d7fa67b532dd7db0cd54909ce85e749b..299d237630d123974e3057f7b8832f09c0909b10 100644 --- a/doc/source/credits.md +++ b/doc/source/credits.md @@ -1,13 +1,13 @@ # Crédits -## vMap +## vMap2 -vMap est une application développée et éditée par [Veremes](https://www.veremes.com). +vMap2 est une application développée et éditée par [Veremes](https://www.veremes.com). ## Marques déposées FME® est une marque déposée de Safe Software Inc. Tous les produits et marques sont des marques ou marques déposées de leurs entreprises ou organisations respectives. ## OpenStreetsMap -Dans le cas des affichages cartographiques dans l'application vMap, les données sont sous licence ODbL (Open Database License) et les cartes sous la licence CC BY-SA. +Dans le cas des affichages cartographiques dans l'application vMap2, les données sont sous licence ODbL (Open Database License) et les cartes sous la licence CC BY-SA. [© les contributeurs d’OpenStreetMap](https://www.openstreetmap.org/copyright) diff --git a/doc/source/images/logos/vMap/cutout/vMap2.png b/doc/source/images/logos/vMap/cutout/vMap2.png new file mode 100644 index 0000000000000000000000000000000000000000..60e56212d33b706bb66c8897cdadd3506b3abf3d Binary files /dev/null and b/doc/source/images/logos/vMap/cutout/vMap2.png differ diff --git a/doc/source/index.rst b/doc/source/index.rst index 053cff2a6a3a17dcb392eaa1127f73523ebd4f09..09055a4e18f7392bab94b81e934c9428fe4ffedb 100644 --- a/doc/source/index.rst +++ b/doc/source/index.rst @@ -1,18 +1,18 @@ -Documentation de vMap +Documentation de vMap2 ============================================ -.. image:: /images/logos/vMap/cutout/vMap.png +.. image:: /images/logos/vMap/cutout/vMap2.png :height: 200 px :width: 200 px :align: center :target: # -vMap est une application web qui permet de centraliser, partager et documenter les traitements FME. +vMap2 est une application web qui permet de centraliser, partager et documenter les traitements FME. Il s'agit une solution simple pour offrir un accès à FME à tous les membres d’une organisation et résoudre les problèmes de dispersion et de maintenance des projets FME. -Chaque utilisateur de vMap dispose de son environnement de travail personnel qui lui permet d’exécuter des projets FME ou de planifier leur exécution régulière. Les administrateurs disposent des fonctions de publication et de supervision nécessaires à la surveillance et à l’optimisation du service. +Chaque utilisateur de vMap2 dispose de son environnement de travail personnel qui lui permet d’exécuter des projets FME ou de planifier leur exécution régulière. Les administrateurs disposent des fonctions de publication et de supervision nécessaires à la surveillance et à l’optimisation du service. ============================================ diff --git a/doc/source/installation/installation.md b/doc/source/installation/installation.md index 52d7f2ba05dd31340e17916b3c58064397345466..2bd13098675b081cad59b0a47fa295871410055b 100644 --- a/doc/source/installation/installation.md +++ b/doc/source/installation/installation.md @@ -68,7 +68,7 @@ Les clés dans *users* seront utilisées comme identifiants. En fonction des inf L’installateur de vMap assure les opérations suivantes : - Copie du code du serveur d’application Vitis -- Copie du code du moteur Vvitis +- Copie du code du moteur Vitis - Installation et configuration de l'exécutable JobsRunner comme un service - Installation de PHP et de pupeeter - Installation de mapserver diff --git a/doc/source/installation/miseAJour.md b/doc/source/installation/miseAJour.md index e465ce11e16273b0c311a108e34ebcf667a67fa3..6ab8006b52a0e5d28bcc197a431332dd77ab55c2 100644 --- a/doc/source/installation/miseAJour.md +++ b/doc/source/installation/miseAJour.md @@ -2,7 +2,7 @@ ## Téléchargement du fichier d'installation -Pour mettre à jour vMap, téléchargez le .zip correspondant à votre système d'exploitation sur le <a href="https://vstore.veremes.net/vstore/dashboard/documents" target="_blank">vStore</a> : +Pour mettre à jour vMap2, téléchargez le .zip correspondant à votre système d'exploitation sur le <a href="https://vstore.veremes.net/vstore/dashboard/documents" target="_blank">vStore</a> : - Sélectionnez la version et le système d'exploitation correspondant @@ -27,11 +27,11 @@ Les variables à modifier pour l'installation sont les suivantes : +-----------------------+--------------------------------------------------------------------------------------------------------+ | Variable | Description | +=======================+========================================================================================================+ -| API_ALIAS | Alias pour accéder à l'API de vMap (par défaut : /rest) | +| API_ALIAS | Alias pour accéder à l'API de vMap2 (par défaut : /rest) | +-----------------------+--------------------------------------------------------------------------------------------------------+ -| APP_ALIAS | Alias pour accéder au client de vMap (par défaut : /vmap) | +| APP_ALIAS | Alias pour accéder au client de vMap2 (par défaut : /vmap) | +-----------------------+--------------------------------------------------------------------------------------------------------+ -| WMS_ALIAS | Alias pour accéder au Mapserver de vMap (par défaut : /mws) | +| WMS_ALIAS | Alias pour accéder au Mapserver de vMap2 (par défaut : /mws) | +-----------------------+--------------------------------------------------------------------------------------------------------+ | HTTPSERVER_PATH | Chemin jusqu'au répertoire d'Apache24 (C:/.../Apache24/conf pour windows et /etc/apache2 pour linux) | +-----------------------+--------------------------------------------------------------------------------------------------------+ @@ -82,7 +82,7 @@ Les clés dans *users* seront utilisées comme identifiants. En fonction des inf L’installateur de vMap assure les opérations suivantes : - Copie du code du serveur d’application Vitis -- Copie du code du moteur Vvitis +- Copie du code du moteur Vitis - Installation et configuration de l'exécutable JobsRunner comme un service - Installation de PHP et de pupeeter - Installation de mapserver diff --git a/doc/source/installation/prerequis.md b/doc/source/installation/prerequis.md index 851879903689ad4f6a5b7ac18fbd839f45e54e95..c000275b81b3f4d5d182c92154cbb5e13d65d6da 100644 --- a/doc/source/installation/prerequis.md +++ b/doc/source/installation/prerequis.md @@ -30,7 +30,7 @@ ### Installation d'Apache 2.4 -vMap utilise le protocole sécurisé HTTPS qui assure le cryptage des échanges entre le Serveur d’Application Vitis et le poste client. +vMap2 utilise le protocole sécurisé HTTPS qui assure le cryptage des échanges entre le Serveur d’Application Vitis et le poste client. Il est donc nécessaire d’installer une version spécifique du serveur HTTP Apache compilé avec le module SSL. @@ -41,7 +41,7 @@ Il est donc nécessaire d’installer une version spécifique du serveur HTTP Ap ### Installation de PostgreSQL -vMap utilise une base PostgreSQL pour stocker les informations sur les projets FME et les demandes de traitement ainsi que sur les utilisateurs et leurs droits. +vMap2 utilise une base PostgreSQL pour stocker les informations sur les projets FME et les demandes de traitement ainsi que sur les utilisateurs et leurs droits. Si PostgreSQL est déjà installé sur votre poste, cette étape est facultative. diff --git a/doc/source/introduction/composants.md b/doc/source/introduction/composants.md index d767ff3b154d4523cfdab9b601ade62ed8116777..34e7853bb76fa52d4a2175d5b7363168c88689aa 100644 --- a/doc/source/introduction/composants.md +++ b/doc/source/introduction/composants.md @@ -1,4 +1,4 @@ -# Composants logiciels de vMap +# Composants logiciels de vMap2 ## Liste des composants <table align="center" class="docutils" border="1"> @@ -17,7 +17,7 @@ <tbody valign="middle"> <tr class="row-even"> <td> - vMap Client + vMap2 Client </td> <td> Applications Web permettant aux utilisateurs l’accès aux services vMap @@ -74,12 +74,12 @@ ## Composants importants -### vMap Client +### vMap2 Client Todo ### API REST -L'API REST de vMap permet à n'importe quelle application de faire appel aux services de vMap de manière transparente pour les utilisateurs. +L'API REST de vMap permet à n'importe quelle application de faire appel aux services de vMap2 de manière transparente pour les utilisateurs. C'est la solution idéale pour les développeurs souhaitant offrir leur propre interface graphique. diff --git a/doc/source/introduction/index.rst b/doc/source/introduction/index.rst index e7a3c89a37e05d19756a77f7c9ec137e1f5186d9..cd35795deaeafc5e615fc1c25b92c7d4b8a264a6 100644 --- a/doc/source/introduction/index.rst +++ b/doc/source/introduction/index.rst @@ -1,4 +1,4 @@ -Présentation de vMap +Présentation de vMap2 ============================================ .. toctree:: diff --git a/doc/source/introduction/introduction.md b/doc/source/introduction/introduction.md index d19d765938f8aa1c8c09ace06fb2783bd4a95afb..cc2ffb9823ba2384c01275fa9f1a31e7ee32901c 100644 --- a/doc/source/introduction/introduction.md +++ b/doc/source/introduction/introduction.md @@ -1,5 +1,5 @@ -# Présentation de vMap +# Présentation de vMap2 vMap2 est un logiciel de Web-SIG open-source porté et développé par Veremes, il se base sur des technologies libres solides telles que Postgresql / PostGIS ou Mapserver. diff --git a/doc/source/premiersPas/roles.md b/doc/source/premiersPas/roles.md index a0c906b9a81dec71fd43bf414a946e4096f00d40..d9ba310bb836c6a0238de5e4683c8697f691e942 100644 --- a/doc/source/premiersPas/roles.md +++ b/doc/source/premiersPas/roles.md @@ -1,6 +1,6 @@ # Comprendre les différents rôles -Plusieurs profils d’utilisateurs sont amenés à utiliser vMap. Ceci se traduit par trois rôle distincts, aux privilèges différents. +Plusieurs profils d’utilisateurs sont amenés à utiliser vMap2. Ceci se traduit par trois rôle distincts, aux privilèges différents. ## Utilisateur @@ -15,7 +15,7 @@ L'administrateur est en charge de la gestion de l’application. Cet individu se charge de l’exploitation de l’application ainsi que de la gestion des utilisateurs et des rôles. L'administrateur a accès aux modes suivants : -- vMap +- vMap2 - Administration - *[Utilisateurs](../administrator/users.md)* - *[Configuration](../administrator/configuration/index.md)* diff --git a/doc/source/user/index.rst b/doc/source/user/index.rst index 0079911690443972ae7f9bb3c309e40b09581641..ab0b7043641c30817e881ba68ee53a6c1bf25446 100644 --- a/doc/source/user/index.rst +++ b/doc/source/user/index.rst @@ -1,11 +1,11 @@ -Documentation de vMap pour les utilisateurs +Documentation de vMap2 pour les utilisateurs ============================================ -------------- -Cette partie de la documentation s'adresse aux **utilisateurs**. Elle est néanmoins aussi utile pour les `administrateurs <../administrator/index.html>`_ pour appréhender ce rôle et les fonctionnalités de base de vMap. +Cette partie de la documentation s'adresse aux **utilisateurs**. Elle est néanmoins aussi utile pour les `administrateurs <../administrator/index.html>`_ pour appréhender ce rôle et les fonctionnalités de base de vMap2. -L'utilisateur a accès au mode *Carto* permettant d'accéder aux fonctionnalités de base de vMap. +L'utilisateur a accès au mode *Carto* permettant d'accéder aux fonctionnalités de base de vMap2. ============================================