In questo capitolo vengono descritti il concetto di collezione e le altre strutture in cui è organizzata la documentazione del sito Web docs.sun.com; la comprensione del funzionamento di queste strutture permette di consultare il sito in modo più efficiente. È possibile consultare 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 basati su HTML, visualizzati in strutture ad albero di capitoli e sezioni.
Manuali solo PDF.
Se si accede a manuali per prodotti beta ancora in fase di verifica, il sito Web docs.sun.com richiede una password; quando il prodotto è disponibile nella versione finale, la password non è più necessaria.
Di seguito è indicato un elenco delle informazioni contenute in questo capitolo:
Strutture organizzative che rendono più efficiente la consultazione del sito Web docs.sun.com
Consultazione all'interno dei manuali presenti nel sito Web docs.sun.com
Una collezione è un gruppo di manuali correlati presenti nel sito Web docs.sun.com e relativi alla stessa versione di prodotto. Questi manuali sono raggruppati in collezioni per i seguenti motivi:
Fanno riferimento a un singolo prodotto o suite di prodotti.
Hanno lo stesso argomento.
Si rivolgono a una categoria specifica di lettori.
Un singolo manuale può essere presente in una o più collezioni oppure costituire una categoria a sé.
È possibile che i manuali relativi a un prodotto siano inclusi in più collezioni perché quel particolare prodotto potrebbe essere trattato in manuali diversi. Spesso i manuali sono raggruppati in collezioni diverse allo scopo di facilitare la consultazione.
I manuali sono reperibili al seguente indirizzo statico http://docs.sun.com. Se si creano segnalibri o collegamenti personali ai manuali o alle collezioni elencate nella pagina della categoria soggetto o della categoria prodotto, è possibile accedere a quelle pagine senza dover avviare una nuova richiesta di consultazione o ricerca. Questa staticità consente anche di includere collegamenti alla documentazione Sun nei documenti.
Il sito docs.sun.com offre strutture organizzative che consentono di migliorare l'efficacia della consultazione e della ricerca della documentazione. Queste strutture sono utilizzabili selezionando il collegamento alla relativa scheda nel sito docs.sun.com:
Argomento – Le collezioni e il manuale, o i manuali, che compongono la collezione sono raggruppati e visualizzati in base all'argomento principale.
Titolo – I manuali e le collezioni sono elencati in ordine alfabetico per titolo di manuale o di collezione.
Prodotto – I manuali e le collezioni sono raggruppati e visualizzati in base al prodotto in essi descritto.
La home page del sito docs.sun.com offre anche collegamenti alle informazioni richieste più frequentemente.
Se si consulta il 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 consultazione per titolo, argomento o prodotto i manuali scritti in francese appaiono nella parte superiore dell'elenco attuale.
Le funzionalità di consultazione disponibili per un determinato manuale dipendono dal suo formato originale. Il sito docs.sun.com contiene manuali pubblicati in tre formati: XML, HTML e PDF. In questa sezione verranno descritte le diverse modalità di consultazione proprie di ciascun formato.
Se si accede a un manuale basato su XML, viene visualizzato un sommario che contiene una serie di collegamenti. È possibile fare clic sul collegamento relativo al capitolo, all'appendice, alla prefazione, al glossario o all'indice per visualizzare la parte corrispondente del manuale. È quindi possibile fare clic sulle icone e per aprire e chiudere questi elementi. È possibile anche fare clic sulle incone e per aprire e chiudere un intero manuale. Per spostarsi da un capitolo all'altro o da una sezione all'altra, occorre fare clic sui collegamenti.
Quando si accede a un manuale HTML, viene aperta la pagina iniziale oppure l'“indice” del manuale stesso in una nuova finestra del browser; ciò accade perché i manuali HTML non dispongono delle funzionalità di consultazione di docs.sun.com. Per continuare a usare docs.sun.com, è necessario ritornare alla finestra iniziale del browser.
Alcuni manuali sono pubblicati solo in formato PDF. Quando si accede a un manuale di cui è disponibile solo il formato PDF, si verrà indirizzati a una pagina con informazioni sulle dimensioni del file PDF e opzioni per il download. Come scaricare e stampare un file di documento PDF presente nel sito docs.sun.com descrive in che modo scaricare e stampare i file di documento solo PDF.