Introduktion till produkten AnswerBook2

Produkten AnswerBook2 är Sun-systemet för onlinedokumentation. Den använder ett webbläsargränssnitt som gör att du kan läsa och skriva ut olika typer av information om Solaris^TM, inklusive SGML-baserade AnswerBook^TM-samlingar, AnswerBook-samlingar i Display PostScript^TM och direkthjälpen.

Produkten AnswerBook2 innehåller en sökfunktion som kan användas för att söka efter information i hela dokumentationsbiblioteket. Du kan installera dokumentsamlingar på en central dokumentserver eller på en lokal server.

I hela AnswerBook2-dokumentationen avser termen AnswerBook1 den version av AnswerBook-produkten som ingick i tidigare versioner av Solaris-operativmiljön än version 2.6.

AnswerBook2-funktioner

AnswerBook2 innehåller följande funktioner:

• Ett webbläsarbaserat gränssnitt gör att du kan visa onlinedokumentation från valfri plattform (på valfritt operativsystem), men din webbläsare måste innehålla stöd för HTML 3.2.

• Du kan kopiera information från AnswerBook2-dokument och klistra in den någon annanstans, t ex på kommandoraden. För att detta ska fungera måste webbläsaren ha funktioner för detta.

• Med den kraftfulla sökfunktionen kan du söka efter ord och uttryck i hela dokumentationsbiblioteket.

• Du kan skriva ut kapitel och böcker direkt från AnswerBook2-gränssnittet i PostScript-format och få nästan samma kvalitet som i en tryckt bok.

• Du kan visa gamla och nya AnswerBook-dokument i samma gränssnitt.

• Du kan definiera en delmängd av dokumentsamlingar (ett eget bibliotek) som ska visas när du använder en specifik dokumentserver.

• Du kan välja vilket språk som anvisningarna på skärmen och hjälpinformationen ska visas på.

• Tack vare klient-server-arkitekturen kan dokumenten lagras på en enda plats (server) och kommas åt från användarens skrivbord (klient).

• Du kan administrera dokumenthanteringen både i ett kommandoradsbaserat gränssnitt (CLI) och ett läsarbaserat gränssnitt (GUI).

Nya AnswerBook2-funktioner i den här versionen

Följande lista innehåller nya eller avsevärt förbättrade funktioner i den här versionen av programmet AnswerBook2.

• Direkthjälp (referenshandbok) i AnswerBook2-format

  Direkthjälp (man pages) i traditionellt UNIX®-utförande är nu tillgängliga i AnswerBook2-format. Med sökfunktionerna kan du välja att bara söka i den SGML-baserade direkthjälpen (man pages) som är installerad på dokumentationsserver.

• Stöd för multimedieinnehåll

  Om dokumentkällan innehåller ljud- eller videofiler kan du visa dem i AnswerBook2-systemet enligt inställningarna för ljud- och videostöd i webbläsaren.

• Du kan köra en AnswerBook2-server direkt från dokumentations-CD för Solaris 7 (endast serveradministratörer)

  Du kan köra AnswerBook2-servern direkt från dokumentations-CD för Solaris 7 med hjälp av kommandofilen ab2cd, om du har tillgång till CD:n och root-behörighet till det system som CD:n är ansluten till. Mer information om den här funktionen finns i "Så här kör du en dokumentationsserver från dokumentations-CD för Solaris 7".

• Du kan använda flera CGI-baserade webbservrar (endast serveradministratörer)

  AnswerBook2-servern kan köras antingen som en NSAPI-tilläggsmodul med den server som ingår i AnswerBook2-serverpaketen eller som ett CGI-baserat program med någon httpd-server som stöder CGI (t ex Netscape Server^TM eller Sun WebServer^TM). Mer information om hur du byter till en CGI-baserad webbserver och eventuella begränsningar finns i "Köra AnswerBook2-servern som en CGI-process".

• Du kan styra visningen av formatmallsfel (endast serveradministratörer)

  Du styr om ordet "BUG" ska visas i rött för användaren när det inträffar formatmallsfel genom att aktivera eller inaktivera AnswerBook2-felsökningsfunktionen. Den här inställningen gör du när du startar dokumentservern. Mer information finns i Starta och stanna dokumentationsservern i AnswerBook2-hjälpen.

Delar som ingår

Produkten AnswerBook2 består av följande delar:

• En klientwebbläsare - I Solaris 7 ingår webbläsaren Netscape. Du kan emellertid använda valfri HTML 3.2-kompatibel läsare för att visa Suns onlinedokumentation.

  ---

  Obs!

  Om du bara vill visa onlinedokumentation och har tillgång till dokumentationsserverns URL behöver du inte den här delen. Alla de andra delarna ingår i dokumentationsserversystemet (en dator där dokumentuppsättningarna är installerade och kör en webbaserad server körs för att tillhandahålla dokumentuppsättningarna). Om du inte har tillgång till en dokumentationsserver på din arbetsplats kan du visa all Solaris-dokumentation som har kommit ut hittills på: http://docs.sun.com

  ---

• En dokumentationsserver - Utför frågefunktioner och tillhandahåller dokument till klientwebbläsaren. Innehåller mallar som ger dokumenten ett gemensamt utseende vid visning och utskrift. Ger möjlighet till både webbläsar- och kommandoradsadministration för databaser, lösenordsverifiering och andra administrativa funktioner.

• Dokumentuppsättningar - Kan vara både nya dokument (SGML) och gamla dokument (Display PostScript).

Vanliga frågor och svar

Det här avsnittet innehåller några vanliga frågor om AnswerBook2 och svaren på de frågorna.

Vad är AnswerBook2?

AnswerBook2 använder en standardbaserad dokumentserver för att visa Suns onlinedokumentation i din webbläsare. Med hjälp av AnswerBook2 kan du bläddra, söka efter och skriva ut en mängd Solaris-information, inklusive AnswerBook1-samlingar och direkthjälpen (man).

På vilket sätt skiljer sig AnswerBook2 från AnswerBook?

Föregående version av AnswerBook (AnswerBook1) använde Display PostScript för att visa elektroniska versioner av dokument som främst var utvecklade som pappersdokument. AnswerBook2 använder en webbläsare för att visa onlinedokumentation som är utvecklad för att visas elektroniskt med hjälp av SGML, och för att visa befintliga AnswerBook1-dokument.

Här följer några viktiga skillnader mellan produkterna:

• Webbläsargränssnitt - Du kan använda valfri HTML 3.2-kompatibel webbläsare på vilken plattform som helst för att visa onlinedokumentationen med AnswerBook2.

• Källflexibiltet - AnswerBook2-servern kan tillhandahålla både AnswerBook1-dokument (Display Postscript^TM) och AnswerBook2-dokument (SGML).

• Klient-server-stöd - Med AnswerBook2 kan du installera servern och dokumentuppsättningarna på en central plats och sedan komma åt dokumenten från andra system. Dessutom finns det en "felhanteringsfunktion" som gör att dokumentadministratören kan definiera flera dokumentservrar så att länkar mellan dokument alltid fungerar.

• Plattformsoberoende - I den här versionen måste AnswerBook2-dokumentservern köras i Solaris 7-operativmiljön (SPARC eller Intel). Dock kan AnswerBook2-klienter köras på vilken plattform som helst, och framtida versioner kan komma att innebära serverfunktionalitet för flera plattformar.

• Standardsökfunktioner - AnswerBook2 använder som standard logiskt OCH vid sökning i stället för ELLER (standardsökfunktion för AnswerBook1).

Kan jag fortfarande visa mina gamla AnswerBook-samlingar med AnswerBook2?

Ja, om inte dina gamla AnswerBook-dokument är äldre än operativmiljön Solaris 2.2. Om du vill lägga till AnswerBook1-samlingar i AnswerBook2-serverns databas använder du AnswerBook2-funktionen "lägg till samling" och pekar på katalogen som innehåller AnswerBook1-filen ab_cardcatalog.

Innehåller AnswerBook2 samma funktioner för AnswerBook1- och AnswerBook2-dokument?

För enhetlighetens skull är AnswerBook2-gränssnittet för AnswerBook1-dokument snarlikt gränssnittet i AnswerBook1. Därför innehåller AnswerBook2 följande skillnader mellan AnswerBook1- och AnswerBook2-samlingar:

• Du kan inte visa eller dölja alla nivåer i en AnswerBook1-innehållsförteckning. Du kan bara visa eller dölja ett visst avsnitt i innehållsförteckningen.

• AnswerBook1-innehållssidor innehåller inte Andra avsnitt. Om du vill navigera från en sida till en annan, kan du använda länken Nästa avsnitt eller återgå till innehållsförteckningen och markera ett annat avsnitt i boken.

• AnswerBook1-innehållssidor visar hela kapitlet på en gång, inte mindre avsnitt.

• Sökresultatsikoner återspeglar inte sannolikheten för en matchning för AnswerBook1-information. Ikonerna är oftast helt fyllda eller helt tomma.

• Söktermer markeras inte i AnswerBook1-text.

• AnswerBook1-grafik visas inte direkt utan representeras av en ikon som öppnar en PostScript-bild av grafiken när du klickar på den.

• I en sökning av typen direkthjälp med nyckelord (man pages by keyword) genomsöks bara AnswerBook2-direkthjälpen (SGML-baserad) på servern, inte AnswerBook1-direkthjälpen.

• AnswerBook1-direkthjälpen använder samma gränssnitt som andra AnswerBook1-dokument. Det finns inget särskilt direkthjälpsgränssnitt.