Cette page est actuellement non finalisée. Vous ne trouverez donc pas tout son contenu.
Nous sommes désolé pour la gène occasionnée.
Raison(s) :

  1. Page à écrire et/ou réviser
  2. Réviser les données techniques
  3. Réviser les versions
  4. Mise à jour des captures d'écran


Pour nous aider à compléter la documentation, consulter cette page (Section “wiki”).

FIXME S'aider de : http://fr.piwigo.org/forum/viewtopic.php?pid=160426#p160426

Faire une recherche sur une galerie Piwigo

Il y a deux manière distinctes pour faire une recherche sur une galerie Piwigo.

  1. Utiliser le champs “Recherche rapide” dans le menu “Menu”.
  2. Utiliser le formulaire de recherche via le lien “Recherche” dans le menu “Menu”

Voyons comment ces deux façons de faire une recherche fonctionne concrètement.

La recherche rapide

Fig.1 Le champs de recherche rapide
Fig.1 Le champs de recherche rapide

La recherche rapide diffère de la recherche classique. Elle ne répond pas exactement aux même demandes. Par contre, cette recherche restitue des résultats triés selon leur pertinence.

Entrent en ligne de compte:

  • le nom propre aux images,
  • la description des images,
  • les commentaires réalisés à propos des images,
  • le nom du répertoire,
  • le nom de la catégorie,
  • la description de la catégorie,
  • le nom des fichiers,
  • les tags associés aux images, et
  • les url (adresses) des images,

sur un lot d'images lui-même fonction des droits d'accès de l'utilisateur.

Syntaxe pour recherches spécifiques

Dans les exemples de syntaxe, les apostrophes (single quote) ne servent qu'à montrer ce qui est à écrire dans le champ de recherche rapide. Ils ne sont pas à recopier (contrairement aux guillemets, qui ont une signification dans la recherche).

Syntaxe Explication Exemple
'“mot_clé”' Utilisez des guillemets pour rechercher un mot ou une phrase exacte. '“capitaine haddock”'
'OR mot_clé' OU inclusif : Ajoutez un OR entre les mots clés. 'alain OR bernard'
'NOT mot_clé'
'-mot_clé'
Exclusion. Ajoutez un signe moins (-) ou NOT avant un mot_clé pour l'exclure de la recherche. Notez bien que NOT agit comme un filtre. Vous ne pouvez donc pas utiliser que des opérateurs NOT et il n'est pas possible de combiner OR avec NOT ('alain OR NOT david' n'est pas valide). 'capitaine haddock NOT tintin'
'()' Regroupement '(maman OR papa) AND (fille OR fils)'
'tag:'
'tags:
Recherche seulement dans les tags, sans tenir compte des titres ou des descriptions de photos. 'tag:alain', 'tag:(alain OR david)'
'photo:'
'photos:'
Recherche seulement les photos ayant les mots clés dans leur titre ou leur description. 'photo:Jacques'
'file:' Recherche dans les noms de fichier. 'file:DSC_'
'author:' Recherche par auteur. 'author:Alain'
'created:'
'taken:'
'shot:'
Recherche les photos par date de prise. * 'taken:2003' : photos prises en 2003
* 'taken:20035', 'taken:2003-5', 'taken:2003-05' : photos prises en mai 2003
'taken:2003..2008' : photos de 2003 à 2008
* 'taken:>2008', 'taken:2008*', 'taken:2008..' : photos prises à partir du 1er janvier 2008
'posted:' Recherche les photos par date d'ajout. 'posted:2018-01..2018-02'
'width:'
'height:'
Recherche les photos ayant une certaine largeur ou hauteur en pixels. 'width:>1000', 'height:500..800'
'size:' Recherche les photos par taille en pixels. * 'size:5m' retourne les photos de 5 millions de pixels
* 'size:>12m' retourne les photos de 12 millions de pixels ou plus
'ratio:' Recherche les photos ayant un certain rapport largeur/hauteur. * 'ratio:3/4 OR ratio:4/3' trouve les photos d'un compact en mode portrait ou paysage
* 'ratio:>16/9' trouve les panoramas
'hits:' Recherche par nombre de vues 'hits:>2k' trouve les photos ayant plus de 2000 vues
'score:'
ou 'rating:'
Astuce : 'score:*' retournera toutes les photos ayant au moins une note.
“score:” retournera les photos sans note.
'score:>4', 'score:<2'
'filesize:' Recherche les photos par taille de fichier. 'filesize:1m..10m' retourne les fichiers dont la taille est comprise entre 1 et 10 Mo.
'id:' Recherche les photos en utilisant leur identifiant numérique Piwigo 'id:123..126' trouve les photos 123 à 126.

L'identification des mots et de leur pertinence

L'ensemble des informations ci-dessus (exceptées les 3 dernières) sera filtré simplement pour séparer le texte en mots. Un “mot” est n'importe quelle chaîne de caractères constituée de lettres, chiffres, d'apostrophes simple et d'espaces soulignés. Tout autre caractère sera à l'origine de l'identification d'un autre “mot”. Tout “mot” présent dans la liste des mots mais trop court (3 caractères ou moins) sera ignoré.

La taille minimale pour un mot dans les recherches sur ces éléments est donc de 4 lettres.

Les 'un', 'le', 'la', 'les' en français seront éliminés, pouvant être considérés comme trop communs pour avoir une valeur intrinsèque. Malheureusement une liste de mots anglais à ignorer, trop commun, sera également prise en compte dans l'exclusion. Quelques exemples de termes français qui seront mal évalués : cause, certain, course, différent, former, plus, possible, sensible, zéro

La taille minimale des mots et la liste de mots à ignorer sont des éléments du réglage de MySQL. Comme beaucoup de sites partagent un serveur MySQL, il ne leur est pas possible d'obtenir un réglage différent (à éviter de toute façon). Pour ceux qui disposent de leur propre serveur veuillez vous référer à la documentation officielle de MySQL (Full-Text Stopwords et paragraphes suivants).

Tous les mots corrects de la liste et de la requête sont pondérés en fonction de leur importance dans la liste ou la requête. De cette façon, un mot présent dans de nombreuses lignes aura un poids faible (et peut être même un poids nul), car il a peu d'importance dans cette requête particulière. Au contraire, si le mot est rare, il recevra un poids fort. Le poids des mots est alors calculé pour mesurer la pertinence de la ligne.

Une telle technique fonctionne plus efficacement sur de grands volumes de données (en fait, elle est optimisée pour cela). Avec peu d'éléments, la distribution des mots ne reflète pas correctement leur valeur sémantique et ce modèle peut parfois produire des résultats étranges.

Un mot utilisé dans plus de la moitié des éléments se retrouvera ignoré.

Ce mot ignoré ne sera de toute façon pas efficace pour trouver les documents appropriés. En fait, l'utilisateur trouvera sûrement beaucoup de documents inappropriés à sa recherche. Afin d'éviter ce piège, les éléments se voient donc attribué une valeur sémantique très basse.

En clair, si la recherche porte sur le terme “fil”:
- une description contenant “le fil d'Ariane” ne sera pas retenue (3 caractères).
- une description contenant “La jeune fille à la perle” sera sélectionnée sans qu'on puisse réellement donner la pondération correspondante de façon précise.

Une recherche de “course” ne sélectionnera aucune image par cette première approche.

Les noms des fichiers sont traités séparément par simple similitude

Les noms des fichiers ont une structure différente (sans espace, sans accent, …). Ils sont traités différemment pour cette raison. Chaque mot recherché sera simplement encadré du caractère % et à l'issue de cette sélection la pertinence (poids des images) sera augmentée en cas de similitude.

La recherche de “égal” sélectionnera le fichier p-legall.jpg.

En clair, si la recherche porte sur le terme “fil”:
- un fichier defile_du_14_juillet.jpg sera sélectionné et son poids augmenté de 2 points.

Une recherche de “course” sélectionnera tout élément dont le nom physique contient “course”.

Les Tags sont traités séparément essentiellement pour des raisons de performance

Les tags ayant un sens propre et indépendant, ils sont également traités séparément.
FIXME: Traiter le cas des url_name

Les images sélectionnées par les tags voient leur pondération être augmentée du nombre de tags qui les référence. La recherche des tags sera encore réalisée par similitude (caractère %).

En clair, si la recherche porte sur “fil” et “clair”:
Une image sélectionnée par uniquement le tag “clair-obscur” aura une pondération augmentée de 1 point alors qu'une image taguée par “fille” et “Claire” verra sa pondération augmentée de 2 points.

Une recherche de “course” sélectionnera les tags contenant “course” et les images correspondantes.

Pour aller plus loin...

Page(s) associée(s) :




 
Haut de page
utiliser/utilisation/fonctionnalites/recherche_rapide.txt · Dernière modification: 2018/04/18 11:03 par plg
 
 
github twitter facebook google+ newsletter Faire un don Piwigo.org © 2002-2018 · Contact