Cómo utilizar el sitio web docs.sun.com

Capítulo 1 Novedades del sitio web docs.sun.com

Los servicios del sitio web docs.sun.comSM se han mejorado en la versión 3.0.

A continuación se indica la información contenida en este capítulo:

¿En qué consiste la versión 3 de docs.sun.com?

Si bien la versión 3 del sitio web docs.sun.com es muy similar a la versión anterior, en realidad se trata de un sistema completamente nuevo. El sitio ahora está totalmente escrito en el lenguaje de programación JavaTM, implantado sobre el software Oracle®, y opera en el servidor de web Open Net Environment (Sun ONE) de SunTM.

La mayor parte de la documentación de este sitio se creó en SGML y se tradujo a XML para su publicación. Sin embargo, parte de ella está en HTML y parte en el formato de manuales PDF solamente. Siempre que sea posible, el sitio docs.sun.com considera a los manuales en formato HTML y sólo PDF, como equivalentes de los manuales basados en XML, aunque sólo es posible realizar determinadas funciones para la documentación basada en XML.

Si bien se han realizado grandes mejoras, el sitio web docs.sun.com continúa siendo un sistema de biblioteca en línea que publica manuales y colecciones de manuales. En consecuencia, sus sistemas de búsqueda y exploración no están orientados hacia archivos sino hacia manuales.

Principales cambios en la versión 3 de docs.sun.com

Sintaxis de búsqueda simplificada

Los operadores “y” y “o” ya no se necesitan. Si la búsqueda contiene más de un término, se realiza una búsqueda aproximada. Ahora usted puede anexar el operador de comodín (*) para buscar términos. Así, la búsqueda de archivo* corresponde a “archivo” y “archivos”.

Observe también que los documentos pesan más si contienen términos de búsqueda en capítulos, secciones y otros títulos.

Resultados de la búsqueda y Bread Crumbs

Las búsquedas efectuadas dentro de los árboles de temas o productos ahora incluyen un localizador del tipo “bread crumb” en la parte superior de la página para facilitar la navegación.

Búsqueda por número de referencia

Los números de referencia ahora están indexados. En la interfaz de usuario no existe ninguna función que explícitamente de soporte a la búsqueda de números de referencia. Simplemente debe escribir éstos como lo haría para buscar cualquier otro término.

URL simplificadas, estables

Las URL ahora son tan cortas como humanamente sea posible comprenderlas. Además, ahora se garantiza la estabilidad de las URL para las páginas principales de manuales y colecciones de manuales (tablas de contenidos), así como las URL enumeradas bajo colecciones y los vínculos de las Categorías por temas, Títulos y Categorías por producto. A continuación se indican algunos ejemplos de URL estables:

Siempre que no se realice el vínculo a algún punto dentro de un manual (que siempre puede actualizarse en el lugar), los vínculos y marcadores son seguros.

Si usted es un escritor técnico o un web master, este nivel de estabilidad le permite incluir vínculos con la documentación de los productos de Sun en sus documentos y páginas web.

Dos modos protegidos

El sitio web docs.sun.com ahora soporta la documentación Beta (protegida por contraseña) y Early Access. Para ver la documentación Early Access, usted debe confirmar que ha leído la declaración de renuncia antes de que se le autorice el acceso a esta documentación.

Nueva tabla de contenido de la página de comando man

La arquitectura de la tabla de contenido de los manuales de páginas de comando man contiene una entrada de la tabla de contenido para cada sección de la página de comando man, que a su vez se convierte en una lista alfabética de páginas de comando man.

Internacionalización

Si selecciona japonés, chino o chino simplificado, no necesita especificar ninguna codificación.

Nueva funcionalidad para manuales basados en XML

Esta sección describe la nueva funcionalidad disponible si accede a manuales basados en XML en el sitio web docs.sun.com.

Búsqueda en manuales y colecciones de manuales

Las búsquedas globales y las búsquedas de alcance global (es decir, las búsquedas que usted realiza con el Menú desplegable) consideran a todos los tipos de manuales como equivalentes. Sin embargo, usted sólo puede efectuar la búsqueda en manuales basados en XML. No puede realizar la búsqueda en documentos HTML o en manuales con formato sólo PDF.

Exploración en manuales y colecciones de manuales

También está disponible una eficiente interfaz de exploración generada automáticamente, para manuales y colecciones de manuales basados en XML. Esta interfaz es más sofisticada que la interfaz de navegación disponible en manuales y colecciones de manuales en HTML o en formato sólo PDF, debido a que está integrada en la búsqueda local. Para probarla, realice la búsqueda local en un manual o en una colección de manuales basados en XML y luego deje la búsqueda activada mientras explora en la tabla de contenido del manual o la colección de manuales.

Modo y soporte sólo TTY

La documentación basada en XML ahora está disponible para visualizarse en terminales simples sólo TTY. Los manuales basados en XML están formateados para visualizarse en hojas de estilo en el tiempo de ejecución. También está disponible un segundo juego de hojas de estilo en formato sólo TTY, que formatean las páginas estructuradas para usarse cuando no está disponible un explorador gráfico de web. Para usar esta nueva función, se deberá ejecutar Lynx u otro explorador sólo TTY. HTML nativo también funciona en este contexto, aunque no tan bien, debido a que las hojas de estilo que utiliza el sitio docs.sun.com generan HTML optimizado para usarse en un explorador sólo TTY.

Esta nueva función permite a los administradores del sistema de servidores de aplicaciones acceder al sitio docs.sun.com, tengan o no acceso a los sistemas.

Índices alfabéticos de manuales en línea

Los manuales basados en XML ahora contienen índices alfabéticos basados en hipertexto y generados automáticamente.