Skip to content

Commit

Permalink
Traduction de textsearch par Mathieu Lafage
Browse files Browse the repository at this point in the history
  • Loading branch information
@gleu
gleu committed Aug 11, 2016
1 parent be35951 commit a033a37
Showing 1 changed file with 101 additions and 89 deletions.
190 changes: 101 additions & 89 deletions postgresql/textsearch.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -340,20 +340,21 @@ text @@ text
est équivalente à <literal>to_tsvector(x) @@ plainto_tsquery(y)</literal>.
</para>

<para>
Within a <type>tsquery</type>, the <literal>&amp;</literal> (AND) operator
specifies that both its arguments must appear in the document to have a
match. Similarly, the <literal>|</literal> (OR) operator specifies that
at least one of its arguments must appear, while the <literal>!</literal> (NOT)
operator specifies that its argument must <emphasis>not</emphasis> appear in
order to have a match.
</para>
<para>
Dans un <type>tsquery</type>, l'opérateur <literal>&amp;</literal> (AND)
spécifie que ses deux arguments doivent être présents dans le document pour
qu'il y ait correspondance. De même, l'opérateur <literal>|</literal> (OR)
spécifie qu'au moins un de ses arguments doit être présent dans le
document, alors que l'opérateur <literal>!</literal> (NOT) spécifie que son
argument ne doit <emphasis>pas</emphasis> être présent pour qu'il y ait une
correspondance.
</para>

<para>
Searching for phrases is possible with the help of
the <literal>&lt;-&gt;</literal> (FOLLOWED BY) <type>tsquery</type> operator, which
matches only if its arguments have matches that are adjacent and in the
given order. For example:
<para>
Chercher des phrases est possible à l'aide de l'opérateur
<literal>&lt;-&gt;</literal> (FOLLOWED BY) <type>tsquery</type>, qui
établit la correspondance seulement si tous ses arguments sont adjacents et
dans l'ordre indiqué. Par exemple&nbsp;:

<programlisting>
SELECT to_tsvector('fatal error') @@ to_tsquery('fatal &lt;-&gt; error');
Expand All @@ -367,15 +368,17 @@ SELECT to_tsvector('error is not fatal') @@ to_tsquery('fatal &lt;-&gt; error');
f
</programlisting>

There is a more general version of the FOLLOWED BY operator having the
form <literal>&lt;<replaceable>N</replaceable>&gt;</literal>,
where <replaceable>N</replaceable> is an integer standing for the difference between
the positions of the matching lexemes. <literal>&lt;1&gt;</literal> is
the same as <literal>&lt;-&gt;</literal>, while <literal>&lt;2&gt;</literal>
allows exactly one other lexeme to appear between the matches, and so
on. The <literal>phraseto_tsquery</literal> function makes use of this
operator to construct a <literal>tsquery</literal> that can match a multi-word
phrase when some of the words are stop words. For example:
Il existe une version plus générale de l'opérateur FOLLOWED BY qui s'écrit
<literal>&lt;<replaceable>N</replaceable>&gt;</literal>, où
<replaceable>N</replaceable> est un entier représentant la différence entre
les positions des lexèmes correspondants. L'opérateur
<literal>&lt;1&gt;</literal> est identique à <literal>&lt;-&gt;</literal>,
tandis que l'opérateur <literal>&lt;2&gt;</literal> n'établit la
correspondance que si exactement un lexème différent apparaît entre les
deux lexèmes en argument, et ainsi de suite. La fonction
<literal>phraseto_tsquery</literal> exploite cet opérateur pour construire
un <literal>tsquery</literal> permettant de reconnaître une phrase quand
certains des mots sont des termes courants. Par exemple&nbsp;:

<programlisting>
SELECT phraseto_tsquery('cats ate rats');
Expand All @@ -388,19 +391,20 @@ SELECT phraseto_tsquery('the cats ate the rats');
-------------------------------
'cat' &lt;-&gt; 'ate' &lt;2&gt; 'rat'
</programlisting>
</para>
</para>

<para>
A special case that's sometimes useful is that <literal>&lt;0&gt;</literal>
can be used to require that two patterns match the same word.
</para>
<para>
Un cas particulier potentiellement utile est <literal>&lt;0&gt;</literal>
qui peut être utilisé pour vérifier que deux motifs correspondent à un même
mot.
</para>

<para>
Parentheses can be used to control nesting of the <type>tsquery</type>
operators. Without parentheses, <literal>|</literal> binds least tightly,
then <literal>&amp;</literal>, then <literal>&lt;-&gt;</literal>,
and <literal>!</literal> most tightly.
</para>
<para>
On peut utiliser des parenthèses pour contrôler l'imbrication des
opérateurs <type>tsquery</type>. En l'absence de parenthèses, l'opérateur
<literal>|</literal> a une priorité moindre que <literal>&amp;</literal>,
puis <literal>&lt;-&gt;</literal>, et finalement <literal>!</literal>.
</para>
</sect2>

<sect2 id="textsearch-intro-configurations">
Expand Down Expand Up @@ -840,9 +844,9 @@ UPDATE tt SET ti =
partir de <replaceable>querytext</replaceable> qui doit contenir un
ensemble de jetons individuels séparés par les opérateurs <type>tsquery</type>
<literal>&amp;</literal> (AND), <literal>|</literal> (OR) et
<literal>!</literal> (NOT), and the <literal>&lt;-&gt;</literal>
(FOLLOWED BY) phrase search operator, possibly grouped
using parentheses. En d'autres
<literal>!</literal> (NOT), et l'opérateur de recherche de phrase
<literal>&lt;-&gt;</literal> (FOLLOWED BY), possiblement groupés en
utilisant des parenthèses. En d'autres
termes, les arguments de <function>to_tsquery</function> doivent déjà suivre
les règles générales pour un <type>tsquery</type> comme décrit dans la <xref
linkend="datatype-tsquery"/>. La différence est que, alors qu'un
Expand Down Expand Up @@ -953,19 +957,21 @@ phraseto_tsquery(<optional> <replaceable class="PARAMETER">config</replaceable>
</synopsis>

<para>
<function>phraseto_tsquery</function> behaves much like
<function>plainto_tsquery</function>, except that it inserts
the <literal>&lt;-&gt;</literal> (FOLLOWED BY) operator between
surviving words instead of the <literal>&amp;</literal> (AND) operator.
Also, stop words are not simply discarded, but are accounted for by
inserting <literal>&lt;<replaceable>N</replaceable>&gt;</literal> operators rather
than <literal>&lt;-&gt;</literal> operators. This function is useful
when searching for exact lexeme sequences, since the FOLLOWED BY
operators check lexeme order not just the presence of all the lexemes.
<function>phraseto_tsquery</function> se comporte largement comme
<function>plainto_tsquery</function>, sauf qu'elle insère l'opérateur
<literal>&lt;-&gt;</literal> (FOLLOWED BY) entre les mots restants plutôt
que l'opérateur <literal>&amp;</literal> (AND). De plus, les termes
courants ne sont pas simplement écartés, mais sont comptabilisés par
l'utilisation d'opérateurs
<literal>&lt;<replaceable>N</replaceable>&gt;</literal> plutôt que
d'opérateurs <literal>&lt;-&gt;</literal>. Cette fonction est utile quand
on recherche des séquences exactes de lexèmes, puisque l'opérateur
FOLLOWED BY vérifie l'ordre des lexèmes et pas seulement la présence de
tous les lexèmes.
</para>

<para>
Example:
Exemple&nbsp;:

<screen>
SELECT phraseto_tsquery('english', 'The Fat Rats');
Expand All @@ -974,10 +980,10 @@ SELECT phraseto_tsquery('english', 'The Fat Rats');
'fat' &lt;-&gt; 'rat'
</screen>

Like <function>plainto_tsquery</function>, the
<function>phraseto_tsquery</function> function will not
recognize <type>tsquery</type> operators, weight labels,
or prefix-match labels in its input:
Comme <function>plainto_tsquery</function>, la fonction
<function>phraseto_tsquery</function> ne reconnait ni les opérateurs
<type>tsquery</type>, ni les labels de poids, ni les labels de
correspondance de préfixe dans ses arguments&nbsp;:

<screen>
SELECT phraseto_tsquery('english', 'The Fat &amp; Rats:C');
Expand Down Expand Up @@ -1056,13 +1062,13 @@ SELECT phraseto_tsquery('english', 'The Fat &amp; Rats:C');
</para>

<para>
This function requires lexeme positional information to perform
its calculation. Therefore, it ignores any <quote>stripped</quote>
lexemes in the <type>tsvector</type>. If there are no unstripped
lexemes in the input, the result will be zero. (See <xref
linkend="textsearch-manipulate-tsvector"/> for more information
about the <function>strip</function> function and positional information
in <type>tsvector</type>s.)
Cette fonction a besoin d'information sur la position des lexèmes pour
effectuer son travail. Par conséquent, elle ignore les lexèmes
<quote>stripés</quote> dans le <type>tsvector</type>. S'il n'y a aucun
lexème <quote>non-stripé</quote> en entrée, le résultat sera zéro.
(Voir <xref linkend="textsearch-manipulate-tsvector"/> pour plus
d'information sur la fonction <function>strip</function> et les
informations de position dans les <type>tsvector</type>.)
</para>
</listitem>
</varlistentry>
Expand Down Expand Up @@ -1491,14 +1497,15 @@ FROM (SELECT id, body, q, ts_rank_cd(ti, q) AS rank

<listitem>
<para>
Returns a vector that lists the same lexemes as the given vector, but
lacks any position or weight information. The result is usually much
smaller than an unstripped vector, but it is also less useful.
Relevance ranking does not work as well on stripped vectors as
unstripped ones. Also,
the <literal>&lt;-&gt;</literal> (FOLLOWED BY) <type>tsquery</type> operator
will never match stripped input, since it cannot determine the
distance between lexeme occurrences.
Renvoie un vecteur qui liste les mêmes lexèmes que le vecteur donné
mais à qui il manquera les informations de position et de poids. Alors
que le vecteur renvoyé est bien moins utile qu'un vecteur normal pour
calculer le score, il est habituellement bien plus petit. Le classement
par pertinence ne fonctionne pas aussi bien sur les vecteurs stripés
que sur les non-stripés. Par ailleurs, l'opérateur <type>tsquery</type>
<literal>&lt;-&gt;</literal> (FOLLOWED BY) ne trouvera jamais de
correspondance pour des entrées stripées, puisqu'il ne peut pas
déterminer la distance entre deux occurrences de lexèmes dans ce cas.
</para>
</listitem>

Expand All @@ -1507,8 +1514,8 @@ FROM (SELECT id, body, q, ts_rank_cd(ti, q) AS rank
</variablelist>

<para>
A full list of <type>tsvector</type>-related functions is available
in <xref linkend="textsearch-functions-table"/>.
Une liste complète des fonctions relatives aux <type>tsvector</type> est disponible
à <xref linkend="textsearch-functions-table"/>.
</para>

</sect2>
Expand Down Expand Up @@ -1577,10 +1584,10 @@ FROM (SELECT id, body, q, ts_rank_cd(ti, q) AS rank

<listitem>
<para>
Returns a query that searches for a match to the first given query
immediately followed by a match to the second given query, using
the <literal>&lt;-&gt;</literal> (FOLLOWED BY)
<type>tsquery</type> operator. For example:
Renvoie une requête qui recherche une correspondance avec la première
requête donnée suivie immédiatement par une correspondance avec la
seconde requête donnée, en utilisant l'opérateur <type>tsquery</type>
<literal>&lt;-&gt;</literal> (FOLLOWED BY). Par exemple&nbsp;:

<screen>
SELECT to_tsquery('fat') &lt;-&gt; to_tsquery('cat | rat');
Expand All @@ -1605,11 +1612,12 @@ SELECT to_tsquery('fat') &lt;-&gt; to_tsquery('cat | rat');

<listitem>
<para>
Returns a query that searches for a match to the first given query
followed by a match to the second given query at a distance of at
most <replaceable>distance</replaceable> lexemes, using
the <literal>&lt;<replaceable>N</replaceable>&gt;</literal>
<type>tsquery</type> operator. For example:
Renvoie une requête qui recherche une correspondance avec la première
requête donnée suivie par une correspondance avec la seconde requête
donnée, à une distance d'au plus <replaceable>distance</replaceable>
lexèmes, en utilisant l'opérateur <type>tsquery</type>
<literal>&lt;<replaceable>N</replaceable>&gt;</literal>. Par
exemple&nbsp;:

<screen>
SELECT tsquery_phrase(to_tsquery('fat'), to_tsquery('cat'), 10);
Expand Down Expand Up @@ -2901,18 +2909,21 @@ SELECT plainto_tsquery('supernova star');
</para>

<para>
Pour créer un dictionnaire <application>Ispell</application>, perform these steps&nbsp;:
Pour créer un dictionnaire <application>Ispell</application>, réalisez les
étapes suivantes&nbsp;:
</para>

<itemizedlist spacing="compact" mark="bullet">
<listitem>
<para>
download dictionary configuration files. <productname>OpenOffice</productname>
extension files have the <filename>.oxt</filename> extension. It is necessary
to extract <filename>.aff</filename> and <filename>.dic</filename> files, change
extensions to <filename>.affix</filename> and <filename>.dict</filename>. For some
dictionary files it is also needed to convert characters to the UTF-8
encoding with commands (for example, for norwegian language dictionary):
télécharger les fichiers de configuration de dictionnaires. Ces
fichiers <productname>OpenOffice</productname> portent l'extension
<filename>.oxt</filename>. Il est nécessaire d'extraire les fichiers
<filename>.aff</filename> et <filename>.dic</filename>, et de changer
ces extensions en <filename>.affix</filename> et
<filename>.dict</filename>. Pour certains fichiers de dictionnaire, il
faut aussi convertir les caractères en encodage UTF-8 avec les commandes
suivantes (par exemple, pour le dictionnaire du norvégien)&nbsp;:
<programlisting>
iconv -f ISO_8859-1 -t UTF-8 -o nn_no.affix nn_NO.aff
iconv -f ISO_8859-1 -t UTF-8 -o nn_no.dict nn_NO.dic
Expand All @@ -2921,12 +2932,12 @@ iconv -f ISO_8859-1 -t UTF-8 -o nn_no.dict nn_NO.dic
</listitem>
<listitem>
<para>
copy files to the <filename>$SHAREDIR/tsearch_data</filename> directory
copier les fichiers dans le répertoire <filename>$SHAREDIR/tsearch_data</filename>
</para>
</listitem>
<listitem>
<para>
load files into PostgreSQL with the following command:
charger les fichiers dans PostgreSQL avec la commande suivante&nbsp;:
<programlisting>
CREATE TEXT SEARCH DICTIONARY english_hunspell (
TEMPLATE = ispell,
Expand Down Expand Up @@ -3656,7 +3667,7 @@ SELECT plainto_tsquery('supernovae stars');
<tertiary>recherche plein texte</tertiary>
</indexterm>

<literal>CREATE INDEX <replaceable>name</replaceable> ON <replaceable>table</replaceable> USING gist(<replaceable>column</replaceable>);</literal>
<literal>CREATE INDEX <replaceable>name</replaceable> ON <replaceable>table</replaceable> USING gist(<replaceable>colonne</replaceable>);</literal>
</term>

<listitem>
Expand Down Expand Up @@ -3964,9 +3975,10 @@ Parser: "pg_catalog.default"
être supérieures à 0 et inférieures ou égales à 16383</para>
</listitem>
<listitem>
<para>The match distance in a <literal>&lt;<replaceable>N</replaceable>&gt;</literal>
(FOLLOWED BY) <type>tsquery</type> operator cannot be more than
16,384</para>
<para>La distance de correspondance dans un opérateur
<type>tsquery</type>
<literal>&lt;<replaceable>N</replaceable>&gt;</literal> (FOLLOWED BY) ne
peut pas dépasser 16384</para>
</listitem>
<listitem>
<para>Pas plus de 256 positions par lexème</para>
Expand Down

0 comments on commit a033a37

Please sign in to comment.