Este capítulo describe la sintaxis de búsqueda y las opciones de búsqueda que se utilizan en el sitio web docs.sun.com. Se puede buscar cualquier documento en este sitio, independientemente del formato en el que se encuentre. Los formatos disponibles incluyen:
Manuales basados en XML, que se visualizan como un árbol de capítulos y secciones.
Manuales HTML, que se visualizan como un conjunto de páginas
Manuales en formato sólo PDF.
A continuación se indica la información contenida en este capítulo:
Esta sección describe las funciones del sitio web docs.sun.com que permiten limitar la búsqueda.
El sitio docs.sun.com cuenta con una opción relacionada con los títulos de los manuales que le permite limitar la búsqueda. Antes de solicitar una búsqueda, se puede seleccionar Buscar sólo en títulos de manuales haciendo clic en el cuadro de selección que se encuentra junto al botón Ir. Si se selecciona Buscar sólo en títulos de manuales, el sitio busca sólo los títulos de manuales correspondientes a la palabra o frase que se escribió.
Dentro de títulos, categorías de temas o categorías de productos, se puede limitar la búsqueda a los manuales que se encuentren dentro de un tema o producto en particular. A medida que se asciende o se desciende por la estructura de árbol del sitio docs.sun.com, se puede usar el Menú desplegable para limitar o ampliar el alcance de la búsqueda, mediante la selección de una subcategoría de una lista de colecciones, temas o productos. A medida que se realiza la exploración en categorías y subcategorías, éstas se agregan a la lista de opciones de la lista. Se puede seleccionar cualesquiera de las categorías o subcategorías de la lista para modificar el alcance de la búsqueda.
Para determinar el alcance de la búsqueda, seleccione una de las siguientes opciones del Menú desplegable:
Seleccione la opción Todos los manuales, para realizar la búsqueda en todos los manuales del sitio web docs.sun.com. Esta opción está disponible para cualquier búsqueda.
Seleccione una categoría de temas o de productos, o una subcategoría, para realizar la búsqueda en el árbol de temas o de productos que se esté explorando en el momento de realizar la búsqueda. Amplíe la búsqueda mediante la selección de cualesquiera de las categorías principales que se haya explorado para llegar a la categoría actual. Esta opción está disponible cuando se visualiza una categoría de temas o de productos, una función de exploración o un manual.
Seleccione la opción para realizar la búsqueda sólo en los manuales de la colección que esté visualizando en el momento de la búsqueda. Esta opción está disponible cuando se visualiza una colección o cualquier manual publicado como parte de una colección.
Seleccione la opción Este manual para realizar solamente la búsqueda del manual que se esté visualizando en el momento de la búsqueda. Esta opción está disponible solamente cuando se visualiza un manual basado en XML.
La sintaxis de búsqueda puede contener cualquiera de los siguientes elementos:
Palabras: para encontrar manuales que contengan una o más palabras (o términos), escriba las palabras en el campo Buscar. Separe cada palabra con uno o más espacios. Las solicitudes de búsqueda de múltiples palabras, dan como resultado una lista de manuales que contienen todas las palabras, en cualquier lugar que aparezcan en los manuales, y en cualquier orden. También se puede realizar la búsqueda por número de referencia.
Caracteres que no son letras o números se tratan de la siguiente manera.
Los símbolos de barra vertical (|), mayor que (>), menor que (<), menos (-), 'arroba' (@), la barra inclinada (/) y la barra inversa (\) se tratan como caracteres separadores de palabras. Por ejemplo, una búsqueda de la frase Sun-Fire se tratará como una búsqueda de las dos palabras "Sun" y "Fire".
Los signos más (+), almohadilla (#), dólar ($), porcentaje (%) y (&) se tratan como caracteres de inicio de palabra. Por ejemplo, #include se trata como una palabra, mientras que #define#include se trata como las palabras, "#define" e "#include".
Frases: Para encontrar manuales que contengan una frase, encierre la frase entre comillas (") en el campo Buscar. Las solicitudes de búsqueda de frases dan como resultado una lista de manuales en los que aparecen estas frases una junto a otra en el orden especificado.
Se pueden combinar múltiples frases en una misma solicitud de búsqueda. Por ejemplo, cuando se busca la frase "solaris system" CD, se indican los manuales que contienen la frase “solaris system” completa y la palabra “CD”.
Operador de comodín (*): para encontrar manuales que contengan variaciones de una palabra, agregue un asterisco (*) al final de la palabra o de una palabra dentro de una frase que se desea buscar, en el campo Buscar.
Actualmente no se puede usar el operador de comodín al principio o en el medio de palabras o cadenas de caracteres.
Por ejemplo, cuando se escribe CD*, se indican los manuales que contienen las palabras CD, CDs, CD-ROM, CD-ROMs y CD_ROM_FOLDER.
El sitio web docs.sun.com está diseñado para buscar manuales, no páginas de manuales. Cuando se realiza una búsqueda global o se utiliza el Menú desplegable para realizar una búsqueda global, el sitio considera a todos los manuales por igual, tanto si la palabra o frase que está buscando aparece en manuales basados en XML, documentos HTML o manuales en formato sólo PDF.
Cuando se realiza la búsqueda en todos los manuales o se utiliza el Menú desplegable para buscar información relacionada con un tema, un producto o una colección, los manuales que contienen la cadena de caracteres que se está buscando aparecen en la parte superior de la página de resultados de la búsqueda. Sólo se visualizan 50 manuales en una página. Si la cadena de caracteres se encuentra en más de 50 manuales, la lista de manuales continúa en la página siguiente. La barra de navegación de página situada en la parte superior central y en la parte inferior central de la página, indica la cantidad total de páginas disponibles. El indicador apunta a la página actual. Se pueden visualizar otras páginas, haciendo clic en el número de página.
Si aparece una gran cantidad de correlaciones, eso significa que deberá limitar la búsqueda, ya sea cambiando el texto de búsqueda ya sea utilizando el Menú desplegable para limitar el alcance de la búsqueda.
El sitio docs.sun.com muestra una lista de manuales que contienen la palabra o la frase que se busca en orden de importancia decreciente. La importancia de un manual se indica mediante iconos:
Los documentos marcados con el icono son los más importantes de acuerdo con el criterio de búsqueda.
Los documentos marcados con el icono son los menos importantes de acuerdo con el criterio de búsqueda.
El nombre de la colección a la que pertenece el manual se indica debajo del título del manual, después de la palabra “de”.
Si se busca más de una palabra por vez, los manuales en los que las palabras aparecen más cerca una de otras se indican al principio de la lista. Los manuales en los que las palabras aparecen más separadas, a una distancia máxima de 30 palabras, se indican en la parte inferior de la lista.
A los manuales que contienen palabras o frases en el título de un capítulo, en el título de una sección o en un elemento similar en un manual, se les asigna una mayor importancia. Estos manuales tienden a moverse hacia el principio de la lista, en relación con los manuales que contienen la misma frecuencia de palabras o frases, pero sólo en párrafos en lugar de títulos.
Cuando selecciona otro idioma para visualizar el sitio web docs.sun.com, los manuales escritos en ese idioma aparecen al principio de la lista actual cuando se realiza una búsqueda en el sitio. Por ejemplo, si se visualiza el contenido del sitio en francés, los manuales escritos en ese idioma aparecen al principio de la lista actual cuando se realiza la búsqueda por palabra o por frase.
Cuando realiza una búsqueda global, el sitio docs.sun.com ignora los manuales y las colecciones de manuales que requieren una contraseña para acceder a ellos. Sin embargo, si ingresa una contraseña, se puede realizar una búsqueda en forma local en un manual, siempre que esté basado en XML.
Si bien el sitio docs.sun.com considera a todos los manuales por igual, cuando se realiza una búsqueda global o se utiliza el Menú desplegable para realizar una búsqueda global, en el caso de los manuales basados en XML, la búsqueda sólo puede hacerse en forma local. No puede realizar la búsqueda en documentos HTML o en manuales con formato sólo PDF.
Cuando se abre y se busca información en un manual en el sitio web docs.sun.com, éste muestra la tabla de contenido del manual con iconos que indican la importancia de los elementos del manual.
Cualquier capítulo, apéndice, prefacio, glosario o índice alfabético marcado con el icono es el más importante de acuerdo con el criterio de búsqueda.
Cualquier capítulo, apéndice, prefacio, glosario o índice alfabético marcado con el icono es el menos importante de acuerdo con el criterio de búsqueda.
Los elementos del manual que no tienen importancia no están marcados con el icono.
Las palabras con las que realiza la búsqueda se resaltan en los manuales basados en XML. De esta forma, se puede realizar la búsqueda y la exploración en un manual al mismo tiempo.
El mecanismo de exploración disponible en el sitio web docs.sun.com no sólo es un mecanismo de exploración, sino que también es un mecanismo que se puede utilizar para realizar la búsqueda entre títulos, categorías de temas o categorías de productos.
Por ejemplo, se puede restringir la cantidad de documentos en los que desea realizar la búsqueda de una palabra, mediante la selección de la ficha Categorías por productos, luego haciendo clic en los vínculos de Colección de Software, Solaris, Solaris 8 y Administrador del Sistema Solaris 8; después, en la ventana Buscar, se debe escribir la palabra que se desea buscar dentro de dicha colección. Cuando se realiza la exploración y se abre un manual de la colección, la palabra se muestra resaltada cuando aparece en el texto.
La siguiente tabla contiene ejemplos de sintaxis de búsqueda.
Tabla 2-1 Ejemplos de sintaxis de búsqueda