Este capítulo presenta el servidor de documentación AnswerBook2. Incluye la información siguiente:
Si desea obtener información sobre cómo utilizar el producto AnswerBook2 para ver la documentación en línea, consulte Consulta de documentación en línea con el sistema AnswerBook2.
El producto AnswerBook2 es el sistema de documentación en línea de Sun. Se trata de un sistema basado en cliente-servidor en el que el cliente es cualquier navegador de Web compatible con HTML 3.2 y el servidor es un servidor Web basado en httpd. Puede instalar colecciones de documentos AnswerBook2 tanto en un servidor de documentación centralizado como en uno local.
El producto AnswerBook2 incluye las características de administración siguientes:
Utiliza arquitectura cliente-servidor, que posibilita que los documentos estén almacenados en una única ubicación (servidor) y que se acceda a ellos desde el escritorio del usuario (cliente)
Proporciona una interfaz de línea de comandos (ab2admin) y otra basada en navegador (página Administración de Answerbook2) para realizar las funciones de administración del servidor
Permite ejecutar un servidor AnswerBook2 directamente desde el AnswerBook2 CD
Puede ejecutarse como un proceso CGI en varios servidores Web
Permite controlar si se muestran visualmente los errores a los usuarios con la palabra "DEFECTO" en color rojo, activando o desactivando la función de depuración de AnswerBook2
Incluye archivos de registro para los accesos y errores del servidor
El producto AnswerBook2 se compone de los siguientes elementos:
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ñas y otras funciones administrativas. Para obtener información sobre la instalación de un servidor de documentación, véase "Instalación del software de AnswerBook2". Para obtener información sobre la administración de un servidor de documentación, véase el Capítulo 3.
Colecciones de documentos: pueden ser documentos nuevos (SGML) o antiguos (Display PostScriptTM). Para obtener información sobre la instalación de colecciones de documentos en su servidor, véase "Instalación de colecciones de documentos".
Un navegador de Web cliente: los usuarios pueden utilizar cualquier navegador compatible con HTML 3.2 para ver la documentación. Para más información sobre cómo ver la documentación, véase Consulta de documentación en línea con el sistema AnswerBook2. Para permitir que los usuarios puedan acceder a su servidor de documentación, necesita registrar el servidor con Federated Naming Service (FNS) o bien los usuarios necesitan conocer el URL de su servidor. Para obtener información sobre cómo registrar su servidor con FNS, véase "Registro de su servidor de documentación".
La tabla siguiente indica lo que necesita hacer o instalar para proporcionar funciones específicas de AnswerBook2.
Tabla 1-1 Cuándo y qué instalarSi desea... | Debe... |
---|---|
Ver documentación en línea desde un navegador cliente (cualquier plataforma, cualquier sistema operativo). | Iniciar un navegador de Web compatible con HTML 3.2 e introducir el URL del servidor de documentación (por ejemplo, http://imaserver:8888/). |
Activar su sistema (máquina) para proporcionar (ofrecer) documentación. | Instalar el software del servidor de documentación. Véase el Capítulo 2. |
Agregar documentación desde el CD del producto, sedes Web u otras fuentes a su servidor de documentación. | Los paquetes de colecciones de documentos incluyen procedimientos de post-instalación que los agregan a la base de datos del servidor de documentación. Si tiene colecciones de documentos preinstalados en el servidor de documentación, utilice las funciones de "agregar colección" para agregar las colecciones de documentos a la base de datos del servidor. Para más información sobre la instalación de las colecciones de documentos, véase "Instalación de colecciones de documentos". |
Esta sección presenta una lista de algunas preguntas habituales relativas al producto AnswerBook2, junto con respuestas a estas preguntas.
El producto AnswerBook2 utiliza un servidor de documentación basado en estándares para proporcionar la documentación en línea de Sun a través de su navegador de Web favorito. La interfaz de AnswerBook2 permite examinar, buscar e imprimir información diversa, incluidas colecciones de AnswerBook1 y páginas del comando man.
El anterior producto AnswerBook (llamado ahora AnswerBook1) utilizaba Display PostScriptTM 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.
La lista siguiente identifica algunas diferencias clave entre los productos:
Interfaz basado en navegador de Web: con el producto AnswerBook2, puede utilizar cualquier navegador compatible con HTML 3.2 en cualquier plataforma para ver la documentación en línea.
Flexibilidad de fuente: el servidor de documentación puede proporcionar documentos AnswerBook1 (Display PostScript) o documentos AnswerBook2 (SGML)
Soporte de cliente-servidor: el producto AnswerBook2 permite instalar el servidor y las colecciones de documentos en una ubicación central y ver los documentos desde otros sistemas. Además, incorpora un mecanismo de "salto" por medio del 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, el servidor de documentación AnswerBook2 debe ejecutarse en el sistema operativo Solaris 2.5.1, Solaris 2.6 o 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).
Sí, a menos que haya creado sus documentos AnswerBook antiguos antes de la publicación del sistema operativo Solaris 2.2. Para agregar colecciones AnswerBook1 a la base de datos del servidor de documentación, el administrador de documentos utiliza la función "agregar colección" de AnswerBook2 y señala al directorio que contenga el archivo ab_cardcatalog de AnswerBook1.
No. Por coherencia, la interfaz de AnswerBook2 para los documentos AnswerBook1 es similar a la del producto AnswerBook1. A continuación se muestran brevemente las diferencias funcionales para las colecciones AnswerBook1 y AnswerBook2:
No puede mostrar u ocultar todos los niveles de un listado completo 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 las 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 el capítulo completo 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.
Algunos gráficos de AnswerBook1 no se pueden mostrar de forma integrada; se identifican por un icono en el que puede hacer clic para mostrar la imagen PostScript del gráfico.
Una búsqueda de Páginas del comando man por palabra clave sólo incluye las páginas del comando man de AnswerBook2 (basadas en SGML) del servidor, pero no las de AnswerBook1.
Éstas utilizan la misma interfaz que el resto de documentos AnswerBook1; no tienen una interfaz especial de páginas de comando man.