Wir verwenden bereits Hilfe und Handbuch für unsere Hilfedateien
Die Frage ist wirklich, was wir verwenden müssen, um Hyperlinks von der Hilfedatei zur Präsentation und zurück zu erstellen und die Präsentation trotzdem "leicht darstellbar" zu machen.
Ich werde zuerst in der Antwort zum Konvertieren von PowerPoint-Dateien in HTML nachschauen, um zu sehen, ob dies für uns funktioniert. Das könnte sehr gut sein.
Ich entschuldige mich für die lange Frage und habe sie subjektiv markiert, da es wahrscheinlich keine einzige Antwort gibt.
Wir sind in einer Position, in der wir die Tools, die wir verwenden, um verschiedene Informationsquellen für unsere Endbenutzer bereitzustellen, neu bewerten.
Folgendes haben wir bis heute:
CHM-Dateien mit Hilfe für unser Produkt (oder eine Reihe von .html-Dateien für Netzwerkfreigaben)
PowerPoint-Dateien mit Präsentationen, die während Workshops und Kursen bei der Verwendung unseres Produkts verwendet werden
HTML-Dateien und ähnliches mit eLearning-Tools
Eine Word-Datei mit allen technischen Änderungen und Produktänderungen, Bugfixes usw., die wir von einem Major-Release zum nächsten machen
Wir stellen fest, dass es von großem Vorteil wäre, wenn man versucht, alles in ein Produkt zu integrieren.
Meine Frage ist folgende: War jemand in dieser Situation und was haben Sie getan? Welche Werkzeuge hast du dir angesehen, hast du gute gefunden, was machst du jetzt? Unser Hauptproblem bei der Integration von allem in ein System besteht darin, dass der PowerPoint-Teil, in dem Sie eine Folie mit Schlüsselwörtern auf einem Projektor ablegen und dann von Folie zu Folie wechseln, problematisch wird, es sei denn, das integrierte System verfügt über eine Art "Projektormodus" Einfache Navigation, etwas, das reine HTML-Seiten nicht tun, es sei denn, sie sind für diesen Zweck codiert.
Wie auch immer, die Vorteile ...
Zum einen könnten wir stabile Hyperlinks von einem "System" zu einem anderen bereitstellen, so dass die Präsentationen zum Beispiel Links zu den relevanten Teilen der Hilfedatei enthalten können. Die Benutzer erhalten eine eigene Kopie der Präsentationsdateien, wenn sie unsere Klasse verlassen, sodass sie sie öffnen und verwenden können, wenn sie zu ihrem eigenen Arbeitsplatz zurückkehren. Daher wäre es schön, wenn sie es leicht finden, verwandte Inhalte zu finden Material, ohne sich auf sie oder das IT-Personal zu verlassen, um alles 100% richtig zu machen, wenn die Dateien auf ihren Computern abgelegt werden.
Bei unserem aktuellen Setup hat ein Hyperlink aus der PowerPoint-Datei eine relative Adresse zum entsprechenden Teil der Hilfedatei. Wenn der Benutzer die PowerPoint- und .HTML-Dateien nicht lokal auf dieselbe Weise organisiert (z. B. das Verzeichnis) Umbenannt wurde, ist alles in einem Ordner usw.), dann funktionieren die Links nicht, obwohl die Dateien vorhanden sind.
Für die Hilfedateien verwenden wir Hilfe und Handbuch, und wir überlegen, für dieses Produkt die meisten Dinge zu standardisieren. Der eLearning-Teil wird von einer separaten Firma gepflegt, daher sind wir uns nicht sicher, ob wir das jetzt in den Mix einbringen möchten.
Wir glauben, dass wir durch die Integration der technischen Informationen von changelog +, der Hilfedatei und der Klassendokumentation in einem System gewinnen können:
Stabile Hyperlinks, das funktioniert. Nicht mehr "stellen Sie sicher, dass sich die PowerPoint-Dateien und die HTML-Hilfedateien genau auf Ihrer lokalen Festplatte befinden", zwischen allen Systemen.
Ein Inhaltsverzeichnis und ein Index, der alle Systeme in einem vereint (für den Benutzer erscheint die Hilfedatei, die viel mehr Informationen enthält).
Verschiedene Ausgaben: Wir können eine einzige .CHM-Datei, einen Satz von HTML-Dateien, eine Word-Datei, eine PDF-Datei mit klickbaren, funktionierenden Hyperlinks und verschiedenen anderen Boni aus demselben Quellprojekt erstellen. Kein Ausschneiden und Einfügen von einem System zum anderen.
Wir können alles in das Hilfesystem unseres Produkts integrieren. Wenn der Benutzer auf die Hilfeschaltfläche in einem Formular in unserem Produkt klickt, kann er nicht nur die direkte Hilfedatei anzeigen, sondern er kann auch die Präsentationen der Klassen finden, die zum Unterrichten dieser Dinge verwendet wurden, sowie Links zu technischen Informationen Das IT-Personal kann Probleme beheben oder konfigurieren.
Bei uns können mehrere Personen gleichzeitig an demselben Material arbeiten. Durch die Mischung von PowerPoint- und Word-Dateien werden sie in hektischen Zeiten schnell zu Engpässen. Mit Hilfe und Handbuch können mehrere Personen gleichzeitig an denselben Projekten arbeiten.
Wiederverwenden von Assets, Bildern und Screenshots, die für ein "System" erstellt wurden, können in einem anderen wiederverwendet werden, ohne dass Duplikate erstellt werden müssen. Aktualisieren Sie eines (wenn eine neue Hauptversion das Layout, die Farben usw. ändert), und wir aktualisieren alle
Was wir verlieren:
PowerPoint-Präsentationsmodus. Wir wundern uns über die eigentlichen Klassen, da der Moderator jetzt eine HTML-Datei hat und sicherstellen muss, dass der Mauszeiger auf die Schaltfläche "nächste Seite" (die in der Hilfe und im Handbuch hinzugefügt wird) zeigt, anstatt dies zu können Verwenden Sie eines dieser Clicker-Geräte, um schnell zur nächsten und vorherigen Folie zu gelangen. Auf Folien wirkt sich auch kein einzelnes Keyword aus.
Haben Sie in Erwägung gezogen, die PowerPoint-Präsentationen in HTML zu konvertieren und mit der HTML-Hilfe in einem eigenen Abschnitt zu bündeln? ("Präsentation" zum Beispiel). Es gibt verschiedene Tools, die dies in Batch tun können, sogar kostenlos .
Unser Hauptproblem mit alles, was in ein System zu integrieren ist, dass der Powerpoint - Teil, in dem Sie eine Folie von Schlüsselwort auf einem Projektor aufstellen und dann von Folie bewegen, zu gleiten problematisch wird, wenn das integrierte System eine Art von „Projektor - Modus“ hat mit Einfache Navigation, etwas, das reine HTML-Seiten nicht tun, es sei denn, sie sind für diesen Zweck codiert.
Mit CHMs können Sie auf jeder Seite die gleiche Navigation einrichten, wie auf den Navigationsschaltflächen gezeigt:
Verwenden Sie für die Präsentationen in der Klasse die PPT-Dateien für den Vollbildmodus. Wenn die Schüler darauf verweisen müssen, liegt alles in einer einfachen CHM-Datei für sie. Keine zusätzlichen Downloads oder Installationen. Der CHM-Viewer sollte für sie in ihrer Windows-Umgebung verfügbar sein. Wenn Sie einen Teil der Präsentation referenzieren möchten, können Sie auf andere Seiten im CHM einen Hyperlink setzen. Schüler können die Schaltfläche "Zurück" im CHM-Viewer verwenden, um zu dem Punkt zurückzukehren, an dem sie sich vor dem Klicken auf den Hyperlink befunden haben.
Das sieht sehr vielversprechend aus, die HTML als Powerpoint-Tools.
Lasse Vågsæther Karlsen vor 15 Jahren
0
Das Beste ist, sie brauchen kein zweites Programm zu öffnen, wenn Sie eine Seite in der PowerPoint-Folie referenzieren möchten. CHM-Dateien können leicht auf andere Seiten innerhalb des Dokuments verweisen.
John T vor 15 Jahren
0
Eine ärgerliche Tatsache bei CHM ist dagegen, dass der Versuch, sie über eine Netzwerkfreigabe zu öffnen, problematisch ist. das dh (verwendet, um die HTML-Datei zu rendern) beschwert sich über Sicherheitsmaterial ...
akira vor 15 Jahren
0
1
Lunatik
Klingt nach einem Job für so etwas wie SharePoint . Ich habe selbst nur wenig Erfahrung darin, aber es scheint alles zu tun, was Sie brauchen.
Beachten Sie, dass die vollständige Funktionalität nur mit Microsoft Office SharePoint Server (MOSS) zur Verfügung steht. Bei einer grundlegenden Installation von Windows SharePoint Services (WSS) werden Sie wahrscheinlich mehr wollen. Der Kicker WSS ist kostenlos, MOSS nicht so kostenlos!
Es gibt Open-Source-Alternativen, aber ich überlasse es anderen, spezifische Pakete vorzuschlagen, da ich mit ihnen noch weniger vertraut bin.
Obwohl SharePoint wahrscheinlich funktionieren würde, benötigen wir etwas, das wir unseren Benutzern zur Verfügung stellen können und das sie herunterladen und eine Kopie für ihre eigenen Computer an ihrem Arbeitsplatz erhalten können. Da wir Software für Krankenhäuser und ähnliche Branchen liefern, haben sie meistens keine Internetverbindung von ihrem Arbeitsplatz aus, was bedeutet, dass eine von uns gehostete Lösung keine Option darstellt.
Lasse Vågsæther Karlsen vor 15 Jahren
0
Und mit "Download" meine ich, dass sie IT-Mitarbeiter dazu bringen können, es herunterzuladen und zu installieren.
Lasse Vågsæther Karlsen vor 15 Jahren
0
1
William Hilsum
Tut mir leid, wenn ich nicht genau das bekommen habe, was Sie wollen, aber ich glaube, ich habe
Ich persönlich habe zwei Produkte, die ich verkaufe und die eine enorme Dokumentation erfordern. Ich mache, was Microsoft mit der Verteilung von Hilfedateien macht.
Eine CD, die alles enthält -
Eine automatisch ausgeführte Datei, die eine Webseite auf der CD startet, hat ein schönes Layout und eine gute Verzeichnisstruktur.
Sie könnten / Vorträge, / Dokumente, / Hilfe etc oder / topic1 / vorträge / etc haben
Sie können freigegebene Ressourcen (z. B. Bilder) in / resources / pictures haben
... Sie können dann am Ende des Trainings problemlos eine Diskette an jeden aushändigen und Ihrem Produkt hinzufügen. Neue Versionen zu erstellen ist einfach ... und Sie können jederzeit den Stamm der Festplatte auf eine Website kopieren und dann ist die gesamte Festplatte online verfügbar! (Verwenden Sie nur relative Pfade anstelle von direkten Pfaden).
Ich habe im Laufe der Jahre so viele Content-Management-Systeme verwendet, aber ich denke ehrlich, dass es am besten ist, es selbst zu tun und die obige Methode zu verwenden.
Ich habe es etwas verfeinert, indem ich Dinge wie FlashPaper verwendet und einen Link zum Dokument zur Verfügung gestellt habe.
Wie auch immer, hoffe es gefällt dir und du kannst gerne Fragen stellen.
1
harrymc
Mein Unternehmen verwendet auch Hilfe und Handbuch, und ich glaube, es ist wahrscheinlich der Weg, den Sie gehen sollten. Die Benutzeroberfläche ist nicht so schwer zu beherrschen, und es ist das einzige mir bekannte Authoring-Produkt, das alle von Ihnen aufgeführten Formate unterstützt.
1
DaveParillo
Ich benutze doxygen für alles, was Sie beschreiben, außer der Powerpoint-Präsentation. Doxygen-Sounds auf hohem Niveau, ähnlich wie "Hilfe und Handbuch", sind plattformübergreifend und sehr konfigurierbar. Wenn Sie mit Javadoc oder ähnlichen "Tag-basierten" Doc-Systemen vertraut sind, sind Sie bereits auf halbem Weg. Es erstellt stark verlinkte, grafische Dokumente. Es wurde für API-Referenzhandbücher entwickelt, aber ich habe es "missbraucht", um fast jeden Dokumenttyp zu erstellen, den Sie sich vorstellen können.
Sie sind nicht sicher, welche Sprache Sie dokumentieren, aber doxygen unterstützt viele und Sie können nicht unterstützte Sprachen filtern, um die gewünschte Ausgabe zu generieren. Obwohl nicht offiziell unterstützt, verwende ich zum Beispiel routinemäßig doxygen, um meinen VB-Code zu dokumentieren. Ich habe häufig CHM-Dateien mit Code-Klassen- und Collaboration-Diagrammen sowie benutzerdefinierten Diagrammen direkt aus meinem Quellcode generiert. Ich mache normalerweise HTML, habe aber auch PDF und RTF produziert. Sie haben alle Hyperlinks, die Sie im HTML-Dokument finden würden.
Doxygen greift automatisch viele Links aus der Struktur Ihrer Software auf. Der Hauptnachteil, den ich gefunden habe, ist, dass, wenn Sie das von Doxygen standardmäßig angebotene Aussehen nicht mögen, Sie Ihr eigenes Cascading Stylesheet schreiben müssen. Ich habe noch nie so offen gesagt, ich weiß nicht, wie viel Stil in dem von doxygen erzeugten HTML-Code hart codiert sein könnte.
Sieht aus, als würden Hilfe und Handbuch XML als Dateiformat verwenden. doxygen kann XML erzeugen. Mit einem XML-Stylesheet können Sie ein Format in das andere konvertieren. Sie müssten dies selbst schreiben, aber Sie hätten alle Links zwischen all Ihren Dokumenten vorhanden.
Für mich hat einer der Hauptvorteile der Verwendung von doxygen nichts mit der Fähigkeit zur Erzeugung von Dokumenten zu tun. Dadurch kann ich meine gesamte Dokumentation genauso behandeln wie mein Quellcode. Es befindet sich im selben Repository, ich kann Unterschiede anzeigen und verwalten und die Dokumente zusammen mit dem Code kennzeichnen / verzweigen. Für mich ist das riesig.
