In questo capitolo vengono descritte la sintassi e le opzioni da utilizzare per la ricerca nel sito Web docs.sun.com; è possibile effettuare ricerche in tutti i documenti del sito, indipendentemente dal formato del manuale. I formati disponibili comprendono:
Manuali basati su XML, visualizzati in strutture ad albero di capitoli e sezioni.
Manuali HTML, visualizzati come set di pagine.
Manuali solo PDF.
Di seguito è indicato un elenco delle informazioni contenute in questo capitolo:
In questa sezione vengono descritte le funzionalità del sito Web docs.sun.com che è possibile utilizzare per limitare la portata di una ricerca.
Nel sito docs.sun.com è prevista un'opzione che consente di restringere la ricerca solo ai titoli dei manuali. Prima di eseguire la ricerca, è possibile attivare l'opzione Solo titoli selezionando la relativa casella di controllo posta accanto al pulsante Esegui: se si seleziona questo tipo di ricerca, la parola o la frase digitata verranno ricercate solo all'interno dei titoli dei manuali.
Nella ricerca per argomento, titolo o prodotto è possibile limitare la ricerca ai manuali relativi a un particolare argomento o prodotto. All'interno di una struttura ad albero del sito docs.sun.com, è possibile utilizzare il menu Ricerca in per restringere o espandere la ricerca selezionando una sottocategoria da un elenco di collezioni, argomenti o prodotti. Durante questo tipo di consultazione le categorie e le sottocategorie vengono aggiunte all'elenco di opzioni nel menu Ricerca in; è possibile selezionare una qualsiasi categoria o sottocategoria dell'elenco Ricerca in per modificare l'ampiezza della ricerca.
Per definire l'ampiezza della ricerca, occorre scegliere una tra le seguenti opzioni del menu Ricerca in:
Selezionare l'opzione Tutti i manuali per effettuare la ricerca in tutti i manuali presenti sul sito Web docs.sun.com: questa opzione è disponibile per qualunque ricerca.
Selezionare un argomento, un prodotto o una sottocategoria per effettuare la ricerca nella struttura ad albero dell'argomento o del prodotto che si sta consultando in quel momento. Espandere la ricerca selezionando in successione le varie categorie principali fino a giungere alla categoria desiderata. Questa opzione è disponibile quando si sta visualizzando un argomento o un prodotto, una caratteristica di consultazione o un manuale.
Selezionare l'opzione Questa collezione per effettuare la ricerca solo nei manuali della collezione che si sta visualizzando in quel momento. Questa opzione è disponibile quando si visualizza una collezione di manuali o un singolo manuale pubblicato come parte della collezione.
Selezionare l'opzione Questo manuale per effettuare la ricerca solo nel manuale che si sta visualizzando in quel momento. Questa opzione è disponibile solo quando si sta visualizzando un manuale basato su XML.
La sintassi di ricerca può contenere uno qualsiasi dei seguenti elementi:
Parole – Per trovare manuali che contengano una o più parole (termini), digitare tali parole nel campo Ricerca inserendo uno o più spazi tra una parola e l'altra. Le ricerche di parole multiple restituiscono un elenco di manuali in cui sono comprese tali parole, in qualunque punto e ordine appaiano nei manuali. È possibile anche effettuare la ricerca in base al numero parte.
I caratteri diversi da lettere o numeri vengono utilizzati nel modo seguente:
I simboli pipe (|), maggiore di (>), minore di (<), il segno meno (-), i caratteri chiocciola (@), barra (/) e barra rovesciata (\) vengono utilizzati come elementi separatori di parole. Ad esempio, la ricerca dell'espressione Sun-Fire produrrà gli stessi risultati della ricerca delle parole "Sun" e "Fire".
Il segno più (+), i caratteri cancelletto (#), dollaro ($), percentuale (%) ed e commerciale (&) vengono utilizzati come elementi di inizio parola. Ad esempio, l'espressione #includi indica una singola parola, mentre l'espressione #definisci#includi viene considerata come composta dalle parole "#definisci" e "#includi".
Frasi – Per trovare manuali che contengano una certa frase, occorre racchiudere tale frase tra virgolette ( ") nel campo Ricerca. Le richieste di ricerca di frasi restituiscono un elenco di manuali in cui le parole sono visualizzate una accanto all'altra nell'ordine specificato.
Nella stessa richiesta di ricerca è possibile combinare frasi multiple: per esempio, quando si ricerca la frase "sistema solaris" CD, vengono elencati i manuali che contengono la frase completa “sistema solaris” e la parola “CD”.
Operatore jolly (*) – Per trovare manuali che contengano varianti di una parola, occorre includere un asterisco (*) alla fine della parola, o della parola all'interno di una frase, che si desidera ricercare nel campo Ricerca.
Al momento non è possibile utilizzare l'operatore jolly all'inizio o al centro di parole o stringhe.
Quando si digita, per esempio, CD*, vengono elencati i manuali che contengono le parole CD, CDs, CD-ROM, CD-ROMs e CD_ROM_FOLDER.
Il sito Web docs.sun.com è concepito per ricercare i manuali, non le pagine che contengono; quando si effettua una ricerca globale, o si utilizza il menu Ricerca in, tutti i manuali del sito vengono considerati allo stesso modo, indipendentemente dal fatto che siano basati su XML, che siano documenti HTML o manuali solo PDF.
Quando si effettua la ricerca in tutti i manuali, o si utilizza il menu Ricerca in per la ricerca nell'ambito di un dato argomento, prodotto o collezione, il numero di manuali contenenti la stringa ricercata viene visualizzato nella parte superiore della pagina relativa ai risultati della ricerca. In una pagina sono visualizzabili solo 50 manuali: se la stringa è contenuta in un numero di manuali superiore a 50, l'elenco dei risultati continua alla pagina successiva. La barra di navigazione collocata in posizione centrale nella parte superiore e inferiore della pagina indica il numero totale di pagine disponibili, mentre l'indicatore punta alla pagina attuale. È possibile visualizzare le altre pagine facendo clic sul numero di pagina.
Un elevato numero di risultati potrebbe indicare la necessità di restringere la ricerca modificando il testo di ricerca, oppure utilizzando il menu Ricerca in per ridurre l'ampiezza della ricerca.
Il sito docs.sun.com visualizza un elenco di manuali contenenti la parola o la frase ricercata in ordine decrescente di rilevanza; il grado di rilevanza di un manuale è indicato dalle seguenti icone:
I documenti contrassegnati dall'icona presentano il maggiore grado di rilevanza rispetto ai criteri di ricerca.
I documenti contrassegnati dall'icona presentano il minore grado di rilevanza rispetto ai criteri di ricerca.
Il nome della collezione in cui il manuale è incluso viene visualizzato sotto il titolo del manuale, dopo la parola “da”.
Se vengono ricercate più parole contemporaneamente, i manuali in cui tali parole appaiono una accanto all'altra sono visualizzati per primi nell'elenco; i manuali in cui tali parole appaiono separate, con una distanza massima di 30 parole, sono visualizzati per ultimi.
I manuali che contengono le parole o le frasi ricercate nel titolo di un capitolo o di una sezione, o altri elementi simili in un manuale, sono caratterizzati da una maggiore rilevanza; questi manuali saranno tendenzialmente visualizzati più in alto nell'elenco rispetto ai manuali che contengono la stessa frequenza di parole o frasi ma nei paragrafi anziché nei titoli.
Se si esegue una ricerca sul sito Web docs.sun.com in una lingua straniera, i manuali scritti in tale lingua appaiono nella parte superiore dell'elenco attuale. Se, ad esempio, si visualizza il contenuto del sito docs.sun.com in francese, nella ricerca di una parola o di una frase i manuali scritti in francese appaiono nella parte superiore dell'elenco attuale.
Quando si effettua una ricerca globale, il sito docs.sun.com ignora manuali e collezioni che richiedono una password di accesso; una volta fornita la password, tuttavia, è possibile effettuare ricerche locali a condizione che si tratti di un manuale basato su XML.
Mentre tutti i manuali sono ugualmente considerati quando si effettua una ricerca globale o quando si utilizza il menu Ricerca in, le ricerche locali sono possibili solo all'interno dei manuali basati su XML. non è possibile effettuare ricerche all'interno dei documenti HTML o dei manuali solo PDF.
Quando sul sito Web docs.sun.com viene aperto un manuale e si ricercano informazioni al suo interno, è visualizzato un sommario del manuale con una serie di icone che indicano il grado di rilevanza dei vari elementi.
Un elemento (capitolo, appendice, prefazione, glossario o indice) contrassegnato dall'icona presenta il maggiore grado di rilevanza rispetto ai criteri di ricerca.
Un elemento (capitolo, appendice, prefazione, glossario o indice) contrassegnato dall'icona presenta il minore grado di rilevanza rispetto ai criteri di ricerca.
Gli elementi di un manuale privi di rilevanza non sono contrassegnati da alcuna icona.
Le parole ricercate all'interno dei manuali basati su XML sono evidenziate: in tal modo è possibile effettuare ricerche all'interno di un manuale e consultarlo allo stesso tempo.
Lo strumento di consultazione disponibile sul sito Web docs.sun.com consente anche di effettuare ricerche nei titoli, negli argomenti o nei prodotti.
Per restringere, ad esempio, l'insieme di documenti in cui ricercare una parola, occorre selezionare la scheda Prodotto, quindi fare clic sui collegamenti Software, Solaris, Solaris 8, Solaris 8 System Administrator Collection, e infine digitare nella casella Ricerca la parola che si desidera ricercare all'interno della collezione. Quando un manuale presente nella collezione viene consultato e aperto, la parola risulta evidenziata all'interno del testo.
La tabella seguente fornisce esempi di sintassi di ricerca.
Tabella 2-1 Esempi di sintassi di ricerca