Introduction

NewsSearch est un moteur de recherche sur les News du serveur de l'ESSI : news-srv.essi.fr.
Il permet de trouver des messages postés dans des NewsGroups en fonction de certains critères de recherche. Il est donc possible de preciser, lors de la recherche :
- un nom de NewsGroup,
- un mot-clé,
- ou même une expression régulière à rechercher.
Ce moteur étant destiné à l'ESSI, il possède l'avantage de fonctionner en local (n'utilise pas NNTP) ce qui accélère son temps de recherche.

Installation

Pour son installation, News Search nécessite une machine possédant :

un serveur PHP3,
un accés direct au répertoire contenant les News.

Fichiers nécessaires :

Pour l'interface

         - index.html                 -- génération des frames
         - requete.html               -- formulaire de requêtes - frame d'entête
         - doc.html                   -- documentation - frame centrale
         - banner.html                -- frame de pied de page
         - images                     -- répertoire contenant les images de l'interface

         - images/titre.gif           -- image NewsSearch
         - images/submit.gif          -- image Search

Pour le traitement

         - requete.php3               -- gestion du formulaire
         - base                       -- répertoire contenant les fichiers index de Glimpse

         - base/.glimpse_filenames        
         - base/.glimpse_filenames_index  
         - base/.glimpse_filetimes        
         - base/.glimpse_index      
         - base/.glimpse_message     
         - base/.glimpse_partitions  
         - base/.glimpse_statistics

Modifications éventuelles des fichiers :

Le serveur PHP3 qui nous a servi au développement ne possédait pas, dans son PATH, d'accés au programme Glimpse. Nous avons donc dû entrer son chemin en "dur" dans le fichier requete.php3. Ce chemin est le suivant : /opt/net/bin/glimpse.
Si votre chemin d'accés à Glimpse est différent, veillez à modifier le fichier requete.php3 (ligne 69) en conséquence.
Si vos fichiers index Glimpse ne se trouvent pas dans le répertoire base, vous pouvez modifier le fichier requete.php3 afin de changer le chemin d'accés à l'index. Cela doit être fait aux lignes 82 et 84 en remplacant ./base par votre chemin.

Génération d'index avec Glimpse :

Pour générer un index Glimpse pour News Search, la commande est la suivante :
Si vous êtes dans le répertoire racine de News Search

glimpseindex -b -t -H ./base -f "chemin d'accés aux News"

exemple :

glimpseindex -b -t -H ./base -f /news/articles

Attention, pour générer un index, vous devez imperativement être sur une machine possédant un accés direct au répertoire contenant les news (avoir le répertoire news dans son arborescense).

Attention, la première génération d'index peut être trés longue (plusieurs heures). Cependant les générations suivantes seront bien plus courtes car alors, Glimpse traitera uniquement les nouveaux fichiers.

Description

Champs obligatoire :

Le champ PATTERN : correspond au mot-clé à rechercher. Ce mot-clé peut être un simple mot, une Expression régulière, ou une Expression booléenne Glimpse.

Champs facultatifs :

Le champ NewsGroup : permet de préciser dans quel NewsGroup s'effectuera la recherche.
Bien evidemment, le NewsGroup doit appartenir au seveur de l'ESSI.
Si ce champ est vide, la recherche s'effectuera sur tous les NewsGroups fournis pas le serveur de l'ESSI.
Ce champs accepte la saisie partielle du nom du NewsGroup. La recherche s'effectuera alors sur tous les NewsGroups contennant ce champs.
Le champ Msg arrivés depuis ... jours : permet de limiter la recherche aux messages arrivés depuis le nombre de jours spécifié.
Si rien, n'est spécifié, on recherchera dans tous les messages
Le champ Nb msg Max : permet de limiter le nombre de messages resultant de la recherche.
Si l'on precise un nombre inférieur au nombre de messages correspondant à la recherche, seul les premiers messages trouvés seront affichés.
Si rien n'est spécifié ou si ce nombre est supérieur au nombre de messages correspondant à la recherche, tous les messages s'afficheront.
La case Insensible à la casse : permet de préciser si la recherche doit respecter la casse ou non.
C'est à diferentier ou non les
La case Affichage condensé : si cette case est cochée, le résultat de la recherche n'affichera que les sujets des messages.
Ces sujets restent toutefois des liens vers les messages eux-mêmes.

Les PATTERNS possibles

Glimpse permet, pour la recherche, de fournir divers types de pattern :

un mots seul,
une expression booléenne Glimpse.
une expression régulière,

Expression booléenne Glimpse :
Le champs PATTERN et le champs NewsGroup permettent à l'utilisateur de saisir des expressions booléennes.

Le ET logique glimpse est représenté par un ; (point virgule).
Ainsi, si l'on veut chercher les messages contenant : linux ET unix, le PATTERN sera :

linux;unix

Le OU logique glimpse est représenté par une , (virgule).
Ainsi, si l'on veut chercher les messages contenant : linux OU unix, le PATTERN sera :

linux,unix

On peut ainsi choisir des PATTERN complexe.
Exemple : (linux;unix),windows.
Cela retournera tous les messages contenant "linux ET unix" plus les messages contenant "windows".

Attention, Il ne doit pas y avoir d'espace entre les mots et l'opérateur logique.

Expression régulière :
Le champs PATTERN et le champs NewsGroup permettent à l'utilisateur de saisir des expressions régulières.
Voici un aperçu des expressions régulières possibles dans Glimpse :

Le . qui permet de remplacer une lettre dans un mot.
exemple : l.unx retournera les messages contenant "linux" mais aussi "lonux".
Le * qui recherchera les mots contenant de zéro ou plusieurs occurences successives du caractère placé devant.
exemple : li*unx retournera les messages contenant "linux" mais aussi "liiiiiiiiinux" ou "lnux".
Le ^ en préfixe d'un mot retournera les messages contenant le mot en début de ligne.
exemple : ^linux retournera les messages contenant "linux" en début de ligne.
Le $ en suffixe d'un mot retournera les messages contenant le mot en fin de ligne.
exemple : linux$ retournera les messages contenant "linux" en fin de ligne.

On peut également composer les symboles.
Exemple : l.*x retournera tous les messages contenant un "l", suivi de zéro ou plusieurs lettres avant de retrouver un "x" (retournera : "lx", "lux", "linux", ...etc).

Attention, Les expressions régulières ne s'appliquent qu'à 1 mot.
Ainsi un.*x retrournera "unix" mais pas "un prix"