Visa onlinedokumentation med AnswerBook2-systemet

Kapitel 1 Introduktion

Det här kapitlet är en introduktion till AnswerBook2, och dessutom får du reda på var du kan hitta mer information om hur det används. Det innehåller följande information:

Information om hur du administrerar en dokumentationsserver finns i Installera och administrera en AnswerBook2-server.

AnswerBook2 - översikt

AnswerBook2 är Suns onlinedokumentationssystem. Den använder ett webbläsargränssnitt där du kan visa och skriva ut olika sorters information om Sun , inklusive SGML-baserade AnswerBook^TM-samlingar, Display PostScript^TM AnswerBook-samlingar och direkthjälpen (man).

AnswerBook2 innehåller en kraftfull sökmotor som hjälper dig söka efter information i hela dokumentationsbiblioteket. Du kan installera AnswerBook2-dokumentsamlingar på en central dokumentationsserver eller på en lokal server.

Obs!

I AnswerBook2-dokumentationen används termen AnswerBook1 om den version av AnswerBook som följer med äldre versioner av operativsystemet Solaris än 2.6.

AnswerBook2 Funktioner och egenskaper

AnswerBook2 innehåller följande funktioner och formler:

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, till exempel på kommandoraden, beroende på webbläsarens funktionalitet.
Med den kraftfulla sökmotorn kan du söka efter ord och uttryck i hela dokumentationsbiblioteket.
Du kan skriva ut avsnitt och hela böcker direkt från AnswerBook2-gränssnittet i ett PostScript-format med nästan samma kvalitet som tryckta dokument.
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 dokumentationsserver.
Du kan välja vilket språk som du vill att instruktioner och hjälptexter ska visas på.
Tack vare klient-server-arkitekturen kan dokumenten lagras på en enda plats (servern) och läsas från användarens skrivbordsdator (klienten).
Du kan administrera dokumenthanteringen både i ett kommandoradsbaserat gränssnitt (CLI) och ett webbläsarbaserat gränssnitt (GUI).

Nya AnswerBook2-funktioner i den här versionen

Följande lista visar vilka nya, eller väsentligt utökade funktioner som ingår i denna utgåva (Version 1.4) av programvaran AnswerBook2.

Stöd för operativsystemet Solaris 2.5.1

Tidigare var programvaran AnswerBook2 bara tillgänglig för operativsystemen Solaris 2.6 och Solaris 7.
Tillgång till programvaran på en Sun-webbplats, eller CD för någon annan Sun-produkt

Programvaran AnswerBook2 kan, utöver att levereras tillsammans med operativsystemen Solaris 2.6 och Solaris 7, också levereras tillsammans med annan Sun-produkt-CD, eller hämtas direkt från en Sun-webbplats.
Möjlighet att söka efter en speciell dokumentsamling

Med popup-menyn Search (Sökning) kan du välja att söka inom den aktuella dokumentsamlingen. Se Kapitel 5.
Mindre ändringar i navigeringsfunktionerna

Ikonerna i navigeringsfältet (högst upp på sidan) har ersatts med text. Dessutom har en orienteringsfunktion, som visar var i uppsättningen som sökning pågår, lagts in närmast under navigeringsfältet. Se Kapitel 3.

Ingående delar

AnswerBook2 består av följande delar:

En klientwebbläsare - Du kan visa Suns onlinedokumentation i vilken HTML 3.2-kompatibel webbläsare som helst. Om du vill visa dokumentationen måste du känna till URL-adressen till en dokumentationsserver. Du kan också läsa utgiven Solaris-dokumentation på http://docs.sun.com/.

Obs!
Om du bara vill visa onlinedokumentation behöver du bara en klientwebbläsare. Alla andra delar ingår i dokumentserversystemet.
En dokumentationsserver - Utför frågefunktioner och tillhandahåller dokument till klientwebbläsaren. Innehåller mallar som ger ett välbekant utseende vid visning och utskrift av dokument. Både webbläsargränssnittet och gränssnittet för kommandoradsadministration ingår för databasfunktioner, lösenordsverifiering och andra administrativa funktioner.
Dokumentsamlingar - Kan vara både nya dokument (SGML) och gamla dokument (Display PostScript).

Vanliga frågor

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 dokumentationsserver för att visa Suns onlinedokumentation i din webbläsare. Med hjälp av gränssnittet i AnswerBook2 kan du bläddra, söka efter och skriva ut en mängd 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^TM 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.

Följande lista visar de huvudsakliga skillnaderna mellan produkterna:

Webbläsargränssnitt - Du kan använda en valfri HTML 3.2-kompatibel webbläsare på vilken plattform som helst för att visa onlinedokumentationen med AnswerBook2.
Flexibla källor - Dokumentationsservern kan visa både AnswerBook1-dokument (Display PostScript) och AnswerBook2-dokument (SGML).
Klient-server-stöd - Med AnswerBook2 kan du installera server- och dokumentsamlingarna på en central plats och sedan komma åt dokumenten från andra system. Dessutom finns en "fail-over"-mekanism som gör att dokumentadministratören kan definiera flera dokumentationsservrar så att länkar mellan dokument alltid fungerar.
Plattformsoberoende - I den här versionen måste AnswerBook2-dokumentservern köras i operativmiljön Solaris 2.5.1, Solaris 2.6 eller Solaris 7 (SPARC eller Intel). Dock kan AnswerBook2-klienter köras på vilken plattform som helst, och framtida versioner kan komma att erbjuda serverfunktionalitet för flera plattformar.
Standardsökfunktioner - AnswerBook2 använder logiskt AND som standard vid sökning i stället för OR (standardsökfunktionalitet 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 dokumentationsserverns 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?

Nej. För enhetlighetens skull är gränssnittet i AnswerBook2 för AnswerBook1-dokument snarlikt gränssnittet i AnswerBook1. Här följer en kortfattad lista över funktionsskillnader mellan AnswerBook1- och AnswerBook2-samlingar:

Du kan inte visa eller dölja alla nivåer i en AnswerBook1-innehållsförteckning, 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.
Ikonerna för sökresultatet visar bara grovt sannolikheten för en matchning i AnswerBook1-information. Ikonerna är oftast antingen helt fyllda eller helt tomma.
Söktermer markeras inte i AnswerBook1-text.
Utskriftsfunktionen stöder bara utskrift av ett kapitel i taget för en AnswerBook1-bok. AnswerBook1-grafik visas inte direkt utan representeras av en ikon som öppnar en PostScript-visning av grafiken när du klickar på den.
I en sökning av typen Direkthjälp efter nyckelord ingår bara AnswerBook2-direkthjälpen (SGML-baserade sidor) på servern, inte AnswerBook1-hjälpen.
För AnswerBook1-hjälpen används samma gränssnitt som för alla andra AnswerBook1-dokument. Det finns inget särskilt direkthjälpsgränssnitt.