Introducción al producto AnswerBook2

El producto AnswerBook2 es el sistema de documentación en línea de Sun. Utiliza un navegador de web que permite visualizar e imprimir información diversa de Solaris^TM, incluidas colecciones de AnswerBook^TM basadas en SGML y en Display PostScript^TM y páginas del comando man.

El producto AnswerBook2 proporciona un mecanismo de búsqueda que permite encontrar información a través de la biblioteca de documentación. Puede instalar las colecciones de documentos en un servidor de documentación centralizado o en un servidor local.

A lo largo de la documentación de AnswerBook2, el término AnswerBook1 se refiere a la versión del producto AnswerBook proporcionada con las versiones del sistema operativo Solaris anteriores a 2.6.

Características y funciones de AnswerBook2

El producto AnswerBook2 ofrece las siguientes características y funciones:

• Utiliza una interfaz basada en un navegador de web, que permite visualizar documentación en línea desde cualquier plataforma (con cualquier sistema operativo), mientras disponga de un navegador de web que admita HTML 3.2

• Según las funciones de su navegador de Web, permite copiar información de los documentos de AnswerBook2 y pegarla en otros lugares, como su línea de comandos.

• Proporciona una interfaz de búsqueda para localizar palabras y frases a través de toda la biblioteca de documentación

• Proporciona la capacidad de imprimir capítulos y manuales directamente desde la interfaz de AnswerBook2 en un formato PostScript con calidad similar a la de imprenta

• Permite visualizar documentos AnswerBook antiguos y nuevos mediante una única interfaz

• Permite definir un subconjunto de colecciones de documentos (una biblioteca personal) para que se muestre al utilizar un servidor de documentos específico

• Permite elegir un idioma en el que visualizar las instrucciones en pantalla y la información de ayuda

• Utiliza arquitectura cliente-servidor, que posibilita el almacenaje de los documentos en una única ubicación (servidor) y el acceso a ellos desde el escritorio del usuario (cliente)

• Proporciona tanto una interfaz de línea de comandos (CLI, Command Line Interface) como una interfaz gráfica (GUI, Graphical User Interface) para llevar a cabo tareas administrativas

Nuevas funciones de AnswerBook2 para esta versión

La lista siguiente identifica las funciones nuevas o sustancialmente mejoradas de esta versión del software AnswerBook2.

• Páginas del comando man (Manual de referencia) en formato AnswerBook2

  Las páginas de manual (man) en estilo tradicional de UNIX® están disponibles en formato AnswerBook2. La interfaz de búsqueda permite optar por buscar sólo en las páginas del comando man basadas en SGML instaladas en el servidor de documentación.

• Admisión de contenidos multimedia

  Si la fuente del documento incluye archivos de audio o vídeo, el sistema AnswerBook2 permite acceder a ellos según lo que haya definido en su navegador para la admisión de audio y vídeo.

• Posibilidad de ejecutar el servidor AnswerBook2 directamente desde el CD de documentación de Solaris 7 (sólo administradores del servidor)

  Puede ejecutar el servidor AnswerBook2 directamente desde el CD de documentación de Solaris 7 mediante la secuencia ab2cd, si dispone de éste y tiene acceso de usuario root al sistema al que aquél está. Para obtener información detallada sobre esta función, véase "Para ejecutar un servidor de documentación desde CD de documentación de Solaris 7".

• Capacidad para utilizar varios servidores de web basados en CGI (sólo administradores del servidor)

  El servidor AnswerBook2 puede ejecutarse como un módulo NSAPI mediante el servidor incluido en los paquetes de servidor de AnswerBook2 o como una aplicación basada en CGI mediante cualquier servidor httpd que admita CGI (tal como Netscape Server^TM o Sun WebServer^TM). Para obtener información detallada sobre cómo cambiar a un servidor de web basado en CGI y algunas limitaciones posibles, véase "Ejecución del servidor AnswerBook2 como un proceso CGI".

• Capacidad para controlar la visualización de los errores de las hojas de estilo (sólo administradores del servidor)

  Para controlar si se muestra la palabra "DEFECTO" en color rojo a los usuarios cuando se producen errores en las hojas de estilo, active o desactive la función de depuración de AnswerBook2. Esta función se define al iniciar el servidor de documentación. Para más información, véase Inicio y paro del servidor de documentación en la ayuda de AnswerBook2.

Componentes y piezas

El producto AnswerBook2 está compuesto de los siguientes elementos:

• Un navegador de Web: la versión Solaris 7 incluye el navegador Netscape; sin embargo, puede utilizar cualquier examinador que cumpla el estándar HTML 3.2 para visualizar la documentación en línea de Sun.

  ---

  Nota -

  Si únicamente desea ver la documentación en línea y tiene acceso al URL de un servidor de documentación, sólo necesita este elemento. El resto de elementos son parte del sistema del servidor de documentación (una máquina en la que se instalan las colecciones de documentos y que ejecuta un servidor basado en Web para proporcionárselos). Si no tiene acceso a un servidor de documentación en su sede, puede ver toda la documentación publicada de Solaris en: http://docs.sun.com

  ---

• Un servidor de documentación: realiza las funciones de consulta y "sirve" los documentos al navegador cliente. Incluye plantillas que proporcionan un "aspecto" común para la visualización e impresión de documentos; también proporciona interfaces de administración de navegador de web y línea de comandos que realizan funciones de administración de bases de datos, autentificación de contraseña y otras funciones administrativas.

• Colecciones de documentos: pueden ser documentos nuevos (SGML) o antiguos (Display PostScript).

Preguntas habituales sobre el tema

Esta sección presenta una lista de algunas preguntas habituales relativas al producto AnswerBook2, junto con respuestas a estas preguntas.

¿Qué es AnswerBook2?

El producto AnswerBook2 utiliza un servidor de documentos estándar para distribuir documentación en línea de Sun mediante su navegador de web favorito. La interfaz de AnswerBook2 permite examinar, buscar e imprimir información diversa de Solaris, incluidas colecciones de AnswerBook1 y páginas del comando man.

¿En qué se diferencia AnswerBook2 de AnswerBook?

El anterior producto AnswerBook (llamado ahora AnswerBook1) utilizaba Display PostScript para mostrar versiones electrónicas de documentos inicialmente desarrollados para su impresión en papel. El producto AnswerBook2 utiliza un navegador de Web para mostrar documentación desarrollada para su distribución en línea mediante SGML y para mostrar los documentos de AnswerBook1 ya existentes.

Algunas diferencias clave entre los productos son:

• Interfaz de navegador de Web: con el producto AnswerBook2 puede utilizar cualquier navegador compatible con HTML 3.2 en cualquier plataforma para ver documentación en línea.

• Flexibilidad de fuente: el servidor AnswerBook2 puede proporcionar documentos AnswerBook1 ( Display Postscript^TM) o documentos AnswerBook2 (SGML).

• Soporte cliente-servidor: el producto AnswerBook2 permite instalar el servidor y las colecciones de documentos en una ubicación central y visualizar los documentos desde otros sistemas. Además, incluye un mecanismo "a prueba de fallos" mediante el cual el administrador de documentos puede definir varios servidores de documentación para que siempre funcionen los enlaces entre documentos.

• Plataformas cruzadas: en esta versión, debe ejecutarse el servidor de documentos AnswerBook2 en el sistema operativo Solaris 7 (SPARC o Intel). No obstante, los clientes AnswerBook2 pueden ejecutarse en cualquier plataforma, y las versiones futuras pueden proporcionar las funciones de servidor en plataformas adicionales.

• Comportamiento de búsqueda predeterminado: el producto AnswerBook2 utiliza AND para su comportamiento de búsqueda predeterminado en lugar de OR (el comportamiento de búsqueda predeterminado del producto AnswerBook1).

¿Puedo seguir visualizando mis colecciones de AnswerBook antiguas con AnswerBook2?

Sí, a menos que haya creado sus documentos AnswerBook antiguos antes de la publicación del sistema operativo Solaris 2.2. Para agregar colecciones de AnswerBook1 a la base de datos del servidor AnswerBook2, el administrador de documentos utiliza la función "agregar colección" de AnswerBook2 y señala al directorio que contiene el archivo ab_cardcatalog de AnswerBook1.

¿Proporciona AnswerBook2 la misma funcionalidad para los documentos de AnswerBook1 que para los de AnswerBook2?

No. Por coherencia, la interfaz de AnswerBook2 para los documentos AnswerBook1 es similar a la del producto AnswerBook1. Sin embargo, el producto AnswerBook2 posee las siguientes diferencias de funcionalidad para las colecciones de AnswerBook1 y de AnswerBook2:

• No es posible mostrar u ocultar todos los niveles de un listado de tabla del contenido de AnswerBook1; sólo puede mostrar u ocultar detalles para un apartado específico de la tabla del contenido.

• Las páginas de índice de AnswerBook1 no incluyen secciones Otros temas. Para navegar de una página a otra, puede utilizar el enlace Siguiente tema o regresar a la Tabla del contenido y seleccionar una sección distinta del manual.

• Las páginas de índice de AnswerBook1 muestran todo el capítulo de una sola vez, no secciones menores.

• Los iconos de resultado de búsqueda no representan bien la probabilidad de haber encontrado la información buscada en los AnswerBook1; estos iconos tienden a estar completamente llenos o completamente vacíos.

• Los términos buscados no quedan resaltados en el texto de los AnswerBook1.

• No es posible mostrar en el mismo documento algunos gráficos AnswerBook1; éstos están identificados por un icono que cuando se pulsa muestra una imagen PostScript del gráfico.

• Una búsqueda Páginas del comando man por palabra clave sólo incluye las páginas del comando man de AnswerBook2 (basadas en SGML) del servidor y no las páginas del comando man de AnswerBook1.

• Las páginas del comando man de AnswerBook1 utilizan la misma interfaz que el resto de documentos AnswerBook1; no tienen una interfaz especial de páginas de comando man.