Utilisation du site Web docs.sun.com

Chapitre 1 Nouveautés du site Web docs.sun.com

La version 3.0 du site Web docs.sun.com SM propose des services améliorés.

Vous trouverez, ci-dessous, une liste des informations contenues dans ce chapitre :

Qu'est-ce que docs.sun.com, version 3.0 ?

Bien que la version 3 du site Web docs.sun.com ressemble énormément à la précédente, il s'agit d'un système entièrement nouveau. Le site est à présent entièrement écrit en langage JavaTM, implémenté au-dessus du logiciel Oracle®, et s'exécute sur le serveur Web SunTM Open Net Environment (Sun ONE).

La majorité de la documentation disponible sur ce site a été écrite en SGML et traduite en XML en vue de sa publication. Une partie de cette documentation est toutefois disponible en HTML et certains ouvrages au format PDF seul. Aussi fréquemment que possible, le site docs.sun.com traite les ouvrages HTML et PDF seul comme s'ils étaient basés sur XML, mais un certain nombre de fonctions sont uniquement applicables à la documentation basée sur XML.

Bien qu'ayant fait l'objet d'un grand nombre d'améliorations, le site Web docs.sun.com reste un système de bibliothèque en ligne qui publie des ouvrages et des collections. Les systèmes de recherche et de navigation dont il dispose sont donc plus orientés vers les ouvrages que vers les fichiers.

Principales modifications de la version 3 de docs.sun.com

Syntaxe de recherche simplifiée

Les opérateurs “et” et “ou” ne sont plus nécessaires. Lorsqu'une recherche contient plus d'un terme, une recherche par opérateurs de proximité est exécutée. Vous pouvez à présent ajouter l'astérisque (*) en tant qu'opérateur de recherche. La recherche du terme fichier* vous fournira à la fois les occurences de “fichier” et de “fichiers.”

Notez également que les documents sont bien plus lourds lorsque leurs chapitres ou sections contiennent des termes de recherche ou d'autres titres.

Résultats des recherches et arborescences hiérarchiques

Les recherches effectuées depuis l'arborescence de sujets ou de produits incluent maintenant un dispositif de localisation de type “bread crumb”, situé dans la partie supérieure de la page et destiné à faciliter la navigation.

Recherche par référence

Les références sont à présent indexées. Aucune fonctionnalité de l'interface utilisateur ne prend explicitement en charge la recherche de références. Il suffit de procéder comme pour tout autre terme de recherche, c'est-à-dire d'entrer la référence recherchée.

URL stables simplifiées

Les URL sont maintenant aussi courtes et compréhensibles que possible. Qu'il s'agisse de celles des pages d'accueil d'ouvrages ou de collections (table des matières), de celles qui figurent sur les pages consacrées aux collections ou de celles des liens des onglets Catégories de sujets, Titres, et Catégories de produits, leur stabilité est désormais garantie. Exemples d'URL stables :

Vos liens et signets restent stables tant que vous n'ouvrez pas un lien (susceptible d'être mis à jour automatiquement) situé à l'intérieur d'un ouvrage.

Si vous êtes rédacteur technique ou webmaster, cette stabilité vous permettra d'inclure à vos documents ou pages web des liens menant vers la documentation d'un produit Sun.

Deux modes protégés

Le site Web docs.sun.com prend maintenant en charge à la fois la documentation bêta (protégée par un mot de passe) et Early Access. Pour pouvoir accéder à la documentation Early Access, vous devez confirmer avoir lu la clause de non-responsabilité correspondante.

Nouvelle table des matières des pages man

Les ouvrages contenant les pages man comportent maintenant une entrée de table des matières pour chaque section. Cette entrée mène à son tour à une liste alphabétique des pages man.

Internationalisation

Il n'est plus nécessaire de spécifier le codage lorsque vous sélectionnez le Japonais, le Chinois ou le Chinois simplifié.

Nouvelle fonctionnalité pour les ouvrages basés sur XML

Cette section décrit la nouvelle fonctionnalité fournie par le site Web docs.sun.com pour les ouvrages basés sur XML.

Recherche dans les ouvrages et les collections

Les recherches globales et recherches globales étendues (recherches exécutées à l'aide du menu déroulant Rechercher dans) traitent tous les types d'ouvrages comme des paires. Vous ne pouvez cependant effectuer ces recherches qu'à 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.

Navigation dans les ouvrages et les collections

Une interface de navigation efficace, générée automatiquement, est également disponible pour les ouvrages basés sur XML et les collections. Elle est plus sophistiquée que l'interface de navigation disponible pour les ouvrages HTML ou PDF seul, car elle est intégrée à la recherche locale. Pour essayer cette interface de navigation, lancez une recherche locale à l'intérieur d'un ouvrage basé sur XML ou d'une collection, puis laissez la recherche en mode actif pendant que vous naviguez dans la table des matières à la recherche d'un ouvrage ou d'une collection.

Mode TTY seul et prise en charge

La documentation basée sur XML peut maintenant être visualisée sur de simples terminaux TTY seul. Ces ouvrages sont formatés de manière à pouvoir être affichés par des feuilles de style "runtime". Un deuxième jeu de feuilles de style TTY seul est disponible pour formater les pages structurées en cas d'absence de navigateur graphique. Pour utiliser cette nouvelle fonction, vous devez exécuter Lynx ou tout autre navigateur TTY seul. Le HTML natif fonctionne également dans ce contexte, mais de façon moins satisfaisante, car les feuilles de style utilisées par docs.sun.com génèrent le HTML, qui est optimisé en vue de son utilisation par un navigateur TTY seul.

Cette nouvelle fonction permet aux administrateurs d'applications de back-office d'accéder au site docs.sun.com, qu'ils aient accès ou non aux systèmes.

Index des ouvrages en ligne

Le dos des ouvrages basés sur XML porte maintenant des index basés sur hypertexte et générés de manière automatique.