vfs: check userland buffers before reading them.
[haiku.git] / docs / userguide / fr / queries.html
blob2a5c662a416ceaab60a0e41fae163e510b5a6dc1
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr">
4 <head>
5 <!--
7 * Copyright 2008-2009, Haiku. All rights reserved.
8 * Distributed under the terms of the MIT License.
10 * Authors:
11 * Humdinger <humdingerb@gmail.com>
12 * Translators:
13 * Loïc
14 * Vincent Duvert
16 -->
17 <meta http-equiv="content-type" content="text/html; charset=utf-8" />
18 <meta http-equiv="Content-Style-Type" content="text/css" />
19 <meta name="robots" content="all" />
20 <title>Requêtes</title>
21 <meta name="viewport" content="width=device-width, initial-scale=1.0" />
22 <link rel="stylesheet" type="text/css" href="../Haiku-doc.css" />
23 </head>
24 <body>
26 <div id="banner">
27 <div><span>User guide</span></div>
28 </div>
30 <div class="nav">
31 <div class="inner">
32 <ul class="lang-menu">
33 <li class="now"><img src="../images/flags/fr.png" alt="" /> Français</li>
34 <li><a href="../ca/queries.html"><img src="../images/flags/ca.png" alt="" />Català</a></li>
35 <li><a href="../de/queries.html"><img src="../images/flags/de.png" alt="" />Deutsch</a></li>
36 <li><a href="../en/queries.html"><img src="../images/flags/gb.png" alt="" />English</a></li>
37 <li><a href="../es/queries.html"><img src="../images/flags/es.png" alt="" />Español</a></li>
38 <li><a href="../it/queries.html"><img src="../images/flags/it.png" alt="" />Italiano</a></li>
39 <li><a href="../hu/queries.html"><img src="../images/flags/hu.png" alt="" />Magyar</a></li>
40 <li><a href="../pl/queries.html"><img src="../images/flags/pl.png" alt="" />Polski</a></li>
41 <li><a href="../pt_PT/queries.html"><img src="../images/flags/pt_PT.png" alt="" />Português</a></li>
42 <li><a href="../pt_BR/queries.html"><img src="../images/flags/pt_BR.png" alt="" />Português (Brazil)</a></li>
43 <li><a href="../ro/queries.html"><img src="../images/flags/ro.png" alt="" />Română</a></li>
44 <li><a href="../sk/queries.html"><img src="../images/flags/sk.png" alt="" />Slovenčina</a></li>
45 <li><a href="../fi/queries.html"><img src="../images/flags/fi.png" alt="" />Suomi</a></li>
46 <li><a href="../sv_SE/queries.html"><img src="../images/flags/sv_SE.png" alt="" />Svenska</a></li>
47 <li><a href="../zh_CN/queries.html"><img src="../images/flags/zh_CN.png" alt="" /> 中文 [中文]</a></li>
48 <li><a href="../ru/queries.html"><img src="../images/flags/ru.png" alt="" />Русский</a></li>
49 <li><a href="../uk/queries.html"><img src="../images/flags/uk.png" alt="" />Українська</a></li>
50 <li><a href="../jp/queries.html"><img src="../images/flags/jp.png" alt="" />日本語</a></li>
51 </ul>
52 <span>
53 « <a href="index.html">Index</a>
54 :: <a href="contents.html" class="uplink">Contents</a>
55 :: <a href="workshop-filetypes+attributes.html">Workshop</a> »
56 </span></div>
57 </div>
59 <div id="content">
60 <div>
63 <table class="index" id="index" summary="index">
64 <tr class="heading"><td>Index</td></tr>
65 <tr class="index"><td>
66 <a href="#find-window">La fenêtre de recherche</a><br />
67 <a href="#basic-query">Recherches basiques - "par Nom"</a><br />
68 <a href="#adv-query">Recherches avancées - "par Attribut"</a><br />
69 <a href="#more-adv-query">Requêtes encore plus avancées - "par formule"</a><br />
70 <a href="#result-window">La fenêtre de résultat</a><br />
71 <a href="#query-template">Modèles de requêtes</a>
72 </td></tr>
73 </table>
75 <h1>Requêtes</h1>
77 <p>Une requête est une recherche de fichiers basée sur des attributs de fichiers et peut être réalisée dans le Tracker ou dans le Terminal. Les requêtes sont sauvegardées dans <span class="path">/boot/home/queries/</span> et par défaut, elles sont conservées sept jours avant d'être purgé. Vous remarquez que ce ne sont pas des listes statiques de résultats de vos recherches, mais ce sont des formules de requête qui déclenchent une nouvelle recherche chaque fois que vous les ouvrez.<br />
78 Mieux encore, vous n'avez pas à double-cliquer à nouveau pour rafraichir une requête. Vous pouvez <a href="tracker.html#navigating">explorer</a> une requête enregistrée, tout comme n'importe quel dossier en effectuant un clic droit sur elle et en naviguant dans les sous-menus.</p>
80 <h2>
81 <a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
82 <a id="find-window" name="find-window">La fenêtre de recherche</a></h2>
83 <p>Vous commencez une requête en invoquant le menu <span class="menu">Find...</span> à partir du menu de la Deskbar, de n'importe quelle fenêtre du Tracker ou directement à partir du bureau (ce dernier est en fait une fenêtre du Tracker en plein écran). Le raccourci est <span class="key">CMD</span> <span class="key">F</span>. Voici une présentation de la fenêtre de recherche :</p>
84 <img src="images/queries-images/basic-query.png" alt="basic-query.png" />
85 <ol>
86 <li><p>Sélectionnez une requête récente/enregistrée ou sauvegarder les critères de recherche en cours dans un <a href="#query-template">modèle de requête</a>.</p></li>
87 <li><p>Réduisez votre recherche de "Tous les fichiers et les dossiers" (<span class="menu">All files and folders</span>) à un type de fichier spécifique.</p></li>
88 <li>Sélection de la méthode de recherche :<ul>
89 <li><span class="menu">by Name</span> - une recherche basique par nom de fichier ou de dossier</li>
90 <li><span class="menu">by Attribute</span> - une recherche avancée, vous spécifiez les termes d'une recherche sur un ou plusieurs attributs</li>
91 <li><span class="menu">by Formula</span> - une recherche encore plus avancée, vous pouvez formuler finement vos critères en termes complexes.</li></ul></li>
92 <li><p>Selection des disques/volumes à interroger.</p></li>
93 <li><p>Entrez le terme recherché.</p></li>
94 <li><p>Un agrandisseur cache/montre les options supplémentaires.</p></li>
95 <li><p>Décochez la case <span class="menu">Temporary</span> (Temporaire) si vous ne voulez pas que cette requête s'efface après 7 jours.</p></li>
96 <li><p>Cocher si votre requête est supposé inclure la corbeille (<span class="menu">Include trash</span>).</p></li>
97 <li><p>En option, saisissez un nom pour cette requête si vous souhaitez l'enregistrer.</p></li>
98 <li><p>Vous pouvez glisser&amp;déposer l'icône pour sauvegarder la requête. En le faisant avec le bouton droit, vous aurez le choix de sauver le modèle de la requête.</p></li>
99 </ol>
101 <h2>
102 <a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
103 <a id="basic-query" name="basic-query">Recherches basiques - "par Nom"</a></h2>
104 <p>Si vous souhaitez simplement trouver tous les fichiers sur vos disques montés dont le nom correspond à un certain motif, laissez simplement la méthode de recherche "<span class="menu">by name</span>", entrez le terme recherché dans la zone de texte et pressez <span class="key">ENTRÉE</span>.</p>
106 <h2>
107 <a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
108 <a id="adv-query" name="adv-query">Recherches avancées - "par Attribut"</a></h2>
109 <p>Vous pouvez créer des requêtes plus complexes en faisant une recherche dans les attributs de fichiers d'un type spécifique. Pour que cela fonctionne, ces attributs doivent être <a href="index.html">indexés</a>.</p>
110 <img src="images/queries-images/query-window.png" alt="query-window.png" />
111 <p>Commencez par sélectionner un type de fichier à partir de <span class="menu">All files and folders</span>, par exemple <span class="menu">Texte | E-mail</span> puis choisissez la méthode de recherche <span class="menu">by Attribute</span>.</p>
112 <p>Cela ajoute une liste déroulante à gauche de la zone de texte ainsi que les boutons <span class="button">Add</span> et <span class="button">Remove</span> juste dessous. Dans la liste déroulante vous choisissez quel attribut rechercher. Avec<span class="button">Add</span> et <span class="button">Remove</span> vous pouvez interroger des attributs supplémentaires ou les retirer. Ces attributs peuvent être combinés logiquement avec ET/OU.</p>
113 <p>Faisons par exemple une requête sur un e-mail :</p>
114 <img src="images/queries-images/query-window-filled.png" alt="query-window-filled.png" />
115 <p>Il s'agit de votre fenêtre de recherche lorsque vous êtes à la recherche de tous les e-mails que vous a envoyé Clara Botters dans les deux derniers mois et dont le sujet contenait "vibraphone" ou "skepticality".</p>
117 <h2>
118 <a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
119 <a id="more-adv-query" name="more-adv-query">Requêtes encore plus avancées - "par formule"</a></h2>
120 <p>Saisir une formule de requête manuellement est rebutant et assez peu pratique. Elle a néanmoins son utilité.</p>
121 <p>Prenez par exemple la requête par attributs ci-dessus, cherchant les emails de Clara concernant les vibraphones. Si vous passez ensuite en mode de recherche par formule (<span class="menu">by Formula</span>), vous serez confronté à cette longue phrase de recherche :</p>
122 <img src="images/queries-images/formula-query.png" alt="formula-query.png" />
123 <p>la même chose, sous forme de texte, édité pour plus de lisibilité :</p>
124 <pre>(((((MAIL:from=="*[cC][lL][aA][rR][aA] [bB][oO][tT][tT][eE][rR][sS]*")
125 &amp;&amp;(MAIL:when&gt;=%2 months%))
126 &amp;&amp;(MAIL:subject=="*[vV][iI][bB][rR][aA][pP][hH][oO][nN][eE]*"))
127 ||(MAIL:subject=="*[sS][kK][eE][pP][tT][iI][cC][aA][lL][iI][tT][yY]*"))
128 &amp;&amp;(BEOS:TYPE=="text/x-email"))</pre>
129 <p>A quoi ça sert ?</p>
130 <ul>
131 <li><p>Vous pouvez copier et coller la chaîne dans un e-mail, un forum ou sur IRC pour que d'autres puissent l'utiliser ou la déboguer.</p></li>
132 <li><p>En construisant une requête en mode <span class="menu">Attribute</span>, puis en passant en mode <span class="menu">Formula</span>, Vous pouvez générer facilement une chaîne de recherche à utiliser pour une requête dans le Terminal ou dans un script.</p></li>
133 <li><p>Vous pouvez affiner votre recherche en ajoutant des parenthèses si nécessaire, rendre une partie sensible à la casse ou modifier leur combinaison logique en changeant par exemple "<tt>==</tt>" en "<tt>!=</tt>" pour un NON ET. Il suffit d'avoir une compréhension de base des <a href="http://en.wikipedia.org/wiki/Regular_expression" class="external free" title="http://en.wikipedia.org/wiki/Regular expression">expressions régulières</a>, et peut-être quelques notions de base de scripts.</p></li>
134 </ul>
136 <h2>
137 <a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
138 <a id="result-window" name="result-window">La fenêtre de résultat</a></h2>
139 <p>Après avoir lancé une recherche, la fenêtre de recherche va être remplacée par une fenêtre de résultat. Voici un exemple qui a demandé "server" :</p>
140 <img src="images/queries-images/result-window.png" alt="result-window.png" />
141 <p>Hormis leur fond gris, les fenêtres de résultat fonctionnent exactement comme n'importe quelle autre fenêtre du Tracker. Certaines choses méritent d'être noter :</p>
142 <ul>
143 <li><p>Vous pouvez ouvrir le dossier dans lequel se trouve le fichier ou le dossier en cliquant deux fois sur l'attribut "Path".</p></li>
144 <li><p>Avec <span class="menu">File | Edit Query</span> ou <span class="key">CMD</span> <span class="key">G</span> vous revenez à la fenêtre de recherche où vous pouvez affiner vos critères.</p></li>
145 <li><p>Une requête est vivante, c'est à dire que si un fichier qui correspond à vos critères de recherche apparaît ou disparaît de votre système, ce changement se reflètera dans les résultats en temps réel.</p></li>
146 </ul>
147 <p>Vous pouvez assigner un style d’affichage des attributs pour les résultats de recherche d’un type de fichier spécifique. Ouvrez un dossier contenant des fichier du type dont vous voudriez créer un style, et arrangez les attributs comme vous le souhaitez. Copiez ensuite cette représentation en utilisant le menu <span class="menu">Attributes | Copy Layout</span>.</p>
148 <p>Ouvrez <span class="path">/boot/home/config/settings/Tracker/DefaultQueryTemplates</span>, créez un nouveau dossier nommé <i>group/filetype</i>, en remplaçant la barre oblique par un trait de soulignement, par exemple, "Audio_x-mp3". Ouvrez ce nouveau dossier et collez la structure précédemment copiée avec <span class="menu">Attributes | Paste Layout</span>.</p>
151 <h2>
152 <a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
153 <a id="query-template" name="query-template">Modèles de requêtes</a></h2>
154 <p>Si vous double-cliquez sur une requête enregistrée, la recherche démarre et immédiatement, la fenêtre de résultat s'ouvre. Toutefois, vous pourriez ne pas vouloir effectuer de recherches avec ces critères <i>précis</i>, mais les utiliser comme point de départ en ajustant la formule légèrement.<br />
155 En utilisant la méthode <span class="menu">Save Query as Template</span> du menu (Enregistrer le modèle) (voir <a href="#find-window">(1) dans la capture d'écran</a> en haut) ou en faisant glisser l'icône (10) n'importe où avec le bouton droit de la souris, vous pouvez créer un modèle. Un double-clic n'ouvrira plus une fenêtre de résultat, mais un panneau de recherche, vous donnant la possibilité de changer rapidement le texte de recherche, d'ajouter des attributs ou d'en enlever.</p>
156 <p>Où que vous choisissiez d'enregistrer les modèles de requêtes, ils seront énumérés dans la liste des requêtes récentes de la fenêtre recherche.</p>
157 </div>
158 </div>
160 <div class="nav">
161 <div class="inner"><span>
162 « <a href="index.html">Index</a>
163 :: <a href="contents.html" class="uplink">Contents</a>
164 :: <a href="workshop-filetypes+attributes.html">Workshop</a> »
165 </span></div>
166 </div>
168 </body>
169 </html>