{
    "title": "gestion des classes de documents YamlDoc (ydclasses)",
    "abstract": "### Définition de classes de documents\nUne classe de documents correspond à:\n  \n  - une classe Php implémentant:\n    - des méthodes de consultation interactive du document,\n    - une API de consultation en machine to machine,\n    - une API Php d'utilisation du document en interne à YamlDoc.\n  - éventuellement un schéma défini par un [schéma JSON](https://json-schema.org/),\n",
    "spec": "A une classe {yamlClass} correspond:\n  \n  - un éventuel fichier ~/html/yamldoc/ydclasses/{yamlClass}.sch.yaml définissant le schéma JSON\n  - une classe Php {yamlClass} définie dans un fichier {yamlClassInt}.inc.php\n    où {yamlClassInt} est un nom interne utilisé pour le fichier Php\n  \nLe fichier {yamlClassInt}.inc.php est inclus dans différent script, notamment le viewer, il doit:\n  \n  - définir une entrée de la variable globale `$phpDocs` pour la valeur {yamlClassInt}.inc.php qui doit comprendre :\n    - une entrée `file` fournissant une documentation texte sur le fichier Php\n    - une entrée `classes` avec une entrée par classe définie fournissant une documentation texte sur la classe Php\n\nLa classe Php {yamlClass}:\n  \n  - doit hériter de la classe YamlDoc, sauf les classes OdtDoc et PdfDoc qui héritent de la classe Doc.  \n",
    "uriUrl": "### Définition des URI et URL\n- `http://ydclasses.georef.eu/{yamlClass}` est l'URI d'une classe de documents YamlDoc,  \n  exemple: [`http://ydclasses.georef.eu/YData`](http://ydclasses.georef.eu/YData),  \n- la résolution de l'URI d'une classe fournit comme doc HTML une documentation de la classe\n  avec des liens vers le schéma de la classe en Yaml et en JSON,\n- les URL suivantes sont déduites de l'URI d'une classe:\n  - `http://ydclasses.georef.eu/{yamlClass}/schema` fournit le schéma de la classe en JSON,  \n    cet URI est utilisé dans le champ `$schema` d'un document pour définir sa classe,\n  - `http://ydclasses.georef.eu/{yamlClass}/schema.yaml` fournit le schéma de la classe en Yaml,\n  - `http://ydclasses.georef.eu/{yamlClass}/api` décrit l'API REST de la classe en OAI et en Yaml (A FAIRE),\n- ces résolutions sont mises en oeuvre par un résolveur exposé sur ~/html/yamldoc/ydclasses.php\n  \n",
    "liste": "Les classes générales définies sont les suivantes:\n  \n  - [Doc](?action=version&doc=yamldoc&name=yamldoc.inc.php) - classe abstraite correspondant à un document\n    affichable ;\n  - [YamlDoc](?action=version&doc=yamldoc&name=yamldoc.inc.php) - classe abstraite correspondant à un document Yaml ;\n  - [BasicYamlDoc](?action=version&doc=yamldoc&name=basicyamldoc.inc.php) - document simple,\n    comme par exemple le présent document ;\n  - [YamlCatalog](?action=version&doc=yamldoc&name=catalog.inc.php) - catalogue de documents,\n    comme par exemple le [document d'accueil](?doc=index) de cet espace ;\n  - [YamlHomeCatalog](?action=version&doc=yamldoc&name=catalog.inc.php) - catalogue d'accueil ;\n  - [YamlData](?action=version&doc=yamldoc&name=yamldata.inc.php) - gestion des données,\n    comme par exemple la [liste des régions historisées](?doc=geohisto/regions) ;\n  - [MultiData](?action=version&doc=yamldoc&name=multidata.inc.php) pour décomposer une grande table\n    en sous-tables stockées chacune dans un sous-document ;\n  - [YData](?action=version&doc=yamldoc&name=ydata.inc.php) pour la gestion des données (EN CONSTRUCTION),\n    illustré par la [synthèse des principaux champs Dublin Core](?doc=dublincore) ;\n  - [YamlRdf](?action=version&doc=yamldoc&name=yamlrdf.inc.php) - gestion d'un graphe RDF ;\n  - [YamlSkos](?action=version&doc=yamldoc&name=yamlskos.inc.php) - gestion d'un thésaurus Skos\n    organisé en micro-thésaurus,\n    comme par exemples le [thésaurus EuroVoc](?doc=eurovoc) ou le [lexique topographique](?doc=topovoc) de l'AFT ;\n  - [DataModel](?action=version&doc=yamldoc&name=datamodel.inc.php) - gestion d'un modèle de données\n    UML comme extension d'un YamlSkos,\n    comme par exemple le [modèle de données Inspire déduit du règlement interopérabilité](?doc=inspire-datamodel) ;\n  - [LegalDoc]((?action=version&doc=yamldoc&name=legaldoc.inc.php)) - gestion d'un texte juridique,\n    comme par exemple la [directive Inspire](?doc=inspire-directive) ;\n  - [OdtDoc](?action=version&doc=yamldoc&name=odtdoc.inc.php) - affichage de fichiers ODT ;\n  - [PdfDoc](?action=version&doc=yamldoc&name=pdfdoc.inc.php) - affichage de fichiers PDF ;\n  - [Servreg](?action=version&doc=yamldoc&name=servreg.inc.php) - registre de serveurs ;\n  - [AutoDescribed](?action=version&doc=yamldoc&name=autodescr.inc.php) - données structurées selon un schema ;\n  - [InseeApi](?action=version&doc=yamldoc&name=inseeapi.inc.php) - classe abstraite facilitant l'accès aux API INSEE\n  - [SireneApi](?action=version&doc=yamldoc&name=sireneapi.inc.php) - utilisation l'API SIRENE ;\n  - [InseeNomApi](?action=version&doc=yamldoc&name=inseenomapi.inc.php) - Utilisation de l'API INSEE Nomenclatures V1\n  \nLes classes spécifiques à la gestion de l'information géographique sont les suivantes:\n  \n  - [Map](?action=version&doc=yamldoc&name=map.inc.php) - description et affichage d'une carte Leaflet,\n    illustré par [la carte des vignes et vergers](?doc=maps/vignes) ;\n  - [MarkerLib](?action=version&doc=yamldoc&name=markerlib.inc.php) - gestion d'une bibliothèque de symboles\n    ponctuels utilisés dans les cartes,\n    illustrée par cette [bibliothèque](?doc=markerlib) ;\n  - [FeatureDataset](?action=version&doc=yamldoc&name=featureds.inc.php) - document définissant une série de données\n    géographiques d'objets vecteur,\n    illustré par [Route500](?doc=geodata/route500) ou la [BDTopo](?doc=geodata/bdtopo) de l'IGN.\n  - [OgcServer](?action=version&doc=yamldoc&name=ogcserver.inc.php) - classe abstraite implémentant des méthodes\n    communes aux serveurs OGC ;\n  - [WfsServer](?action=version&doc=yamldoc&name=wfsserver.inc.php) - classe abstraite de gestion de requêtes\n    à un serveur WFS ;\n  - [WfsServerJson](?action=version&doc=yamldoc&name=wfsjson.inc.php) - gestion de requêtes à un serveur WFS\n    capable de générer du GeoJSON,\n    illustré par le [serveur WFS du Géoportail IGN](?doc=geodata/igngpwfs) ;\n  - [WfsServerJsonAugmented](?action=version&doc=yamldoc&name=wfsjson.inc.php) - gestion de requêtes\n    à un serveur WFS capable de générer du GeoJSON modifiant les retours des requêtes WFS ;\n  - [WfsServerGml](?action=version&doc=yamldoc&name=wfsgml.inc.php) - serveur WFS capable de générer\n    du GML EPSG:4306 ;\n  - [Geocat](?action=version&doc=yamldoc&name=geocat.inc.php) - accès au contenu d'un géocatalogue,\n    illustré par [le catalogue de Sextant](?doc=geocats/sextant)\n  - [CswServer](?action=version&doc=yamldoc&name=cswserver.inc.php) - gestion de requêtes à un serveur CSW,\n    illustré par le [serveur SigLoire](?doc=geocats/sigloirecsw) ;\n  - [MetadataDb](?action=version&doc=yamldoc&name=mddb.inc.php) - base de données de Metadata utilisée par Geocat,\n    illustrée par [la base des MD de Sextant](?doc=geocats/sextant/db) ;\n  - [SubjectList](?action=version&doc=yamldoc&name=gcsubjlist.inc.php) - gestion des mots-clés d'un géocatalogue,\n    utilisée par Geocat, illustrée par [les mots-clés des MD de Sextant](?doc=geocats/sextant/subjects) ;\n  - [iTileServer](?action=version&doc=yamldoc&name=itileserver.inc.php) n'est pas une classe mais une interface\n    qui définit l'interface des serveurs WMS, WMTS, TileServer et FeatureViewer utilisés par ViewDataset.\n  - [WmsServer](?action=version&doc=yamldoc&name=wmsserver.inc.php) - utilisation d'un serveur WMS,\n    illustré par [le serveur WMS-R du Géoportail](?doc=view/igngpwmsr) ;\n  - [WmtsServer](?action=version&doc=yamldoc&name=wmtsserver.inc.php) - utilisation d'un serveur WMTS,\n    illustré par [le serveur WMTS du Géoportail](?doc=view/igngpwmts) ;\n  - [TileServer](?action=version&doc=yamldoc&name=tileserver.inc.php) - utilisation d'un serveur de tuiles\n    utilisant [le protocole XYZ popularisé par OSM](https://en.wikipedia.org/wiki/Tiled_web_map),\n    illustré par [le serveur ShomGt](?doc=view/shomgt_tile) ;\n  - [FeatureViewer](?action=version&doc=yamldoc&name=featureviewer.inc.php) - dessin des objets d'un FeatureDataset\n    illustrée par [la visualisation des objets de Route500](?doc=geodata/route500viewer) ;\n  - [TileCache](?action=version&doc=yamldoc&name=tilecache.inc.php) - Cache de tuiles implémentant l'interface\n    iTileServer ;\n  - [ViewDataset](?action=version&doc=yamldoc&name=viewds.inc.php) - série de données de consultation constituée\n    de couches issues de serveurs conformes à l'interface iTileServer\n\nLa liste efectivement implémentée est disponible [ici](ydclasses.php)."
}