Irgendwelche Ratschläge zum Erlernen von DITA für die technische Redaktion?

Ich weiß nicht, wie viel Nutzen Sie in einem Lebenslauf haben, wenn Sie über DITA gelesen haben, im Gegensatz zu DITA , aber etwas Wissen ist besser als gar keins.

DITA ist sowohl ein spezifisches Framework als auch ein Ansatz. Meine Dokumentationsgruppe arbeitet derzeit das Buch DITA Best Practices: A Roadmap for Writing, Editing, and Architecting in DITA von Laura Bellamy, Michelle Carey und Jenifer Schlotfeldt durch, und wir finden, dass es bisher eine gute Einführung ist. Wir planen nicht, zum DITA - Framework zu migrieren, aber wir haben versucht, selbst einen ähnlichen Ansatz anzuwenden, und wir finden das Buch hilfreich, um auf Probleme hinzuweisen, über die wir nicht unbedingt genug nachgedacht haben. Das Buch enthält auch viele spezifische Informationen zum Framework, daher sollte es für jemanden, der sich voll und ganz auf DITA einlässt, noch hilfreicher sein.

Das Buch hat weniger als 300 Seiten und ist nicht sehr dicht, sodass Sie es in weniger als einer Woche aufnehmen können sollten.

Ich weiß nicht, ob das viel zu spät sein wird, aber hier ist ein kostenloses Tool, das ich zum Erlernen von DITA gefunden habe:

http://www.learningdita.com/

Ich verfolge derzeit den Kurs, obwohl er meine Todos ein wenig herabgesetzt hat. Die meisten Inhalte kenne ich bereits aus eigener Lektüre und aus dieser Perspektive würde ich sagen, dass es sehr umfassend und gründlich ist.

Obwohl ich bereits die Grundideen habe, die ich Anfängern empfehlen würde, fängt es definitiv einfach an.

Hier ist der vollständige Styleguide, der detailliert erklärt, wie Sie jedes Element verwenden, wenn Sie eintauchen und es ausprobieren:

https://www.oxygenxml.com/dita/styleguide/webhelp-feedback/index.html

Für eine praktischere Einführung können Sie das DITA Open Toolkit herunterladen und installieren . Nachdem Sie das Toolkit eingerichtet haben, können Sie:

1. Werfen Sie einen Blick auf die DITA XML-Quelle für eine echte Veröffentlichung, nämlich das DITA Open Toolkit-Benutzerhandbuch. Die Quelle befindet sich im Ordner docsrc, Sie können aber auch auf GitHub darauf zugreifen .
2. Verwenden Sie diese Quelle, um die endgültige Ausgabe zu erstellen, z. B. HTML oder ein PDF. Lesen Sie dazu die DITA-OT-Dokumentation neu erstellen (oder Kapitel 20 in der PDF-Version).
3. Öffnen Sie eine .dita-Themendatei. Versuchen Sie, dieses Thema im Dokument zu finden, indem Sie nach seinem Titel suchen. Beachten Sie, wie das XML einer bestimmten Themenstruktur folgt . In DITA ist ein Thema die Grundeinheit des Authoring .
4. Öffnen Sie eine .ditamap-Datei und vergleichen Sie das, was Sie sehen, mit dem Inhaltsverzeichnis in dieser Publikation. Beachten Sie, wie DITA Map-Elemente verwendet werden , um eine Reihe von Themen zu organisieren.
5. Nehmen Sie eine kleine Änderung am Titel eines Themas vor (möglicherweise nachdem Sie eine Sicherungskopie erstellt haben) und erstellen Sie die Publikation neu. Beachten Sie, wie Ihre Änderung in die neue Version des Dokuments übernommen wird.
6. An diesem Punkt werden Sie feststellen, dass es eine ziemliche Herausforderung sein kann, ein Dokument in DITA ohne zusätzliche Tool-Unterstützung zu schreiben. Hier kommen „DITA-fähige“ Tools wie Oxygen XML Author ins Spiel, um Bearbeitungsunterstützung zu bieten. Beachten Sie, dass Oxygen im Lieferumfang des DITA Open Toolkit enthalten ist. Es gibt eine Liste von Tools, die das DITA Open Toolkit auf dita-ot.org verwenden . Siehe auch diese Liste von DITA-bezogenen Software-Tools .

Abschnitt 2.2.1.2 des Oasis-Standards Darwin Information Typing Architecture (DITA) enthält weitere Informationen zu den Vorteilen der themenbasierten Erstellung.

Weitere Beispiele für DITA-basiertes Authoring finden Sie in der Liste der Open-Source-DITA-Sammlungen auf oasis-open.org.