Ce chapitre décrit la syntaxe à utiliser, ainsi que les options de recherche disponibles sur le site Web docs.sun.com. Vous pouvez rechercher tous les documents sur ce site, quel que soit le format de l'ouvrage. La documentation peut se présenter dans différents formats :
ouvrages basés sur XML, affichés sous la forme d'une arborescence de chapitres et de sections ;
ouvrages HTML, affichés sous la forme d'un ensemble de pages ;
ouvrages PDF seul.
Vous trouverez, ci-dessous, une liste des informations contenues dans ce chapitre :
Cette section décrit les fonctions disponibles sur le site docs.sun.com Web et qui vous permettent d'affiner votre recherche.
Le site docs.sun.com propose une option qui permet d'affiner la recherche en la limitant aux titres des ouvrages. Il vous suffit pour ce faire de sélectionner l'option Titres uniquement en cochant la case située à droite du bouton Lancer. Si vous avez sélectionné cette option, le site recherche le mot ou la phrase entrées, mais uniquement dans les titres des ouvrages.
Vous pouvez limiter votre recherche aux ouvrages rattachés à un sujet ou à un produit donné à l'intérieur des titres, des sujets ou des catégories de produits. Lorsque vous remontez ou redescendez au sein d'une arborescence sur le site docs.sun.com, vous pouvez utiliser le menu déroulant Rechercher dans pour affiner ou étendre la portée de votre recherche en sélectionnant une sous-catégorie dans une liste de collections, sujets ou produits. Les catégories et sous-catégories dans lesquelles vous naviguez viennent s'ajouter à la liste des options de la liste Rechercher dans. Vous pouvez sélectionner l'une de ces catégories ou sous-catégories dans la liste Rechercher dans pour modifier la portée de votre recherche.
Il vous suffit de sélectionner l'une des options figurant dans ce menu :
Sélectionnez l'option Tous les ouvrages lorsque vous souhaitez effectuer une recherche dans tous les ouvrages du site Web docs.sun.com. Cette option est disponible quelle que soit la recherche effectuée.
Sélectionnez une catégorie de sujets ou de produits ou une sous-catégorie lorsque vous souhaitez effectuer une recherche dans l'arborescence de sujets ou de produits dans laquelle vous naviguez. Pour étendre votre recherche, sélectionnez l'une des catégories parentes que vous avez explorées avant d'atteindre la catégorie actuelle. Cette option est disponible lorsqu'une catégorie de sujets ou de produits, une fonction de navigation ou un ouvrage est affiché.
Sélectionnez l'option Cette collection si vous souhaitez limiter votre recherche aux ouvrages de la collection affichée. Cette option est disponible lorsqu'une collection ou tout ouvrage publié faisant partie d'une collection est affiché.
Sélectionnez l'option Cet ouvrage si vous souhaitez limiter votre recherche à l'ouvrage affiché. Cette option est uniquement disponible lorsqu'un ouvrage basé sur XML est affiché.
Les opérateurs de recherche peuvent être :
Des mots : pour trouver les ouvrages contenant un ou plusieurs mots/termes entrez ce ou ces mots/termes dans le champ Rechercher dans. Séparez les mots recherchés par un ou plusieurs espaces. Le résultat des recherches ayant trait à plusieurs mots se présente sous la forme d'une liste d'ouvrages contenant tous les mots recherchés, quel que soit l'endroit et l'ordre dans lequel ils y apparaissent. Vous pouvez également effectuer une recherche par référence.
Les caractères autres que des lettres ou des chiffres sont traités comme indiqué ci-dessous.
La barre verticale (|), le symbole supérieur à (>), le symbole inférieur à (<), le signe moins (-), le symbole arobas (@), la barre oblique (/) et la barre oblique inversée (\) sont traités comme des caractères de séparation de mots. Par exemple, une recherche pour Sun-Fire est traitée comme une recherche pour les mots "Sun" et "Fire".
Le signe plus (+), le signe dièse (#), le symbole du dollar ($), le symbole du pourcentage (%) et le "e commercial" (&) sont traités comme des caractères de balisage. Par exemple, #include est traité comme un mot unique, tandis que #define#include est traité comme deux mots, "#define" et "#include".
Des phrases : pour trouver les ouvrages qui contiennent une phrase précise, insérez celle-ci entre guillemets (") dans le champ Rechercher dans. Le résultat des recherches de phrases se présente sous la forme d'une liste des ouvrages dans lesquels les mots qui constituent la phrase recherchée apparaissent l'un à côté de l'autre, dans l'ordre spécifié.
Une recherche peut contenir plusieurs phrases. Exemple : si vous recherchez CD "système solaris", les ouvrages contenant “CD” et “système solaris” s'affichent.
Opérateur joker (*) : que vous ayez entré un mot ou une phrase dans le champ Rechercher dans, pour trouver les ouvrages qui contiennent les variations d'un mot, insérez un astérisque (*) à la fin de celui-ci.
cet opérateur de recherche ne peut actuellement pas être inséré au début ou au milieu de mots ou de chaînes de caractères.
Exemple : si vous recherchez CD*, les ouvrages contenant les mots CD, CD-ROM et CD_ROM_FOLDER s'affichent.
Le site Web docs.sun.com est conçu pour rechercher des ouvrages et non des pages à l'intérieur d'ouvrages. Lorsque vous effectuez une recherche globale ou utilisez le menu déroulant Rechercher dans pour effectuer une recherche globale, le site traite tous les ouvrages de la même façon, que le mot ou la phrase que vous recherchez apparaisse dans des ouvrages basés sur XML, dans des documents HTML ou dans des ouvrages PDF seul.
Lorsque vous recherchez tous les ouvrages ou utilisez le menu déroulant Rechercher dans pour rechercher des informations dans un sujet, un produit ou une collection, le nombre d'ouvrages contenant la chaîne que vous avez recherchée s'affiche en haut de la page de résultats. Le nombre maximal d'ouvrages affiché par page est de 50. Si plus de 50 ouvrages contiennent la chaîne recherchée, la liste des résultats se poursuit sur la page suivante. La barre de navigation située en haut et en bas de la page, au milieu de celle-ci, indique le nombre total de pages disponibles. L'icône indique la page affichée. Pour accéder aux autres pages, il vous suffit de cliquer sur le numéro correspondant.
si le nombre de concordances obtenu est très élevé, il peut s'avérer utile d'affiner la recherche, soit en modifiant le texte recherché, soit en utilisant le menu déroulant Rechercher dans pour en modifier la portée.
Le site docs.sun.com affiche une liste d'ouvrages contenant le mot ou la phrase que vous avez recherché par ordre décroissant de pertinence. La pertinence des ouvrages est indiquée par des icônes :
Les documents marqués de l'icône constituent les éléments les plus pertinents par rapport à vos critères de recherche.
Les documents marqués de l'icône constituent les éléments les moins pertinents par rapport à vos critères de recherche.
Le nom de la collection à laquelle appartient l'ouvrage s'affiche sous le titre de celui-ci, après le mot “inclus dans”.
Si vous recherchez plus d'un mot à la fois, les ouvrages dans lesquels la proximité de ces mots est la plus élevée sont affichés en tête de liste. Les ouvrages dans lesquels les mots sont les plus éloignés les uns des autres (fourchette maximale de 30 mots) sont affichés plus bas dans la liste.
Les ouvrages qui contiennent les mots ou phrases recherchés dans un titre de chapitre ou de section ou dans tout autre élément similaire se voient assigner un taux de pertinence plus élevé. Ces ouvrages ont tendance à se trouver en tête de liste, avant ceux dans lesquels les mots ou phrases recherchés apparaissent tout aussi fréquemment, mais uniquement dans des paragraphes et non dans des titres.
Si vous affichez le site Web docs.sun.com dans une autre langue, les ouvrages écrits dans cette langue apparaissent en tête de liste. Exemple : si vous affichez le contenu du site en anglais, les ouvrages en anglais apparaissent en tête de liste lorsque vous effectuez une recherche.
lorsque vous effectuez une recherche globale, le site docs.sun.com ignore les ouvrages et collections dont l'accès requiert l'entrée d'un mot de passe. Si vous le connaissez, vous pouvez toutefois effectuer une recherche dans un ouvrage protégé par un mot de passe à condition qu'il s'agisse d'un ouvrage basé sur XML.
Alors que le site docs.sun.com traite tous les ouvrages de la même manière lorsque vous effectuez une recherche globale ou utilisez le menu déroulant Rechercher dans pour le faire, vous pouvez uniquement effectuer une recherche locale à l'intérieur d'ouvrages basés sur XML . Il est impossible d'effectuer ces recherches dans des documents HTML ou des ouvrages PDF seul.
Lorsque vous ouvrez un ouvrage sur le site Web docs.sun.com et que vous y recherchez des informations, la table des matières de cet ouvrage s'affiche et des icônes indiquent la pertinence des parties de l'ouvrage.
Tout chapitre, annexe, préface, glossaire ou index marqué de l'icône constitue l'élément le plus pertinent par rapport à vos critères de recherche.
Tout chapitre, annexe, préface, glossaire ou index marqué de l'icône constitue l'élément le moins pertinent par rapport à vos critères de recherche.
Les éléments non pertinents des ouvrages ne sont pas marqués d'une icône.
Les mots que vous recherchez sont mis en évidence dans les ouvrages basés sur XML. Cela vous permet d'effectuer des recherches et de naviguer simultanément à l'intérieur d'un ouvrage.
le mécanisme disponible sur le site Web docs.sun.com n'est pas uniquement un mécanisme de navigation. Il peut également être utilisé pour effectuer des recherches dans les titres ou les catégories de sujets ou de produits.
Vous pouvez par exemple resteindre l'ensemble de documents dans lesquels vous souhaitez rechercher un mot en sélectionnant l'onglet Catégories de produits, puis en cliquant sur les liens Logiciel, Solaris, Solaris 8, puis Solaris 8 System Administrator Collection. Il vous suffit ensuite d'entrer, dans la fenêtre Recherche de, le mot que vous souhaitez rechercher dans cette collection. Lorsque vous ouvrez un livre appartenant à cette collection et contenant le mot recherché, celui-ci est mis en évidence.
Les tableaux suivants fournissent des exemples de syntaxe de recherche.
Tableau 2-1 Exemples de syntaxe de recherche