Commit 2e32c347 authored by Adrien Laporte's avatar Adrien Laporte
Browse files

MàJ site : ajout url début + fix liens cassés + page entraide

parent cab01c61
# Le convertisseur vers entraide
Le convertisseur est [disponible ici](https://framagit.org/bertille/tx-collecte-chatons/-/tree/master/conversion).
Le json converti est [disponible ici](http://chatons.picasoft.net/exports/chatons-services.json).
L'instance entraide est [disponible ici](http://chatons.picasoft.net:8000/).
## Principe
Les données récupérées par le crawler permettent de créer les fiches des Chatons pour [le site principal](https://chatons.org).
......@@ -24,3 +30,7 @@ La conversion se fait en trois étapes :
## Fonctionnalité de l'export
Nous avons pu tester que l'export ainsi obtenu fonctionnait bien en faisant tourner [le site d'entraide](https://framagit.org/chatons/entraide). Cependant, le site donne des erreurs s'il n'y a aucun fournisseur pour certains services. Nous avons donc dû ajouter à la [liste](centralisation.md) un Chaton factice, dont les données servent seulement de démonstration pour l'export entraide.
Sur notre site le convertisseur tourne juste après le [crawler](http://chatons.picasoft.net/documentation/crawler/) et le json ainsi converti est disponible à [cette adresse](http://chatons.picasoft.net/exports/chatons-services.json).
Notre instance entraide utilisant ces données est [documentée ici](http://chatons.picasoft.net/documentation/entraide/) et fonctionne en ligne à [cette adresse](http://chatons.picasoft.net:8000/).
# Le crawler
Le crawler est [disponible ici](https://framagit.org/bertille/tx-collecte-chatons/-/tree/master/crawler).
Le json agrégé est [disponible ici](http://chatons.picasoft.net/exports/chatons.json).
L'outil de recherche est [disponible ici](http://chatons.picasoft.net/search/recherche.html).
## Fonctionnement
Le crawler est un outil permettant de centraliser des données JSON contenues dans des fichiers hébergés en ligne représentant chacun un Chaton. Chaque fichier explicite les activités et les services du Chaton, qui pourront être rassemblés dans un gros fichier JSON qui sera à son tour exploité pour les recherches.
......
# Une instance entraide
Notre instance entraide est [disponible ici](http://chatons.picasoft.net:8000/).
## Qu'est-ce que c'est ?
Pour rechercher facilement un Chaton sur le seul critère des services proposé, plutôt que d'utiliser l'[outil de recherche](https://chatons.org/find) complet, il est possible d'utiliser un service simplifié et visuel : [entraide](https://entraide.chatons.org/).
En utilisant les données de description des Chatons, nous avons nous aussi monté notre [instance entraide](http://chatons.picasoft.net:8000/) en guise de *PoC*.
## Fonctionnement
Une fois le [fichier json](http://chatons.picasoft.net/exports/chatons.json) généré par le [crawler](https://framagit.org/bertille/tx-collecte-chatons/-/tree/master/crawler), il est possible de convertir ce type de json en un [autre json](http://chatons.picasoft.net/exports/chatons-services.json) contenant certes moins de données, mais l'essentiel pour l'intance entraide. Cette conversion est faite grâce à notre outil le [convertisseur](http://chatons.picasoft.net/documentation/convertisseur/).
Il ne reste plus qu'à mettre en ligne notre instance grâce à l'outil entraide, disponible sur [le framagit](https://framagit.org/chatons/entraide) des Chatons.
Notre instance est [disponible ici](http://chatons.picasoft.net:8000/).
......@@ -8,7 +8,7 @@ Quelles conventions adopter pour les clés et pour les valeurs du [schéma](sche
La question ne se pose pas vraiment pour les clés. On a deux options :
* Soit on met les clefs français, et le document est fait uniquement pour un public francophone. On perd la possibilité de [transformer les fiches en JSON-LD](jsonld).
* Soit on met les clefs français, et le document est fait uniquement pour un public francophone. On perd la possibilité de [transformer les fiches en JSON-LD](jsonld.md).
* Soit on met les clés en anglais, respectant ainsi des standards implicites et explicites, permettant aisément de LD-ifier le tout.
Sur ce sujet, la réponse est vite tranchée en faveur de clés en anglais.
......
# Un outil pour créer plus facilement la fiche d'un Chaton
Le générateur est [disponible ici](http://chatons.picasoft.net/gen/json_gen.html).
## Utilisation
Une fiche d'un Chaton ressemble à ça :
```json
......
# Un schéma JSON pour les Chatons
Le schéma le plus à jour est [disponible ici](https://framagit.org/bertille/tx-collecte-chatons/-/blob/master/schema/CHATONS_schema-0.0.2.json) (v0.0.2).
## Le JSON
Dans ce projet Tx, chaque Chaton est décrit par un fichier JSON (voir par exemple celui de [Picasoft](https://picasoft.net/picasoft.JSON)). Un fichier JSON décrit une structure de listes et d'objets définis par un système de clé-valeur. Par exemple, un Chaton a un champ `name` qui prend la valeur du nom du Chaton, un champ `url` qui prend l'URL du site du Chaton, etc. Mais un Chaton propose également une liste de services, eux aussi décris par ce formalisme, avec un champ `type`, un champ `description`...
......
......@@ -20,6 +20,7 @@ nav:
- 'Le générateur de fiche': 'generation_fiches.md'
- 'Le crawler': 'crawler.md'
- 'Le convertisseur': 'convertisseur.md'
- "L'instance entraide": 'entraide.md'
- 'Améliorations':
- 'Feuille de route': 'evolutions_futures.md'
- 'Formalisme du schéma': 'formatage_donnees.md'
......
......@@ -18,6 +18,7 @@
<li><a href="http://chatons.picasoft.net/exports/chatons.json">Le fichier regroupant tous les Chatons</a></li>
<li><a href="http://chatons.picasoft.net/exports/chatons-services.json">Le fichier des services au format entraide</a></li>
<li><a href="http://chatons.picasoft.net/search/recherche.html">L'outil de recherche d'un Chaton</a></li>
<li><a href="http://chatons.picasoft.net:8000/">L'instance entraide</a></li>
</ul>
</p>
</div>
......
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment