Modèle:En/User Guide

What is Grottocenter?

GrottoCenter is a community database dedicated to speleology and fed by speleologists on the principle of Wiki, that is to say that the content of the site can be modified by all registered visitors.

It is therefore a source of speleological data, easily accessible, which is waiting for only one thing: that you complete it!

This document explains how to use Grottocenter. It is also a wiki document, so you can contribute to its update and its translation.

Managing my account

All operations on his account are accessible from this button which appears at the top right

• 

  Button indicating that you are already logged in

• 

  Button indicating that you are not connected

Create an account

Although consultation of Grottocenter does not require registration, creating an account will allow you to have access to all the functionalities and in particular to be able to complete the database with your own data, to add a topography, to correct a cavity plug etc. Creating an account is very simple: all you need is a valid email address, a username and a password of your choice.

• To do this, click on the "LOGIN" icon then on "NO ACCOUNT YET?"
• In the window that opens enter a nickname of your choice, your email address and a password of your choice (red part of the form). You can also add your first and last name if you wish (optional black part of the form).
• Finish by clicking on "REGISTER".

Recover a password

You are already registered but you have so many different passwords (that's great!) or you haven't visited Grottocenter for so long (that's not good at all!) that you forgot your password outmoded ?

• Click on "IDENTIFY" then on "FORGOT PASSWORD?"
• In the window that opens, enter your email address (the one associated with your Grottocenter account) then click on "RESET YOUR PASSWORD"
• You will receive an email with a link allowing you to choose a new password (one more to learn by heart!)

Edit my profile

Once connected to Grottocenter with your e-mail address and your password, you will be able to edit your profile to complete or rectify it.

• Click on the icon

• 

• In the menu that opens click on "My account".

La navigation sous Grottocenter

Recherche rapide

Vous cherchez une cavité, un club de spéléo, un document, des infos sur un massif karstique ?

En haut à gauche de votre page (près d'une icône loupe) une zone de saisie intitulée "Recherche rapide" vous tend les bras.

• Cliquez dessus puis saisissez un ou plusieurs mot-clefs significatifs.
• Une liste déroulante s'affiche alors avec toutes les réponses obtenues, choisissez celle qui vous convient en cliquant dessus.
• Si votre mot-clef est trop court vous verrez apparaître le message "Pas de résultat (entrez au moins trois caractères)". Afin de contourner la difficulté ajoutez-y un ou des espaces vides à la suite et vous obtiendrez alors un résultat. Par exemple si vous recherchez la "Grotte de l'os", tapez "os + espace"
• Pour des noms composés il vous faudra souvent être un peu plus précis. Par exemple si vous recherchez la "Grotte du Bois de l'âne" il vous faudra saisir "bois de l'âne".

Que faire si votre recherche est plus complexe ou plus précise ou si la recherche rapide ne vous donne pas satisfaction ?

Dans ce cas passez au mode "Recherche avancée".

Rechercher avancée

Le menu recherche avancée donne accès à une fenêtre avec un onglet par entité. Il faut selectionner l'entité sur laquelle on souhaite faire sa recherche

Vous pouvez faire une recherche sur les entrées, les organisations, les massifs ou les documents

Pour chaque entités des champs spécifiques permettent de préciser votre recherche.

Le résultat apparait dans un tableau, il est possible de le télécharger au format csv, avec une limite de 10000 lignes par fichier

Mode carte

En cliquant sur le menu carte vous allez pouvoir afficher sur la carte certaines entités enregistrées dans Grottocenter. Il est possible de masque le menu de gauche pour visualiser la carte, presque, en plein écran.

En autorisant Grottocenter a accéder à votre localisation, un point vous localisant apparaitra sur la carte et la carte se centrera sur ce point.

Actuellement il est possible de visualiser les entrées, les réseaux et les organisations. Pour les entrées et les réseaux ils apparaissent sous forme de losanges correspondant à un groupe (un cluster),jusqu'à ce que vous ayez suffisamment zoomé. La localisation précise est alors visible.

Trois fonds de carte sont disponibles.

Les entités gérées par Grottocenter

Les documents

La gestion des documents s'appuie sur le BBS (Bulletin Bibliographique Spéléologique), une coopération internationale portée par la commission Bibliographique de l'UIS. Un mode d'emploi spécifique, pour contrituer au BBS sur Grottocenter est disponible

Différentes informations sont associées à chaque document. Commençons par les découvrir :

• Le type : c'est une manière de regrouper des documents qui ont des caractéristiques communes. Quand vous voulez enregistrer un nouveau document il faut commencer par choisir le type, ce qui permettra ensuite de vous donner accès aux informations que vous allez pouvoir saisir pour ce type particulier de document. Dans Grottocenter nous avons retenu les types définis dans Karstlink
• Le nom du document
• La langue du document. Dans Grottocenter vous pouvez choisir parmi un peu plus de 250 langues, qui sont des langues officielles dans au moins un pays. Pour simplifier la saisie Grottocenter vous proposera par défaut la langue que vous utilisez pour Grottocenter.
• Le résumé : il joue un rôle essentiel pour permettre de retrouver ce document avec l'outil de recherche. Merci de le rédiger sous forme de phrases contenant les mots clés du document (nom de lieu, de personne, de cavité).
• Le document parent : pour les document de type Numéro il est souhaitable d'indiquer la Collection dont il fait partie (Par exemple le n° 65 se Spelunca fait partie de la collection Spelunca). De la même manière pour un article il est important d'indiquer le Numéro dont il est extrait (Par exemple l'éditorial était dans le numéro 65 de Spelunca). Ces liens sont essentiels car la page de la collection donne accès a tous les numéro et la page de chaque numéro permet de voir les articles dont ils sont issus.
• Le fichier : il est possible d'insérer un document dans Grottocenter sans télécharger le fichier correspondant. Il sera alors décrit par ses métadonnées. Il est possible de télécharger le fichier correspondant à un document dans la mesure ou :

1. il a pour extension un de celles qui sont autorisées
2. vous êtes l'auteur, l'auteur est décédé depuis plus de 70 ans, un document déjà enregistré dans Grottocenter (de type autorisation de publication) atteste qu'il est possible de l'enregistrer dans Grottocenter
3. vous avez choisi une licence si vous êtes l'auteur, vous choisissez la licence retenue par la personne ou l'organisation qui a donné l'autorisation d'enregistrer sur Grottocenter. Pour les auteurs décédé depuis plus de 70 ans la licence à retenir est CC BY. Pour les fichiers téléchargés vous pouvez choisir parmi les licences proposées par Karstlink. Attention : les licences CC conviennent pour le contenu soumis au droit d'auteur, les autres au contenu non soumis au droit d'auteur.

Les organisations

Grottocenter vous donne accès à des informations sur des organisations très variées :

• Club ou fédération de spéléologie
• Organisations qui ont édité des document décrit dans Grottocenter (l'éditeur du document)
• Groupement de personnes ayant conduit une expédition
• Organisme de formation ou de recherche
• Bibliothèques hébergeant des collection de documents liés au milieu souterrain
• Organismes gérant des sites Karstiques.

Afin de simplifier l'accès aux informations et permettre une maintenance plus aisée, on évitera de créer une organisation pour un sous groupe qui n'a pas de coordonnées distinctes de l'organisation dont fait partie ce sous-groupe. Par exemple on maintiendra a jour l'organisation Fédération Française de Spéléologie et on lui associera tous les documents, quand ils sont produits par une commission de la FFS

Les massifs

Un massif est une unité géographique distincte des unités administratives (région, département, commune). Les utilisateurs sont libres de construire des massifs en fonction de leurs besoins, ils peuvent répondre à différents besoins :

• Définir des secteurs d'étude, pour les spéléologues
• Définir un bassin versant pour le travail lié à l'étude des écoulements d'eau
• Définir une zone protégée ou gérée par un organisme

Les personnes

Dans Grottocenter vous allez rencontrer deux types de personnes :

• Les utilisateurs qui ont créé un compte, qui peuvent contribuer et qui peuvent être déclaré par d'autres utilisateurs comme étant auteur d'un document décrit dans Grottocenter
• Les auteurs qui n'ont pas de compte sur Grottocenter mais qui ont été créés par un utilisateur afin de pouvoir les déclarer comme auteur d'un document décrit dans Grottocenter.

Accéder aux données de Grottocenter

Pour les personnes

Les données de Grottocenter sont accessibles à l'adresse https://grottocenter.org

Elles disposent toutes d'une URL qui restera la même au fil du temps. Cela permet de créer depuis d'autres sites des liens permanents. Chaque personne, organisation, massif, document dispose donc de sa propre URL qui sera perenne. En voici quelques exemples :

• Le gouffre Jean Bernard, première cavité enregistrée dans la base de données, est accessible à l'URL https://grottocenter.org/ui/entrances/1.
• L'article "Whalemouth Cave trip" paru dans "The Western Caver" est accessible à l'adresse https://grottocenter.org/ui/documents/100000
• La "British Caving Association" est accessible à l'adresse https://grottocenter.org/ui/organizations/675
• Vous pouvez également accéder à des données sur le plateau du Vercors ici https://grottocenter.org/ui/massifs/1

Pour les machines

D'autres sites que Grottocenter peuvent utiliser les données dont nous disposons. C'est possible grâce aux APIs qui permettent de chercher et de lire les données sans se connecter. Les opérations correspondant à des traitements sur la base de donnée nécessitent d'être authentifié.

Vous pouvez intégrer des appels à ces APIs dans vos propres applications. L'URL est stable, elle ne serait modifiée que s'il s’avérait un jour nécessaire de changer complètement de modèle dans une nouvelle version de Grottocenter. Des éléments ont été rajoutés afin de permettre à des serveurs SPARQL de les utiliser (Spécifications Json LD), dans le cadre du projet Karstlink

La documentation est disponible ici https://grottocenter.org/ui/api

Glossaire :

API est l'acronyme d'"Application Programming Interface" ("Interface de Programmation d'Application"). C'est une solution informatique qui permet à des applications de communiquer entre elles et de s'échanger mutuellement des services ou des données.

SPARQL est l'acronyme de "Sparql Protocol And RDF Query Language". il s'agit d'un langage de requête et un protocole qui permet de rechercher, d'ajouter, de modifier ou de supprimer des données RDF (Resource Description Framework) disponibles à travers Internet.