Dieses Kapitel enthält eine Einführung für den Dokumentationsserver AnswerBook2TM. Es enthält die folgenden Informationen:
Informationen zum Anzeigen der Online-Dokumentation mit Hilfe von AnswerBook2 finden Sie unter Anzeigen von Online-Dokumentation mit AnswerBook2.
AnswerBook2 ist das von Sun entwickelte Online-Dokumentsystem. Bei diesem System auf Client/Server-Basis kann der Client ein beliebiger HTML 3.2-fähiger Web-Browser sein, der auf einen http-gestützten Web-Server zugreift. Sie können AnswerBook2-Buchreihen auf einem zentralen Dokumentationsserver oder auf einem lokalen Server installieren.
Das Produkt AnswerBook2 verfügt über die folgenden Verwaltungsfunktionen:
Die zugrunde liegende Client/Server-Architektur ermöglicht die zentrale Speicherung (Server) von Dokumenten und den Zugriff vom Desktop des Benutzers (Client) aus.
Die Befehlszeilenschnittstelle (ab2admin) und die browsergestützte Benutzeroberfläche (AnswerBook2-Verwaltungsseite) dienen der Ausführung von Systemverwaltungsfunktionen.
Möglichkeit der Ausführung als CGI-Prozeß auf verschiedenen Web-Servern.
Die visuelle Anzeige von Fehlern für den Benutzer mit Hilfe der rot dargestellten Markierung "Fehler" kann über die Fehlersuchfunktion von AnswerBook2 gesteuert werden.
Bereitstellung von Protokolldateien für den Serverzugriff und aufgetretene Fehler.
Das Produkt AnswerBook2 besteht aus den folgenden Elementen:
Dokumentationsserver -- Führt Abfragefunktionen aus und gewährleistet die 'Bereitstellung' von Dokumenten für den Client-Browser. Enthält Vorlagen für ein einheitliches Erscheinungsbild beim Anzeigen und Ausdrucken von Dokumenten; verfügt über Web-Browser- und Befehlszeilenverwaltungsschnittstellen zur Ausführung von Datenbank-, Paßwortprüfungs- und anderen Verwaltungsfunktionen. Weitere Informationen über die Installation von Dokumentationsservern finden Sie unter: "Installieren der AnswerBook2-Software". Informationen über die Verwaltung von Dokumentationsservern finden Sie unter Kapitel 3.
Buchreihen -- Dabei kann es sich um neue Dokumente (SGML) oder um alte Dokumente im Format Display PostScriptTMhandeln. Informationen über das Installieren von Buchreihen auf Ihrem Server finden Sie unter "Installieren von Buchreihen".
Client-Web-Browser - Zum Anzeigen der Dokumente kann ein beliebiger HTML 3.2-kompatibler Browser verwendet werden. Informationen über das Anzeigen von Dokumenten finden Sie unter Anzeigen von Online-Dokumentation mit AnswerBook2. To enable users to access your documentation server, either you need to register the server with Federated Naming Service (FNS) or users need to know your server's URL. For information about registering your server with FNS, see "Registrieren des Dokumentationsservers ".
In der folgenden Tabelle ist angegeben, welche Komponenten für bestimmte AnswerBook2-Funktionen installiert werden müssen.
Tabelle 1-1 Wann und was zu installieren istZiel | Aktion |
---|---|
Anzeigen von Online-Dokumenten von einem Client-Browser aus (beliebige Plattform und Betriebsumgebung). | Starten Sie einen HTML 3.2-kompatiblen Web-Browser, und geben Sie den URL des Dokumentationsservers ein (z. B. http://imaserver:8888/) |
Einrichten Ihres Systems zur Bereitstellung von Dokumenten. | Installieren Sie die Dokumentationsserver-Software. Weitere Informationen finden Sie unter Kapitel 2. |
Kopieren der gewünschten Dokumente von Dokumentations-CDs, Web-Sites oder anderen Quellen auf den Dokumentationsserver. | Die Buchreihen-Pakete umfassen Verfahren, mit deren Hilfe sie nach der Installation in die Datenbank des Dokumentationsservers integriert werden. Wenn Buchreihen-Pakete auf dem Dokumentationsserver vorinstalliert sind, fügen Sie diese mit Hilfe der Funktion "Buchreihe hinzufügen" in die Datenbank des Servers ein. Weitere Informationen finden Sie unter "Installieren von Buchreihen". |
Dieser Abschnitt enthält häufig gestellte Fragen zu AnswerBook2 und Antworten auf diese Fragen.
Dem Produkt AnswerBook2 liegt ein Standard-Dokumentationsserver zugrunde, der die Online-Dokumentation von Sun über Ihren bevorzugten Web-Browser verfügbar macht. Die Oberfläche von AnswerBook2 ermöglicht das Durchblättern, die Suche und den Druck verschiedenster Informationen zu Solaris, einschließlich AnswerBook1-Buchreihen und Man Pages.
Das vorherige AnswerBook-Produkt (jetzt als AnswerBook1 bezeichnet) verwendete zur Darstellung elektronischer, vorrangig für die Druckausgabe vorgesehener Dokumentversionen das Format Display PostScript. Bei AnswerBook2 dagegen übernimmt ein Web-Browser die Bildschirmdarstellung spezieller Online-Dokumente im SGML-Format sowie vorhandener AnswerBook1-Dokumente.
Die folgende Liste enthält einige wesentliche Unterschiede zwischen den Produkten:
Web-Browser-Oberfläche - Sie können einen beliebigen HTML 3.2-kompatiblen Browser auf einer beliebigen Plattform zur Anzeige von Online-Dokumenten mit AnswerBook2 einsetzen.
Quellenflexibilität -- Der Dokumentationsserver kann AnswerBook1-Dokumente (Display PostScript) oder AnswerBook2-Dokumente (SGML) bereitstellen.
Client/Server-Unterstützung - AnswerBook2 ermöglicht die Installation des Servers und der Buchreihen an einer zentralen Stelle und das Anzeigen von Dokumenten anderer Systeme. Darüber hinaus wird ein Sicherheitsmechanismus eingesetzt, bei dem der Dokumentverwalter mehrere Dokumentationsserver definieren kann, so daß die Links zwischen Dokumenten immer zum Ergebnis führen.
Plattformübergreifender Einsatz -- Diese Version des AnswerBook2-Dokumentationsservers benötigt das Betriebssystem Solaris 2.5.1 operating environment or compatible version (SPARC oder Intel). Die AnswerBook2-Clients können jedoch auf jeder beliebigen Plattform ausgeführt werden, und in künftigen Versionen werden Serverfunktionen möglicherweise auch für andere Plattformen zur Verfügung gestellt.
Standardsucheinstellung - AnswerBook2 verwendet als Standardsucheinstellung nicht OR (wie in AnswerBook1), sondern AND.
Ja, Ihre alten AnswerBook-Dokumente müssen jedoch unter einer Solaris-Version ab 2.2 erstellt worden sein. Wenn Sie AnswerBook1-Buchreihen in die Datenbank des Dokumentationsservers integrieren möchten, wählen Sie die AnswerBook2-Funktion "Buchreihe hinzufügen", und geben Sie das Verzeichnis an, in dem sich die Datei ab_cardcatalogvon AnswerBook1 befindet.
Nein. Aus Gründen der Konsistenz ist die AnswerBook2-Oberfläche für AnswerBook1-Dokumente ähnlich aufgebaut wie die Oberfläche von AnswerBook1. Nachfolgend werden in kurzer Form die funktionalen Unterschiede zwischen AnswerBook1- und AnswerBook2-Buchreihen aufgelistet:
Bei AnswerBook1 kann das Inhaltsverzeichnis nicht insgesamt eingeschränkt oder erweitert werden, sondern immer nur abschnittsweise.
Textseiten für AnswerBook1 besitzen keinen Abschnitt "Weitere Themen". Wenn Sie von einer Seite zur nächsten gelangen möchten, verwenden Sie den Link 'Nächstes Thema' oder kehren zum Inhaltsverzeichnis zurück und wählen ein anderes Buchkapitel.
Textseiten für AnswerBook1 enthalten das gesamte Kapitel und nicht nur Ausschnitte davon.
Die Symbole für Suchergebnisse zeigen die Trefferwahrscheinlichkei für AnswerBook1-Informationen nicht zufriedenstellend an. In der Regel sind die Symbole entweder vollständig gefüllt oder vollständig leer.
In AnswerBook1-Text sind Suchbegriffe nicht hervorgehoben.
Einige AnswerBook1-Grafiken werden nicht eingebettet angezeigt, sondern durch ein Symbol dargestellt, das die PostScript-Version der Grafik anzeigt, wenn auf das Symbol geklickt wird.
Es können lediglich die (SGML-basierten) AnswerBook2 Man Pages auf dem Server anhand von Schlüsselbegriffen durchsucht werden, nicht die AnswerBook1 Man Pages.
Die AnswerBook1 Man Pages verwenden dieselbe Oberfläche wie die anderen AnswerBook1-Dokumente, eine spezielle Man Pages-Oberfläche gibt es nicht.