typo3 techdoc extension - rolf schwermer · typo3 techdoc extension open-source webcms für die...

52
TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation

Upload: others

Post on 16-Aug-2020

14 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

TYPO3 Techdoc Extension

Open-Source WebCMS für die Technische Dokumentation

Page 2: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

Personen

Sascha NothoferTechnischer Redakteur, Diplom (FH), Hannover 2007

Stefan EikeTechnischer Redakeur, Bachelor (FH), Hannover 2008

Page 3: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

Fallbeispiel

● Kleines Unternehmen mit gerigem Budget● TYPO3-Webpräsenz vorhanden ● Übergreifende Synergieeffekte erforderlich

Page 4: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

Agenda

1 TYPO32 Anforderungen der TD3 Praktische Umsetzung4 Live-Demo5 Ergebnis und Ausblick

Page 5: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

Agenda

1 TYPO32 Anforderungen der TD3 Praktische Umsetzung4 Live-Demo5 Ergebnis und Ausblick

Page 6: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

05. März 2010 Typo3 Techdoc Extension 6

TYPO3

● Web-CMS● Rollen- und Rechteverwaltung● Integriertes Sprachmanagement● Versionierung (Fallback)● Medienverwaltung DAM● Erweiterungsschnittstelle● Editor für Authoring ohne HTML-Kenntnisse

und WYSIWYG

Page 7: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

05. März 2010 Typo3 Techdoc Extension 7

Typo3 Einsatzszenarien

6000 registrierte Projekte● Unternehmen

● EADS● VW● ThyssenKrupp

● Wissensportale● Institute

Page 8: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

05. März 2010 Typo3 Techdoc Extension 8

Wahl eines CM-Systems

Out-of-the-box-CMS vs. TYPO3-Lösung

Page 9: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

05. März 2010 Typo3 Techdoc Extension 9

Wahl eines CM-Systems

Out-of-the-box-CMS vs.● Rich-Application-Komfort

TYPO3-Lösung● Eingeschränkte RIA-Fähigkeiten

(Web 2.0, Ajax)

Page 10: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

05. März 2010 Typo3 Techdoc Extension 10

Wahl eines CM-Systems

Out-of-the-box-CMS vs.● Rich-Application-Komfort

● Für TR-Anforderungen konzipiert

TYPO3-Lösung● Eingeschränkte RIA-Fähigkeiten

(Web 2.0, Ajax)

● Für Web-Anforderungen konzipiert (Struktur/GUI)

Page 11: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

05. März 2010 Typo3 Techdoc Extension 11

Wahl eines CM-Systems

Out-of-the-box-CMS vs.● Rich-Application-Komfort

● Für TR-Anforderungen konzipiert

● Schnittstellen schwer erreichbar durch geschlossenen Quellcode, vordefinierte kostenpflichtige Erweiterungen

TYPO3-Lösung● Eingeschränkte RIA-Fähigkeiten

(Web 2.0, Ajax)

● Für Web-Anforderungen konzipiert (Struktur/GUI)

● Offene Schnittstellen/Quellcode, viele Extensions

Page 12: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

05. März 2010 Typo3 Techdoc Extension 12

Wahl eines CM-Systems

Out-of-the-box-CMS vs.● Rich-Application-Komfort

● Für TR-Anforderungen konzipiert

● Schnittstellen schwer erreichbar durch geschlossenen Quellcode, vordefinierte kostenpflichtige Erweiterungen

● Immer ein vollständig neues System notwendig

TYPO3-Lösung● Eingeschränkte RIA-Fähigkeiten

(Web 2.0, Ajax)

● Für Web-Anforderungen konzipiert (Struktur/GUI)

● Offene Schnittstellen/Quellcode, viele Extensions

● Bestehendes Know-How und IT-Infrastruktur kann voll genutzt werden

Page 13: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

05. März 2010 Typo3 Techdoc Extension 13

Wahl eines CM-Systems

Out-of-the-box-CMS vs.● Rich-Application-Komfort

● Für TR-Anforderungen konzipiert

● Schnittstellen schwer erreichbar durch geschlossenen Quellcode, vordefinierte kostenpflichtige Erweiterungen

● Immer ein vollständig neues System notwendig

● Unterschiedliche Strategien

TYPO3-Lösung● Eingeschränkte RIA-Fähigkeiten

(Web 2.0, Ajax)

● Für Web-Anforderungen konzipiert (Struktur/GUI)

● Offene Schnittstellen/Quellcode, viele Extensions

● Bestehendes Know-How und IT-Infrastruktur kann voll genutzt werden

● Skalierbares System erfordert komplexe Administrationsschicht

Page 14: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

05. März 2010 Typo3 Techdoc Extension 14

Wahl eines CM-Systems

Out-of-the-box-CMS vs.● Rich-Application-Komfort

● Für TR-Anforderungen konzipiert

● Schnittstellen schwer erreichbar durch geschlossenen Quellcode, vordefinierte kostenpflichtige Erweiterungen

● Immer ein vollständig neues System notwendig

● Unterschiedliche Strategien

● Abhängig vom Softwarehersteller

– Support– Systemanpassung– Produktstrategie (Features)– Upgrades/Updates

TYPO3-Lösung● Eingeschränkte RIA-Fähigkeiten

(Web 2.0, Ajax)

● Für Web-Anforderungen konzipiert (Struktur/GUI)

● Offene Schnittstellen/Quellcode, viele Extensions

● Bestehendes Know-How und IT-Infrastruktur kann voll genutzt werden

● Skalierbares System erfordert komplexe Administrationsschicht

● Unabhängiger Support

– große Community– viele Typo3-Dienstleister

(724 allein in Deutschland)– Kostenlose Updates/Upgrades

Page 15: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

05. März 2010 Typo3 Techdoc Extension 15

Wahl eines CM-Systems

TYPO3-Lösung● Eingeschränkte RIA-Fähigkeiten

(Web 2.0, Ajax)

● Für Web-Anforderungen konzipiert (Struktur/GUI)

● Offene Schnittstellen/Quellcode, viele Extensions

● Bestehendes Know-How und IT-Infrastruktur kann voll genutzt werden

● Skalierbares System erfordert komplexe Administrationsschicht

● Unabhängiger Support

– große Community– viele Typo3-Dienstleister

(724 allein in Deutschland)– Kostenlose Updates/Upgrades

Page 16: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

05. März 2010 Typo3 Techdoc Extension 16

TYPO3 für Print-Medien?

Ein Web-CMS fürDruck-Publikationen?

Page 17: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

05. März 2010 Typo3 Techdoc Extension 17

TYPO3 für Print-Medien?

● T3N-Magazinyeebase media

Page 18: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

05. März 2010 Typo3 Techdoc Extension 18

TYPO3 für Print-Medien?

● T3N-Magazinyeebase media

Page 19: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

05. März 2010 Typo3 Techdoc Extension 19

TYPO3 für Print-Medien?

● T3N-Magazinyeebase media

● CMP3 – Cross-Media Publishing mit TYPO3naw.info net&works Internet Services GmbH

– Kataloge– Zeitschriften– Bücher– CD-ROM– Web

Page 20: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

05. März 2010 Typo3 Techdoc Extension 20

Funktionsweise CMP3

Page 21: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

05. März 2010 Typo3 Techdoc Extension 21

Partnerschaft

Page 22: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

Agenda

1 TYPO32 Anforderungen der TD3 Praktische Umsetzung4 Live-Demo5 Ergebnis und Ausblick

Page 23: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

Anforderungen der TD

● TD-Dokument-Strukturen● Modulares Bausteine/Wiederverwendbarkeit● Strenge Versionsverwaltung (Datensicherheit)● Unabhängiges Datenformat

(weiterverarbeitbar)● Schnittstelle für externes

Übersetzungsmanagement (TMS)● Bonus: Verwaltung von Produktdaten

Page 24: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

Agenda

1 TYPO32 Anforderungen der TD3 Praktische Umsetzung4 Live-Demo5 Ergebnis und Ausblick

Page 25: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

Umsetzung

● Implementierung der DITA-Datenstrukturen● Integration von referenzieller

Wiederverwendung● Autorenwerkzeug für DITA-Authoring

mittels WYSIWIG-Editor● Produktdatenbank

– Individuelle Datenfelder/Kategorien– Mehrsprachigkeit– Dynamische Platzierung mit Platzhaltern

Page 26: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

DITA vs. TYPO3

Page 27: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

DITA vs. TYPO3

Typo3 bietet die Möglichkeit Seiten und CE an unterschiedlichen Positionen zu referenzieren

Page 28: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

DITA vs. TYPO3

DITA-Map

DITA-Topic

Durch Referenzierung sind Inhalte wiederverwendbar

Page 29: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

Mikrostruktur

● Was ist mit innertextlichen Strukturen?– Querverweise (xref), – Referenzierung von Topic-Bestandteilen (conref),– Related Links,– usw...

Page 30: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

XML-Editor in TYPO3

DITA-Storm Editor (Inmedius Inc.)● WYSIWYG● Steuert Struktureinhaltung (Topic, Map)● Gibt mögliche Elemente vor● Erlaubt Referenzen (conref, xref)● Unterstützt alle DITA-Metadaten● Erlernt Spezialisierungen

Page 31: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

DITA-Storm

Page 32: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

Produktdatenbank

● Zentrale Pflege der Produktdaten● Via Marker in DITA- und Web-Inhalten● Erhöht Wiederverwendbarkeit● Kategorisierung auf zwei Ebenen● Erbt Übersetzbarkeit von Typo3

Page 33: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

Referenzierung von Produktdaten

Über Text-Marker (String-Variablen)

Page 34: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

Referenzierung von Produktdaten

Page 35: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

Übersetzungsmanagement

● Typo3 intern via Browser● extern via DITA-Export (Roundtripping V2.0)● extern via DB-Dump für TMS (Typo3-

Extension)● Schnittstelle zu externem

Managementsysteme (z.B. Ontram, Andrä AG)

Page 36: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

TD-Workflow

Page 37: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

Agenda

1 TYPO32 Anforderungen der TD3 Praktische Umsetzung4 Live-Demo5 Ergebnis und Ausblick

Page 38: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

Agenda

1 TYPO32 Anforderungen der TD3 Praktische Umsetzung4 Live-Demo5 Ergebnis und Ausblick

Page 39: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

Ergebnis

Page 40: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

Ergebnis

Page 41: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

Ergebnis

Page 42: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

Ergebnis

Page 43: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

Ergebnis

Page 44: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

Ergebnis

Page 45: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

Ergebnis

Page 46: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

Ergebnis

Page 47: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

Ergebnis

● Enterprise CMS mit PDB● Singel-Source-Publishing● Wiederverwendbare Textbausteine● Anschluss an Translation Memory

Page 48: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

Zielgruppe

● DITA muss sich zur Repräsentation der benötigten Dokumente eignen (Spezialisierung möglich)

● Hoher Wiederverwendungswert der Informationen

● Kleinere Redaktionen (kein Workflow-Management)

● Unternehmen, die Typo3 einsetzen (wollen)

Page 49: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

Ausblick

● Ausbau der Managementfunktionen in der Mikro-Ebene

● Verbesserung der Usability hinsichtlich TR-Anforderungen

● XML/DITA-Editor auf Open-Source-Basis

Page 50: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

Vielen Dank für Ihr Interesse

OpenSource lebt vom Mitmachen ;)

Diese Präsentationentstand mit Hilfe von

freier Software

UbuntuOpenOffice.org

InkscapeGimp

ShutteryEd Graph Editor

Page 51: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

05. März 2010 Typo3 Techdoc Extension 51

Weitere Informationen

● XING-Gruppe „Darwin Information Typing Architecture“

● www.naw.info● Zeitschrift der tekom: Ausgaben 1/08 + 2/08● [email protected]

Page 52: TYPO3 Techdoc Extension - Rolf Schwermer · TYPO3 Techdoc Extension Open-Source WebCMS für die Technische Dokumentation. Personen Sascha Nothofer Technischer Redakteur, Diplom (FH),

05. März 2010 Typo3 Techdoc Extension 52

Und nun sind Sie gefragt

● Ist das System für Ihre Umgebung eine interessante Lösung?

● Welche Features fehlen Ihnen?● An welcher Stelle hinkt das Produkt?● Welche anderen Open-Source-Ansätze wären

denkbar?