Ressourcothèque : présentation générale

Le squelette « Ressourcothèque » permet de classer, trier et retrouver des ressources documentaires.

Le besoin

Le squelette a été élaboré dans le cadre du pôle astronomie de l’association Planète Sciences, mais a été conçu de manière à être le plus générique possible.

Dans le cadre de nos activités, nous avions besoins de centraliser et trier plusieurs types de ressources documentaires :

  • fiches pédagogiques pour nos activités ;
  • support de présentation (pour conférences, exposition, etc.) ;
  • manuels de nos différents instruments ;
  • éléments de communication (logos, flyers, etc.) ;
  • etc.

Chaque ressource consiste en :

  • un titre :
  • une rapide présentation ;
  • une ou plusieurs pièces jointes.

Au sein de chacune de ces catégories, il fallait qu’on puisse trouver facilement une ressource sans présupposer de son classement. C’est pourquoi le premier mode de recherche est « Full text » : on tape un terme, et on trouve les ressources correspondantes. Cependant, il fallait également pouvoir filtrer les résultats de la recherche selon des catégories claires, et définies à l’avance, telles que :

  • tranche d’âge du public cible (pour les fiches pédagogiques) ;
  • difficulté de réalisation ;
  • cadre de réalisation ;
  • etc.

Par conséquent, chaque ressource se voit attribuer des mots-clés, classés par groupes, et qu’on peut utiliser comme filtres une fois la recherche « Full text » effectuée. En termes documentaires, il s’agit de « Facettes ».

La présente documentation concerne les fonctionnalités offertes pour la recherche côté public. Outre cette introduction générale, nous avons conçu deux articles séparés :

On pourra consulter un exemple d’utilisation de ressourcothèque.

Page d’accueil

Si le plugin Accès Restreint est activé, la page d’accueil contient un formulaire de login.

Formulaire de connexion

Une fois connecté, ou en l’absence de plugin, la liste des types de ressources disponibles apparaît.

Liste des ressources disponibles

Un clic sur le titre d’une catégorie de ressources renvoie vers la page de recherche pour cette catégorie.

Page de recherche

Une fois le lien suivi, nous arrivons sur une page pour une catégorie spécifique de ressources, ici « Fiches pédagogiques ».

Recherche dans un type de ressource

À gauche se situe le formulaire de recherche proprement dit. À droite se trouvent :

  • une rapide explication sur la recherche
  • un petit guide pour la rédaction de nouvelles ressources, avec des documents annexés.

La recherche commence donc sous le mode de recherche libre, via le formulaire.

Une fois la première recherche libre effectuée, les résultats apparaissent. La recherche inclut le contenu des pièces jointes.

Premier résultat de recherche

L’ensemble des ressources correspondantes à la recherche ’plain text’ sont affichées.
Il est possible d’utiliser les opérateurs booléens de Sphinx.

  • Par défaut, l’opérateur booléen ET est utilisé entre les mots ;
  • - pour l’opérateur booléen NON ;
  • | pour l’opérateur booléen OU ;
  • () pour combiner des termes et avoir une recherche complexe.

Toutes les ressources de la catégorie courante répondant au terme de recherche « full text » apparaissent, classées par ordre de pertinence textuelle, avec un bref aperçu de la ressource et, le cas échéant une pagination de 10 en 10.

Toutefois, il est possible d’affiner la recherche en filtrant par mot-clés (vedette). La liste des mot-clés des ressources courantes apparaît à droite. En cliquant sur la vedette, on limite la recherche aux ressources qui possèdent cette vedette. Il est possible de cumuler ainsi les filtres, avec à chaque fois un opérateur booléen ET.

Dans l’exemple ci-dessous, nous avons limité aux ressources adaptées aux 13-15 ans et au milieu scolaire.

Filtrage des résultats par mot-clé

Il est possible de desserrer le filtrage : la liste des mots-clés demandés apparaît au dessus des résultats, un clique sur un mot-clé l’efface de la demande (comme le montre la petite croix).

Page de recherche par facette

Depuis la version 2.0.0, il est possible de voir l’ensemble des ressources associées à une facette en cliquant directement sur le nom de la facette lorsqu’on accède à une catégorie de ressource.

À noter que ce mode de recherche est subsidiaire, la logique à privilégier, pour éviter la multiplication des facettes étant la recherche textuelle filtrée à postériori.

Page de présentation d’une ressource

En cliquant sur une ressource dans les résultats de la recherche, nous arrivons sur la page de présentation de ladite ressource.

Présentation d’une ressource

Les ressources sont présentées ainsi :

  • à droite, la liste des mots-clés associés à la ressource
  • au milieu la présentation proprement dite de la ressource, comprenant :
    • le titre ;
    • (un logo) ;
    • une note attribuée par les utilisateurs et utilisatrices ;
    • une présentation rapide de la ressource ;
    • si la ressource est reprise depuis une source externe, un lien vers cette source ;
    • les pièces jointes associées à cette ressources ; si plusieurs pièces jointes sont associées, un zip est automatiquement créé ;
    • le cas échéant des liens vers des ressources connexes.
    • les commentaires des utilisateurs et utilisatrices et un formulaire pour ajouter un commentaire.

Discussion

6 discussions

  • 1
    Michel Suquet

    Bonjour,

    une fois qu’on a créé des champs extras, y a-t-il un moyen de récupérer le formulaire généré pour l’utiliser avec le plugin Formidable ?

    Cela permettrait à des collègues de proposer des fiches ou des notices sur des ressources qui ne sont pas encore dans notre base de ressource.
    https://ressourcotheque.apmep.fr/

    • Ca sera un peu galère car il faudra réintégrer après cela en base de donnée. Le mieux serait de donner des accès à l’espace privé.

    Répondre à ce message

  • 12
    Michel Suquet

    Bonjour,

    nous continuons à explorer les possibilités du squelette ressourcotheque et j’ai ajouté un mot clé pour comprendre comment cela fonctionne et si c’est bien adapté à notre fonctionnement actuel avec publimath (https://publimath.univ-irem.fr/mclA.htm).

    Sur cette page : https://ressourcotheque.apmep.fr/Fiche-bac-a-sable#Mots-cles il y a une liste de mots clés et c’est le premier qui a été ajouté.

    Quand je suis dans l’interface privée, si je clique sur le lien vers ce mot-clé (mot1), j’obtiens bien la page du mot-clé.

    Par contre, si je fais la même chose dans la partie publique, j’obtiens une erreur 404 :
    https://ressourcotheque.apmep.fr/association-de-specialistes

    Voyez-vous d’où vient le problème ?

    NB1 : sur la partie gauche de la page « Fiche-bac-a-sable », il y a bien le mot-clé qui est dans un groupe essai mais ce n’est pas cliquable. Je ne sais pourquoi. Sans doute est-ce lié au même problème.

    NB2 : sur Publimath, avec le même mot-clé, on obtiens la page suivante :
    https://publimath.univ-irem.fr/publimath.php?r=%22association+de+sp%E9cialistes%22&t=n

    Cordialement,
    Michel Suquet

    • J’ai tout l’impression que vous n’avez pas ajouté vraiment le mot clé au sens SPIP, vous vous êtes contenté de recopier la liste dans l’article et à mettre un lien. Il faudrait vraiment que vous reliez l’article au mot clé (il y a un formulaire pour cela en dessous du titre).

      Cela vous permettrez de profiter pleinement de la ressourcothèque avec son système de filtre par mot clé...

    • Michel Suquet

      J’ai bien utilisé le formulaire « Ajouter un mot clé » qui permet d’ajouter un mot-clé à un article et, la preuve, c’est que dans l’article, le lien se fait ainsi : -* [association de spécialistes->mot1] et que dans l’espace privé, lorsque je clique sur le lien, j’obtiens bien la page correspondant au mot clé : https://ressourcotheque.apmep.fr/ecrire/?exec=mot&id_mot=1 qui correspond à l’url publique : https://ressourcotheque.apmep.fr/association-de-specialistes?var_mode=calcul

      Et quand je suis sur la page privée du mot1, quand je clique sur Voir en ligne, j’ai bien l’erreur 404.

      Il y a un 2^e article lié à cet article : https://ressourcotheque.apmep.fr/ACF14002.

    • C’est bien ce que je disais. Votre mot cle est cree mais n’est pas associé a votre article. Vous vous etes contentes de mettre un lien dans le corps de l’article, et pas de lier au sens fort Le mot cle a l’article

      Raison pour lequel il ne s’affiche pas cote public,..

      Je vous propose de prendre5 minutes par visio pour vous montrer comment faire cette opération...

    • Michel Suquet

      Oui, je suis disponible pour une visio.

    • Michel Suquet

      Bonjour,

      je reviens sur ce problème de mots-clés : j’ai mis en œuvre les champs extras pour les notices et aussi des groupes de mots-clés en utilisant le plugin arborescence de groupes de mot-clés mais il y a toujours ce problème d’affichage des mots-clés qui ne permettent pas la navigation.

      Par exemple :
      https://ressourcotheque.apmep.fr/Abaque-41429

      Dois-je ouvrir un ticket pour ce problème ?

      Je viens de regarder ces pages et les mots-clés sont cliquables :
      https://www.planete-sciences.org/ressources/24
      https://www.planete-sciences.org/ressources/rubrique1.html?id_rubrique=1&page=rubrique&recherche=mercure

      Je ne comprends pas comment obtenir un résultat similaire. Peut-être faut-il surcharger un fichier ?

    • Bonjour,

      la ressourcothèque de Planète Sciences utilise une version en cours de devellopement du squelette, intégrant cette navigation transversale par mot clé.

      Je compte finir ce week-end le devellopement pour y mettre également les mots clés arborescents. Je sortirai alors une version public, et vous pourrez mettre à jour le plugin et cela sera bon.

    • Michel Suquet

      Bonjour Maïeul,

      est-ce qu’on pourra passer à la version 4.2.2 de spip à cette occasion ? Il me semble que c’est la version la plus à jour.

      De mon côté, je vais aussi créer des champs extras pour les fiches de ressources.

      Merci pour ces évolutions.

    • Malheureusement non, il y a un bug dans la version 4.2 de SPIP qui empeche la compatibilité du plugin « indexer » et donc le fonctionnement de la ressourcothèque. Le bug a été corrigée dans la version de devellopement. La version 4.2.3 devrait être compatible, mais il faut attendra sa sortie.

    • Bon j’ai intégré les groupes de mot clés arborescents.

      Mais ca n’a pas été évident de le faire proprement en raison des contraintes diverses.

      Du coup je n’ai pas encore officiellement sortie la nouvelle version.
      Pouvez vous installer cette version de dev et me dire ?
      Le lien pour telecharger la version de dev
      https://git.spip.net/spip-contrib-squelettes/ressourcotheque/archive/gma.zip

    • Michel Suquet

      Bonsoir Maïeul,

      On a installé la version de développement : les mots-clés sont bien cliquables et apparaissent pour les deux rubriques qui comportent des champs extras. De ce côté, c’est bon ! Merci pour cette évolution.
      https://ressourcotheque.apmep.fr/

      Cependant, lorsqu’on met quelque chose dans le champ de recherche, s’il n’y a rien de trouver, c’est bon mais s’il y a des articles qui correspondent, il y a une erreur :
      Erreur d’exécution plugins/auto/ressourcotheque/inclure/sphinx_rubrique.html | File […]/plugins/auto/notation/v3.0.1/inc/notation_balises.php Line 25 : round(): Argument #1 ($num) must be of type int|float, string given

      Autre chose aussi : l’arborescence des mots-clés n’est pas évidente à l’affichage. Je préciserai cela dans un autre message.

    • Cependant, lorsqu’on met quelque chose dans le champ de recherche, s’il n’y a rien de trouver, c’est bon mais s’il y a des articles qui correspondent, il y a une erreur

      est-ce que ce patch résoud le problème

      https://git.spip.net/spip-contrib-extensions/notation/commit/f0ec39d6cfd685c2169cf31e3a2671e4326dd0dc

      si oui, je sortirai une release, il me semblait que ce n’était qu’un warning, mais si c’est une erreur effectivement (ca depend peut être des versions de PHP).

      Autre chose aussi : l’arborescence des mots-clés n’est pas évidente à l’affichage. Je préciserai cela dans un autre message

      ce n’est pas une arborescence de mot clé, mais de groupe de mot clé... c’est en partie ce qui rend compliqué l’affichage. Mais c’est vous qui avait choisi une arboresence de groupe de mot clé et pas de mot clé.

      Et du coup ca change la donne en terme d’affichage : si c’est une arborescence de groupe, on a des intertitres, si c’est une arborecence de mot, on a des listes imbriqués.

      Quoi qu’il en soit je pense qu’une telle évolution du plugin demanderait d’être discuté en ticket plutot qu’en forum...

    • Michel Suquet

      Le patch a résolu le problème.

      Plus précisément : il était mentionné une erreur sur une ligne en-dessous du champ de recherche mais comme il n’y avait pas le pop-up d’erreur de squelette en haut à droite, j’ai vidé le cache, purgé l’index et relancer une indexation. Et cette fois, plus d’erreur de mentionné.

      Un grand merci pour l’évolution concernant la recherche par mot-clé, cela va nous permettre d’avancer dans la structure de la base avant la migration depuis l’ancienne base.

      Pour l’arborescence des mots-clés, je vais créer un ticket.

    Répondre à ce message

  • Michel Suquet

    Pour avoir des groupes de groupes de mots-clés, j’ai installé le plugin arborescence de groupes de mots-clés mais à l’affichage, on n’a pas cette arborescence. Par exemple sur cette page :
    https://ressourcotheque.apmep.fr/Abaque-41429

    Enseignement secondaire est un sous-groupe de Niveaux et cela n’apparaît pas à l’affichage.

    Cela vient-il du squelette ressourcotheque ou du plugin arborescence de groupes de mots-clés ou d’une configuration que je n’ai pas fait ?
    Groupes de mots clés arborescents

    Répondre à ce message

  • 5
    Michel Suquet

    Bonjour,

    comme conseillé, j’ai créé des champs extras et j’ai surchargé le squelette resourcotheque pour qu’ils soient affichés mais la mise en page spip n’est pas prise en compte.

    Voici ce que cela donne :
    https://ressourcotheque.apmep.fr/Notice-bac-a-sable-bis

    J’ai mis dans la partie texte ce que je pensais que j’aurai à l’affichage des champs extras qui se retrouvent en dessous mais sans aucune mise en forme, contrairement à celle de la partie texte.
    Voici la modif faite dans la surcharge avec le fichier squelettes/content/article.html
    Ce fichier est la surcharge du fichier plugins/auto/ressourcotheque/v2.5.1/content/article.html

    <div class="main">
    		[<div class="#EDIT{chapo} chapo surlignable">(#CHAPO|adaptive_images)</div>]
    		[<div class="#EDIT{texte} texte surlignable">(#TEXTE|adaptive_images)</div>]
            [(#REM) Modification par MSu, le 26/04/2023, pour les champs extras ]
            [<h3.spip>#CHAMP_EXTRA{domaine_glossaire,label}</h3.spip>
            <div class="#EDIT{domaine_glossaire} domaine_glossaire surlignable">(#LISTER_VALEURS{domaine_glossaire}|adaptive_images)</div>]
          
            [<h3.spip>#CHAMP_EXTRA{definition_glossaire,label}</h3.spip>
            <div class="#EDIT{definition_glossaire} definition_glossaire surlignable">(#LISTER_VALEURS{definition_glossaire}|adaptive_images)</div>]
    
    		[<p class="#EDIT{hyperlien} hyperlien"><:voir_en_ligne:> : <a href="(#URL_SITE)" class="spip_out">[(#NOM_SITE|sinon{[(#URL_SITE|couper{80})]})]</a></p>]
    	</div>`

    Ma modif du squelette ne doit pas être au bon endroit. Voyez-vous comment obtenir que l’on ait la même mise en page que dans la partie texte ? Peut-on faire en sorte que les champs extras soient affichés dans la partie texte ?

    • Bonjour,

      déjà il y a une erreur, cela ne devrait pas être <h3.spip>...</h3.spip> (qui est un selecteur css), mais <h3 class="spip">...</h3>.

      La balise #LISTER_VALEURS sert uniquement si c’est un champ extra avec plusieurs valeurs disponibles (genre un bouton radio). Si c’est du champs texte, alors mettre simple #NOMDUCHAMP devrait faire l’affaire.

      Si après cela ca ne marche pas pour vous, on pourra en discuter pour que je regarde plus en détails.

    • Michel Suquet

      Je viens de modifier mais cela n’est pas encore pris en compte. Je me demande si c’est la bonne page que j’ai surchargée.

      Voici ma modification :

      <div class="main">
      		[<div class="#EDIT{chapo} chapo surlignable">(#CHAPO|adaptive_images)</div>]
      		[<div class="#EDIT{texte} texte surlignable">(#TEXTE|adaptive_images)</div>]
              [(#REM) Modification par MSu, le 26/04/2023, pour les champs extras ]
              [<h3>#CHAMP_EXTRA{domaine_glossaire,label}</h3>
              <div class="#EDIT{domaine_glossaire} domaine_glossaire surlignable">(#LISTER_VALEURS{domaine_glossaire}|adaptive_images)</div>]
            
              [<h3>#CHAMP_EXTRA{definition_glossaire,label}</h3>
              <div class="#EDIT{definition_glossaire} definition_glossaire surlignable">(#DEFINITION_GLOSSAIRE|adaptive_images)</div>]
      
      		[<p class="#EDIT{hyperlien} hyperlien"><:voir_en_ligne:> : <a href="(#URL_SITE)" class="spip_out">[(#NOM_SITE|sinon{[(#URL_SITE|couper{80})]})]</a></p>]
      	</div>

      domaine_glossaire est une liste à sélection multiple
      definition_glossaire est un champ de texte

    • Michel Suquet

      oups, avec h3 class="spip" au lieu du simple h3, cela fonctionne maintenant pour les inter-titres.

      Pour la partie texte, ce n’est pas encore bon. peut-être faut-il un class="spip" comme pour h3 ?

    • Hum, c’est étrange.

      Il se pourrait qu’il y eu un soucis lors de la configuration des champs extras.

      Peut être le mieux serait que vous m’envoyiez en privé un accès admin ?

    • Michel Suquet

      C’était bien un élément de configuration qui manquait dans les champs extras : dans technique, je n’avais pas coché Traitements des raccourcis SPIP (propre).

      Merci Maïeul, je vais pouvoir continuer à explorer les possibilités du squelette ressourcotheque.

    Répondre à ce message

  • 3

    Bonjour,

    je répond rapidement

    1. Compatiblilité 4.2 : pas testé, mais _a priori_ il n’y a pas de raison que cela ne marche pas. Juste pas le temps de mon côté de faire des tests approfondis
    2. Identifiant : vous pouvez mettre dans le surtitre c’est sûr, mais sans doute serait-il plus pertinent de créer un champs extra et de surcharger le squelettes pour afficher cela. Mais avez vous besoin de reprendre cet identifiant ? Après tout SPIP donne aussi des identifiants uniques.
    3. Configuration SPHINX et moteur de recherche : si effectivement l’indexation ne marche pas, vous ne pourrez pas faire fonctionner. Cela étant le problème de la configuration de SPHINX concerne ... SPHINX et donc je vous conseille de demander de l’aide ici plutot ... au niveau de l’article concerné. https://contrib.spip.net/Indexer-Installation-et-Configuration, en décrivant précisement ce que vous avez fait.
    4. Enfin, il ne semble pas que vous ayiez créé de mot clés sur votre site SPIP, or l’intérêt de la ressourcothèques est précisement la catégorisation par mot clé, qui permet de faire une recherche multi facette.

    • Michel Suquet

      Bonjour Maïeul,

      finalement, nous avons revu le paramétrage détaillé dans le plugin indexer (une fausse manip dans un des fichiers de conf) et maintenant, la communication avec sphinx se fait correctement.

      Cependant, il y a un bug concernant l’usage du plugin notation avec une erreur lors d’une recherche :
      Erreur d’exécution plugins/auto/ressourcotheque/v2.5.1/inclure/sphinx_rubrique.html

      Pour contourner le problème, nous avons supprimé une ligne dans le fichier plugins/auto/ressourcotheque/v2.5.1/inclure/sphinx_rubrique.html, la ligne #NOTATION_ETOILE ….

      Comme nous n’avons pas besoin de la notation pour publimath, pourrait-on faire en sorte que cette ligne soit paramétrable ? Nous ne sommes pas allé plus loin dans l’explication du bug car la notation n’a aucun intérêt pour nous.

      Cordialement,
      Michel Suquet

    • Pouvez vous ouvrir un ticket ici https://git.spip.net/spip-contrib-squelettes/ressourcotheque.git

      je vais rendre facultatif notations, et je regarderai aussi la source du bug.

    • Michel Suquet

      Ticket ouvert :
      https://git.spip.net/spip-contrib-squelettes/ressourcotheque/issues/1

      Merci pour cette modification.

    Répondre à ce message

  • Michel Suquet

    Bonjour,

    nous avons une base de ressources bibliographique (publimath) que nous souhaitons migrer vers un système plus perenne et nous avons commencé à tester wordpress et aussi spip avec votre squelette ressourcotheque.

    Pour l’instant, sur le spip qui nous sert de test, il y a 3 fiches mais la recherche ne les affiche pas. Il y a sans doute quelque chose que nous n’avons pas configuré car il y a des erreurs dans l’indexation :
    → Connexion à l’index spip via 127.0.0.1:9306 Statut : échec
    → Base SPHINX vide.

    Voici les 3 fiches présentes sur le spip d’essai :
    fiche type, fiche AAA00001, fiche AAA00002.

    Chaque fiche sur le site publimath a un identifiant unique (tel que AAA00001) que nous avons mis dans le surtitre mais ce n’est peut-être pas là qu’il faudrait le mettre. Voici les deux fiches migrées sur le site publimath :
    fiche AAA00001 et fiche AAA00002.

    Voyez-vous comment nous pourrions configurer correctement le squelette ressourcotheque ?

    NB : nous avons installé un spip en 4.0.11 car le squelette ressourcotheque n’est pas encore en 4.2 mais en 4.0. Fonctionne-t-il en 4.2 ?

    Cordialement,

    Michel Suquet

    Répondre à ce message

Ajouter un commentaire

Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparaît.

Merci d’avance pour les personnes qui vous aideront !

Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.

Qui êtes-vous ?
[Se connecter]

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.

Ajouter un document

Suivre les commentaires : RSS 2.0 | Atom