Différences entre versions de « Vignette »

De WIKI-BOKEH
Aller à : navigation, rechercher
(ajout images)
 
(29 versions intermédiaires par 6 utilisateurs non affichées)
Ligne 7 : Ligne 7 :
 
[[Fichier:Vignette_url_vignette_inspector_gadget.png|800px|center|texte descriptif]]
 
[[Fichier:Vignette_url_vignette_inspector_gadget.png|800px|center|texte descriptif]]
  
Lorsque vous inspectez une notice et voyez affiché "NO" à "Url vignette" c'est que Bokeh n'a pas trouver de vignette. Il n'en cherchera pas tant que le "réinitialiser le cache des images non trouvées" ne sera pas cliqué (Dans Administratin > Cache des images: toutes les vignettes à NO sont mises à vide). Vous pouvez aussi forcer la recherche de la vignette à nouveau en cliquant sur le bouton "Générer la vignette" sous la vignette en étant connecté en administrateur portail. Il n'y a pas de notion de tâche de fond pour ces traitements, tout est fait en direct. Voir [[Cache_des_images]]
+
Lorsque vous inspectez une notice et voyez affiché "NO" à "Url vignette" c'est que Bokeh n'a pas pu trouver de vignette. Il n'en cherchera pas tant que le "réinitialiser le cache des images non trouvées" ne sera pas cliqué (Dans Administration > Cache des images: toutes les vignettes à NO sont mises à vide). Vous pouvez aussi forcer la recherche de la vignette à nouveau en cliquant sur le bouton "Générer la vignette" sous la vignette en étant connecté en administrateur portail. Il n'y a pas de notion de tâche de fond pour ces traitements, tout est fait en direct. Voir [[Cache_des_images]]
  
 
[[Fichier:Vignette_bouton_generer.png|100px|center|texte descriptif]]
 
[[Fichier:Vignette_bouton_generer.png|100px|center|texte descriptif]]
Ligne 13 : Ligne 13 :
 
== Détermination ==
 
== Détermination ==
  
Le pronom "il sera utilisé" pour identifier indiférentiemment Bokeh et le Serveur de Cache dans le paragraphe suivant.
+
Lorsque votre SIGB exporte l'url des vignettes dans l'unimarc transmis à Bokeh, vous pouvez paramétrer le profil de données correspondant pour spécifier des zones dans lesquelles chercher ces urls.
  
* Code source [1 https://git.afi-sa.net/afi/opacce/blob/master/library/Class/Notice/Thumbnail/ProviderFactory.php#L26]  
+
[[Fichier:Cosmo data profile thumbs.png]]
  
* <Article> Si c'est un article, il prend la première image de l'article et en fait une vignette
+
'''Attention''' : Ce paramètre est prioritaire sur toutes les autres détections et l'url de la vignette sera mise à jour à chaque import d'une notice même unimarc. Il correspond donc au cas où vous souhaitez vous assurer que la vignette dans Bokeh soit toujours celle fournie par votre SIGB.
* <Album> Si c'est un album de la ressource numérique, prend la vignette liée à l'album:  
 
** si l'album est de type Livre (codif type de doc ex: ePub), alors la gestion se fait de la même manière qu'une gestion de notice livre en passant par le Serveur de cache.
 
** sinon on prend la première image d'album (vignette de l'album ou première image du diaporama)
 
* <Site> Si c'est un site, il fait une photo du site et la rend disponible en vignette.
 
* <ThirdParty> Dans les paramétrages on peut définir une zone Unimarc à utiliser en vignette. Celle-ci proviendra du SIGB et sera utilisée en priorité sur le CacheServer.
 
* <RecordWithAlbum> Si c'est une notice qui a un lien FRBR avec un album, le media est uploadé côté Bokeh, il prend la vignette de l'album comme étant la vignette de la notice.
 
Attention donc si des modifications de types de documents sont faites, l'url FRBR changera également.
 
  
* <CacheServer> si le type de doc de la notice est associé à une famille du serveur de cache  (Livre, Périodique, Sonore, Vidéo, Logiciel) et que la vignette n'a pas été récupérée par une méthode précédente, alors une demande est faite au serveur de cache. S'il en trouve une correspondante dans sa base de données, il l'affiche. Sinon il essaye de la déterminer selon les sources possibles.
+
Bokeh détermine la source possible de la vignette d'une notice selon l'ordre suivant en fonction du type de notice :
[https://git.afi-sa.net/afi/opacce/blob/master/library/Class/WebService/AllServices.php#L119 Informations stockées sur la vignette dans le serveur de cache] qui vont permettre de l'identifier. La vignette est ainsi stockée avec des informations et rendue à tous les Bokeh qui en auraient besoin.
+
* Pour un article Bokeh, la vignette est tirée de la première image présente dans le contenu de l'article
 +
* Pour un album de la bibliothèque numérique Bokeh, la vignette est la première image trouvée parmi:
 +
** les médias de type image liés à l'album
 +
** la vignette de l'album lui-même
 +
** l'information de poster s'il s'agit d'une ressource numérique moissonnée
 +
* Pour un site de la sitothèque Bokeh et si un service de vignettage de site est actif, Bokeh demande la vignette à ce dernier
  
* Code source [1 https://git.afi-sa.net/afi/websvc/blob/master/php/classes/classe_image_notice.php#L372]
+
De plus, si la mécanique par type de notice n'a pas détecté de vignette
 +
* S'il existe une zone Unimarc à utiliser en vignette paramétrée pour le type de document de la notice, Bokeh détecte la première image fournie dans cette zone.
 +
* S'il s'agit d'une notice liée par FRBR avec au moins un album de la bibliothèque numérique, Bokeh détecte la vignette de l'album en lui-même, sinon la première image trouvée parmi les médias de type image de l'album lié.
 +
 
 +
Enfin, Bokeh interroge le serveur de cache d'enrichissements en transmettant les critères:
 +
* le titre principal
 +
* l'auteur principal
 +
* l'ISBN
 +
* l'EAN
 +
* la famille de document
 +
* le numéro ou volume
 +
 
 +
Le serveur de cache identifie avec l'isbn ou l'ean s'ils sont fournis, puis par titre/auteur, puis par numéro.
 +
 
 +
S'il en trouve une correspondante dans sa base de données, il l'affiche.
 +
 
 +
Sinon il essaye de la déterminer selon les sources possibles.
 +
 
 +
[https://git.afi-sa.net/afi/opacce/blob/master/library/Class/WebService/AllServices.php#L119 Informations stockées sur la vignette dans le serveur de cache] qui vont permettre de l'identifier.
 +
 
 +
La vignette est ainsi stockée avec des informations et rendue à tous les Bokeh qui en auraient besoin.
 +
 
 +
* [https://git.afi-sa.net/afi/websvc/blob/master/php/classes/classe_image_notice.php#L372 Code source]
 +
 
 +
== Fournisseur de vignettes ==
 +
 
 +
Votre organisation a pu souscrire un abonnement à un fournisseur de notices comportant l'image de couverture des documents.
 +
 
 +
Dans ce cas Bokeh vous permet de spécifier les accès à cet abonnement afin de renseigner l'url de la vignette à partir des informations de votre fournisseur de notices.
 +
 
 +
[[Fichier:Admin var pellicule.png]]
 +
 
 +
Le service supporté pour l'instant Electre NG.
 +
 
 +
Il n'est pas possible de paramétrer plus d'un fournisseur de notice.
  
 
== Faq ==
 
== Faq ==
 +
=== Quels utilisateurs peuvent modifier les vignettes? ===
 +
 +
N'importe quel utilisateur ayant accès à l'interface d'administration de Bokeh peut modifier les vignettes des documents
 +
Le niveau d'accès "Rédacteur Bibliothèque" est donc le niveau minimal pour modifier les vignettes.
  
 
=== Pourquoi malgré tout, mes vignettes ne s'affichent pas ===
 
=== Pourquoi malgré tout, mes vignettes ne s'affichent pas ===
  
 
Nous dépendons, avec ces méthodes, de ressources externes non libres. Actuellement des blocages et limitations de plus en plus fortes sont mises en place par ces serveurs. La meilleure solution est que chaque médiathèque prenne un peu de temps pour enrichir le cache collectif sur les vignettes non trouvées. Vous pouvez ainsi envoyer de simples photos des couvertures prises à la médiathèque.
 
Nous dépendons, avec ces méthodes, de ressources externes non libres. Actuellement des blocages et limitations de plus en plus fortes sont mises en place par ces serveurs. La meilleure solution est que chaque médiathèque prenne un peu de temps pour enrichir le cache collectif sur les vignettes non trouvées. Vous pouvez ainsi envoyer de simples photos des couvertures prises à la médiathèque.
 +
 +
=== La vignette n'est pas visible or le serveur de cache en a une dans inspector gadget ===
 +
 +
Les requêtes au serveur de cache de vignette s'effectue selon la "famille" de documents. Ceci est paramétrable dans l'administration Bokeh, menu Catalogues > Types de documents. Il faut donc affecter une famille au type de document partition.
 +
 +
=== Validité des url ===
 +
 +
Pour être valide, l'url de vignette renseignée doit répondre à l'une au moins de ces exigences :
 +
 +
* finir par une extension de format d'image valide pour bokeh à savoir '''png, jpg, jpeg, gif ou webp'''
 +
* faire référence à une image Koha en contenant la chaine : '/cgi-bin/koha/opac-image.pl?thumbnail='
 +
* faire référence à une image 'adav-assoc.com'
 +
* faire référence à une image 'dam_picture.php?id'
 +
* faire appel à un script 'getimage.php'
 +
* contenir la chaîne 'assets.edenlivres.fr'
 +
* contenir la chaîne 'vignette.indexpresse.fr'
 +
 +
=== Comment réinitialiser les vignettes des ressources numériques ? ===
 +
 +
Nous avons ajouté des outils à l'écran d'administration "Types de documents" pour pouvoir réinitialiser les vignettes pour un type de document donné. Lorsque les vignettes pour un type de documents sont réinitialisées, lors de l'affichage en recherche pour une ressource numérique, la vignette sera de nouveau téléchargée du fournisseur de la ressource #104766
 +
 +
Aller dans Administration > "type de documents > Cliquer sur le bouton "Réinitialiser les images ..." (bouton encadré de vert ci-dessous) Ce traitement va être réalisé immédiatement. Les vignettes sont en fait supprimées et Bokeh est forcé de les "re-télécharger".
 +
 +
[[Fichier:Typedoc-reinitialiser.png]]
 +
 +
La "famille du document" doit être à "non identifié" afin que la réinitialisation aille chercher en local et non dans le serveur de cache. (encadré en jaune)Vous pouvez modifier cette valeur avec le "bouton crayon" sur la page <URL_Bokeh>/admin/type-docs.
  
 
== Autres pages ==
 
== Autres pages ==
Ligne 41 : Ligne 103 :
 
* [[Cache_des_images]]
 
* [[Cache_des_images]]
  
[[Catégorie:Administration]]
+
[[Catégorie:Interface_publique]]

Version actuelle datée du 4 octobre 2022 à 15:07

Une vignette est l'image affichée sur une notice. Elle est déterminée selon un algorithme. Un logiciel que nous avons développé permet de rendre disponible à tous les Bokeh les vignettes capitalisées par tous. En enrichissant votre catalogue d'images, vous permettez à d'autres bibliothèques de les afficher et participez ainsi à un effort communautaire global.

texte descriptif

Recherche et stockage des vignettes[ ]

texte descriptif

Lorsque vous inspectez une notice et voyez affiché "NO" à "Url vignette" c'est que Bokeh n'a pas pu trouver de vignette. Il n'en cherchera pas tant que le "réinitialiser le cache des images non trouvées" ne sera pas cliqué (Dans Administration > Cache des images: toutes les vignettes à NO sont mises à vide). Vous pouvez aussi forcer la recherche de la vignette à nouveau en cliquant sur le bouton "Générer la vignette" sous la vignette en étant connecté en administrateur portail. Il n'y a pas de notion de tâche de fond pour ces traitements, tout est fait en direct. Voir Cache_des_images

texte descriptif

Détermination[ ]

Lorsque votre SIGB exporte l'url des vignettes dans l'unimarc transmis à Bokeh, vous pouvez paramétrer le profil de données correspondant pour spécifier des zones dans lesquelles chercher ces urls.

Cosmo data profile thumbs.png

Attention : Ce paramètre est prioritaire sur toutes les autres détections et l'url de la vignette sera mise à jour à chaque import d'une notice même unimarc. Il correspond donc au cas où vous souhaitez vous assurer que la vignette dans Bokeh soit toujours celle fournie par votre SIGB.

Bokeh détermine la source possible de la vignette d'une notice selon l'ordre suivant en fonction du type de notice :

  • Pour un article Bokeh, la vignette est tirée de la première image présente dans le contenu de l'article
  • Pour un album de la bibliothèque numérique Bokeh, la vignette est la première image trouvée parmi:
    • les médias de type image liés à l'album
    • la vignette de l'album lui-même
    • l'information de poster s'il s'agit d'une ressource numérique moissonnée
  • Pour un site de la sitothèque Bokeh et si un service de vignettage de site est actif, Bokeh demande la vignette à ce dernier

De plus, si la mécanique par type de notice n'a pas détecté de vignette

  • S'il existe une zone Unimarc à utiliser en vignette paramétrée pour le type de document de la notice, Bokeh détecte la première image fournie dans cette zone.
  • S'il s'agit d'une notice liée par FRBR avec au moins un album de la bibliothèque numérique, Bokeh détecte la vignette de l'album en lui-même, sinon la première image trouvée parmi les médias de type image de l'album lié.

Enfin, Bokeh interroge le serveur de cache d'enrichissements en transmettant les critères:

  • le titre principal
  • l'auteur principal
  • l'ISBN
  • l'EAN
  • la famille de document
  • le numéro ou volume

Le serveur de cache identifie avec l'isbn ou l'ean s'ils sont fournis, puis par titre/auteur, puis par numéro.

S'il en trouve une correspondante dans sa base de données, il l'affiche.

Sinon il essaye de la déterminer selon les sources possibles.

Informations stockées sur la vignette dans le serveur de cache qui vont permettre de l'identifier.

La vignette est ainsi stockée avec des informations et rendue à tous les Bokeh qui en auraient besoin.

Fournisseur de vignettes[ ]

Votre organisation a pu souscrire un abonnement à un fournisseur de notices comportant l'image de couverture des documents.

Dans ce cas Bokeh vous permet de spécifier les accès à cet abonnement afin de renseigner l'url de la vignette à partir des informations de votre fournisseur de notices.

Admin var pellicule.png

Le service supporté pour l'instant Electre NG.

Il n'est pas possible de paramétrer plus d'un fournisseur de notice.

Faq[ ]

Quels utilisateurs peuvent modifier les vignettes?[ ]

N'importe quel utilisateur ayant accès à l'interface d'administration de Bokeh peut modifier les vignettes des documents Le niveau d'accès "Rédacteur Bibliothèque" est donc le niveau minimal pour modifier les vignettes.

Pourquoi malgré tout, mes vignettes ne s'affichent pas[ ]

Nous dépendons, avec ces méthodes, de ressources externes non libres. Actuellement des blocages et limitations de plus en plus fortes sont mises en place par ces serveurs. La meilleure solution est que chaque médiathèque prenne un peu de temps pour enrichir le cache collectif sur les vignettes non trouvées. Vous pouvez ainsi envoyer de simples photos des couvertures prises à la médiathèque.

La vignette n'est pas visible or le serveur de cache en a une dans inspector gadget[ ]

Les requêtes au serveur de cache de vignette s'effectue selon la "famille" de documents. Ceci est paramétrable dans l'administration Bokeh, menu Catalogues > Types de documents. Il faut donc affecter une famille au type de document partition.

Validité des url[ ]

Pour être valide, l'url de vignette renseignée doit répondre à l'une au moins de ces exigences :

  • finir par une extension de format d'image valide pour bokeh à savoir png, jpg, jpeg, gif ou webp
  • faire référence à une image Koha en contenant la chaine : '/cgi-bin/koha/opac-image.pl?thumbnail='
  • faire référence à une image 'adav-assoc.com'
  • faire référence à une image 'dam_picture.php?id'
  • faire appel à un script 'getimage.php'
  • contenir la chaîne 'assets.edenlivres.fr'
  • contenir la chaîne 'vignette.indexpresse.fr'

Comment réinitialiser les vignettes des ressources numériques ?[ ]

Nous avons ajouté des outils à l'écran d'administration "Types de documents" pour pouvoir réinitialiser les vignettes pour un type de document donné. Lorsque les vignettes pour un type de documents sont réinitialisées, lors de l'affichage en recherche pour une ressource numérique, la vignette sera de nouveau téléchargée du fournisseur de la ressource #104766

Aller dans Administration > "type de documents > Cliquer sur le bouton "Réinitialiser les images ..." (bouton encadré de vert ci-dessous) Ce traitement va être réalisé immédiatement. Les vignettes sont en fait supprimées et Bokeh est forcé de les "re-télécharger".

Typedoc-reinitialiser.png

La "famille du document" doit être à "non identifié" afin que la réinitialisation aille chercher en local et non dans le serveur de cache. (encadré en jaune)Vous pouvez modifier cette valeur avec le "bouton crayon" sur la page <URL_Bokeh>/admin/type-docs.

Autres pages[ ]