Infotrend September 2008

trend

Info

September 2008

DOGREL Website mit TYPO3

Inhalt

Multimedia: Nach einem internen Workshop zum Thema neue DOGREL Website, mit Beteiligten aus allen Abteilungen, stand fest: Unsere Website muss sich nahtlos in unser neues CI einfügen, einfach und klar soll sie sein, technologisch aktuell und erweiterbar. Google & Co. sollen sich genauso wohlfühlen wie die Besucher und deren Browser.

Multimedia

Zum Einsatz kam das herstellerungebundene „Open-Source“ Content Management System TYPO3. Nach der Programmierung des Layout Templates konnten bereits zeitgleich die einzelnen Redakteure für ihren Bereich den jeweiligen Seitenbaum erstellen und mit der Einpflege der Inhalte via Browser beginnen.

Suchmaschinen-Optimierung / Search Engine Optimization (SEO) Eine Website will und soll gefunden werden. Bereits bei der Programmierung und Inhaltserstellung sind zahlreiche Faktoren zu berücksichtigen, um eine optimale Positionierung in den Ergebnislisten der Suchmaschinen zu erreichen.

1 2 3

Redakteure

Technische Dokumentation

Praxisbericht: Online-Ersatzteilkatalog für die Sultex AG Technische Dokumentation

Dokumentation mit XML und DITA Translation

db

TYPO3 Server

DOGREL Website mit TYPO3

Online Editor

Einfaches, intuitives Arbeiten Mit Hilfe des Word ähnlichen Online Editors in TYPO3 können Texte formatiert und Bilder, Tabellen oder Links eingefügt werden, auch mittels „Copy and Paste“ aus anderen Programmen.

www.dogrel.com

Wir haben unsere Website nach den bekannten Richtlinien erstellt. Häufige Suchbegriffe werden über ein entsprechendes Statistik Tool laufend ausgewertet, um so das Ranking der Website zu sichern bzw. zu optimieren.

Terminologie – die Basis jeder professionellen Übersetzung

Editorial Internationale Zulassungen – Anforderungen an die Betriebsanleitungen Die Schweizer Industrie ist traditionell exportorientiert. Kenntnisse über die Anforderungen und Regeln für die technische Dokumentation in den Haupt-Exportmärkten Europa, USA, Asien spielen daher eine immer wichtigere Rolle.

Kaum ein technisches Produkt kommt ohne verständliche Betriebsanleitung aus. Autodidaktische Bedieneroberflächen sind Zukunftsmusik, nicht zuletzt auch wegen der ständig wachsenden Funktionalität der Maschinen und Anlagen. Die Lokalisierung in eine Vielzahl von Sprachen ist seit der Einführung der Maschinenrichtlinie allgemein bekannt und für die Durchdringung internationaler Märkte unumgänglich.

Wie sieht es aber mit den länderspezifischen, rechtlichen Rahmenbedingungen aus? Welche Normen, Rechtsgrundsätze und Vorschriften gelten in diesen Ländern und wie können diese in einer Betriebsanleitung umgesetzt werden? Wussten Sie, dass die CE-Kennzeichnung in den USA nicht akzeptiert wird und dass NFPA 70 und 79 sowie die OSHA Standards sogenanntes „Approved Equipment“ voraussetzen, was wiederum Einfluss auf die Technische Dokumentation hat?

In der chinesischen „CCC-Zertifizierung“ gewinnen Themen wie Arbeitsschutz, Maschinensicherheit und EMV stetig an Bedeutung. So gibt es bereits zertifizierungspflichtige Produkte, die in einem bestimmten Katalog nach Warenzolltarifnummern aufgelistet sind. Etliche Normen wie z. B. IEC 60204-1 wurden bereits in nationale Normung übernommen. Ähnliche Bestrebungen finden wir auch in Russland und dem asiatischen Raum.

Absolute Rechtssicherheit gibt es sowieso nicht, doch der rasch evolvierende Markt verlangt vor allem eines: aktuelles Wissen. Wir von DOGREL versprechen keine Wunder, doch wir bauen für diese Thematik ein stetig wachsendes heterogenes Fachwissen auf. Rüsten Sie sich für den internationalen Markt.

Peter Rudnicki

Arno Gander

Übersetzung / Lokalisierung der DOGREL Website – Translation Workflow

db

en XML

Translation Memory

db

fr db

TYPO3 Server

Terminologie „Human Translator“

Standardmässig bietet TYPO3 die Möglichkeit, die Übersetzung direkt im Backend (Adminbereich) Seite für Seite durchzuführen. Der Übersetzer muss sich dann allerdings mit TYPO3 auskennen. Um die Schnittstelle für unsere Übersetzungsdatenbanken zu nutzen, wurde der gesamte TYPO3 Seitenbaum als XML Datei exportiert, ins Translation Memory System eingelesen und der Übersetzer konnte mit seinem gewohnten Arbeitswerkzeug die Übersetzung in kürzester Zeit durchführen.

Die übersetzten XML Dateien wurden in TYPO3 wieder eingelesen und sämtliche Seiten in Englisch und Französisch konnten sofort publiziert werden.

Der besondere Vorteil bei dieser Methode ist, dass sämtliche Formatierungen, Links etc. erhalten bleiben. Alle Vorteile eines Translation Memory Systems können genutzt werden (Vorübersetzung, Terminologie, Wortzählungen etc.)

Deutsch | English | Français

Wenn TYPO3 auch die Technologie hinter Ihrer Website sein soll – kontaktieren Sie uns, wir beraten Sie gerne.

Fazit: • Die Pflege einer TYPO3 Website ist über einen Browser zeit- und ortsunabhängig möglich. Es werden keine externen Spezialisten benötigt.

• keine Lizenzkosten für TYPO3 (Open-Source) • Suchmaschinenoptimierung: Geeignete Massnahmen erhöhen das Ranking.

• Zeit- und Kostenersparnis bei der Website Lokalisierung durch Verwendung von Translation Memory Systemen (TMS) Gerhard Klocker Leiter Multimedia

Online-Ersatzteilkatalog für die Sultex AG Praxisbericht Technische Dokumentation: Für den traditionsreichen Webmaschinen-Hersteller Sultex AG wurden wir 2007 mit der Erstellung eines Online-Ersatzteilkatalogs beauftragt.

Ausgangslage Sultex hatte schon seit Jahren einen Online-Ersatzteilkatalog, der das gesamte Produktsortiment abdeckte, erfolgreich im Einsatz. Hierbei handelte es sich jedoch um eine Eigenentwicklung, deren Aufwand für Wartung, Updates und Systemanpassungen nicht mehr handelbar war. Ausserdem musste der Katalog vor der Bedienung lokal auf jedem Rechner installiert werden, was nicht jedem Benutzer zugemutet werden konnte.

Nach einer längeren Evaluierungsphase entschied sich die Sultex AG für eine Lösung mit CATALOGCreator. Die Erstellung des Katalogs sollte jedoch nicht intern durchgeführt werden, sondern über einen externen Dienstleister, der bereits mehrere Projekte erfolgreich durchgeführt hatte und durch die Vertriebspartnerschaft mit

CATALOGCreator beste Kontakte zum Systemhersteller pflegt – die DOGREL AG. Dadurch fielen für Sultex keine SoftwareKosten an und es war auch kein interner Know-how Aufbau nötig.

Umfang des Projektes: 4‘800 Grafiken, 60‘000 Artikel, 6 Sprachen, 9 Einzelkataloge, 2 Updates pro Jahr.

Zeichnungen Den grössten Zeitaufwand benötigte die Verarbeitung der Ersatzteilzeichnungen, die alle nur im Pixelformat (TIF) vorhanden waren. Über allen Positionsnummern mussten sogenannte „Hotspots“ (interaktive Bereiche im Bild, die verknüpft werden können) gesetzt werden. Mit der CATALOGCreator Zusatzsoftware „HotspotEditor“ konnte dieser Vorgang zu 90 % automatisiert werden. Probleme gab es teilweise

voll funktionsfähiges HTML-Warenkorbsystem exportiert. Hierfür wurde eine Vorlage (Template) erstellt, die das Aussehen des Katalogs genau festlegte und das Sultex CI berücksichtigte.

Der Online-Ersatzteilkatalog wird nun einerseits in die Sultex Website integriert und andererseits auf DVD ausgeliefert.

bei alten Zeichnungen, die noch von Hand erstellt wurden. Die Positionsnummern, die noch mit Schriftschablone erstellt wurden, konnten oft nicht richtig erkannt werden – eine manuelle Nachbearbeitung war nötig.

Artikeldaten Sultex verfügte bereits über sehr gut strukturierte Ersatzteil-Artikeldaten. Diese wurden ebenfalls von einem externen Dienstleister verwaltet und im CSV-Format an uns geliefert. Nach einigen Tests wa-

ren noch geringe Anpassungen nötig, damit ein reibungsloser Import möglich war. Über die CATALOGCreator Zusatzsoftware „DataKonverter“ konnten die Artikeldaten dann in ein importfähiges XML-Format umgewandelt werden.

Ersatzteilkatalog im Web und auf DVD Nach erfolgreichem Abschluss der Vorarbeiten wurden nun die Artikeldaten zusammen mit den Artikeldaten vollautomatisiert in CATALOGCreator importiert und in ein

Fazit Ein weiteres Grossprojekt wurde erfolgreich von DOGREL realisiert. Der Systemhaus-Vorteil kam auch dieses mal wieder voll zum Tragen – Know-how aus dem Doku-Bereich wurde erfolgreich mit Web-Know-how kombiniert.

Durch die Auslagerung der Ersatzteilkatalog-Erstellung zu DOGREL ergeben sich für Sultex grosse Vorteile: • Keine Softwarekosten • Kein interner Know-how Aufbau nötig • Volle Kostenkontrolle • Modernes System, das alle nötigen Funktionen beinhaltet • Zuverlässiger Partner, seit über 25 Jahren am Markt Günther Klammer Leiter Technische Dokumentation

Dokumentation mit XML und DITA Technische Dokumentation: Grundsätzlich müssen Produktinformationen in der Landessprache des Zielmarkts vorliegen.

Die damit steigende Volumina an Dokumenten, hervorgerufen durch umfangreichere Dokumentationen und steigende Übersetzungen, erfordern die Strukturierung der Dokumente.

Inhalte formal strukturieren, das bedeutet Gliederung und Logik eines Dokuments so zu erfassen, dass diese nicht nur für den menschlichen Leser, sondern auch für einen Computer sinnvoll greifbar sind.

XML XML – eXtensible Markup Language – ist eine Auszeichnungssprache, welche Regeln liefert, die beim Definieren von Dokumenttypen angewendet werden. Ein Grundgedanke hinter XML ist es, Daten und Layoutinformationen zu trennen. XML erleichtert es einem Computer, Daten zu lesen oder zu generieren und sorgt dafür, dass eine bestimmte Datenstruktur eindeutig bleibt.

XML ist erweiterbar, plattformunabhängig und unterstützt Internationalisierung, Lokalisierung und Unicode.

DITA Bei der Darwin Information Typing Architecture (DITA) handelt es sich um eine standardisierte, jedoch erweiterbare XMLArchitektur zur Erstellung von single-sourceorientierten, technischen Beschreibungen.

DITA wurde von IBM entwickelt und steht heute als Open Source Architektur zur Verfügung. Grundlage der Architektur ist eine Strukturierungstechnik, die sich in der Online-Dokumentation bewährt hat.

Sehr zentral für DITA ist die grundlegende Trennung von Erfassung und Publikation.

Nur wenn Inhalte medien- und kontextual erfasst werden, lassen sie sich einfach für verschiedene Medien ausgeben und wiederverwenden. Die mit DITA erfassten Inhalte liegen immer als Topics vor. Topics sind in sich geschlossene Informationseinheiten, welche grundsätzlich gleichberechtigt sind. Neben dem generischen Topic liefert DITA die Grundtypen Concept, Reference und Task.

Für die Dokumentenbildung bietet DITA eine XML-Struktur an, die im Wurzelelement map oder bookmap zusammengefasst wird. Topics werden durch blosse Referenzierung in eine gewünschte sequentielle An- und hierarchische Einordnung gebracht. Die variantenreiche Schachtelung von Topics unterschiedlicher Art ist eine Herausforderung der Konsistenzsicherung

in der Technischen Redaktion. Bei der Dokumentation mit DITA bleiben Inhalte separat und werden nicht fester Dokumentbestandteil. Mit XML-Mitteln (XSL-Stylesheets) lassen sich neben der Generierung und Gestaltung bestehender Inhalte auch neue Inhalte (Inhalts-, Stichwortverzeichnisse, Kurzbeschreibungen etc.) erstellen. Die in DITA-Strukturen steckende Intelligenz bedarf Softwareunterstützung, in Form eines geeigneten CMS, um Vollständigkeit , Versionierung etc. zu prüfen und zu fixieren.

Fazit DITA ist eine XML-Architektur, in die langjährige Erfahrungen der Dokumentation für Computer und Computersoftware eingegangen ist. Umfang und Reichhaltigkeit der DITA-XML-Struktur erfüllt die Anforderungen vieler Anwender, trifft aber im Ausnahmefall nur genau die Anforderungen eines bestimmten Projekts.

David Rehn Technischer Redakteur

Terminologie – die Basis jeder professionellen Übersetzung Translation: Wieviel unnötige Kosten sind wohl schon entstanden, weil in einer Dokumentation anstelle von „Schraubenverbindung“ „Schraubverbindung“ geschrieben wurde? Die Verwendung falscher Terminologie kann zu Wettbewerbsnachteilen, Fehlinvestitionen und anderen finanziellen Verlusten führen.

Was ist eigentlich Terminologie?

Als Terminologie bezeichnet man die Gesamtheit aller Begriffe (Begriff = Bedeutungsinhalt eines Wortes) und Benennungen (Termini = Bezeichnungen) einer Fachsprache, beziehungsweise die Fachsprache selbst. (nach DIN 2342)

Ziel der Terminologiearbeit Eine eindeutige, korrekte und somit effiziente Kommunikation zwischen Abteilungen eines Unternehmens, seinen Kooperationspartnern, Zulieferern und nicht zuletzt seinen Kunden ist nur durch die Verwendung der korrekten Fachsprache möglich.

Dies gilt für Kommunikation im Inland, aber natürlich gleichermassen auch für die internationale Kommunikation auf ausländischen Absatzmärkten.

Diese Fachsprache zu erarbeiten, zu sichern und für die Verwendung zugänglich zu machen, ist das Ziel der Terminologiearbeit.

Dazu ist viel Erfahrung notwendig, ebenso wie der Einsatz geeigneter Software-Tools für die Erstellung, Pflege und Distribution der Terminologie.

Vorteile?

Durch das eindeutige Zuordnen einer Benennung zu einem Begriff wird die firmeninterne Kommunikation vereinfacht. Inhaltliche Unklarheiten werden durch Definitionen zu den jeweiligen Benennungen ausgeräumt und somit wird der Verwendung falscher Terminologie vorgebeugt. Kommunikationsverzerrungen, die aus terminologischen

Mehrdeutigkeiten entstehen könnten, werden von vornherein vermieden. Ausserdem wird eine konsistente Unternehmenssprache (Corporate Language) aufgebaut – die Kommunikation im Unternehmen wird optimiert.

Software-Tools Für die Erfassung der bestehenden Terminologie eines Unternehmens sind extra spezielle Programme entwickelt worden, mit denen aus bereits vorhandenen Texten ein- oder zweisprachig Termini extrahiert werden können. Diese werden geprüft, mit wichtigen Informationen wie z. B. Definition oder Kontext versehen und schliesslich in ein Terminologieverwaltungssystem importiert.

Translation Memory- sowie Terminologieverwaltungssysteme sind Software-Tools, die speziell für die Verwaltung sprachlicher Datenbestände und deren Nutzung innerhalb der Technischen Redaktion, bei der Übersetzung und bei der Terminologiearbeit konzipiert wurden.

Beispiele: • SDL TRADOS – Multiterm • STAR Transit – TermStar • Across – CrossTerm Zur Kontrolle der konsistenten Verwendung der vorgegebenen Terminologie stehen unterschiedlichste Software-Produkte zur Verfügung: • TermControl (www.cognitas.de) • QA-Checker (SDL Trados-Plug-in)

Fazit Durch sorgfältige Terminologiearbeit und den Einsatz von Translation Memoryund Terminologieverwaltungssystemen ist es möglich, eine konsistente Verwendung der korrekten Terminologie zu gewährleisten. Dies verbessert die Qualität der Übersetzungen, reduziert den Korrekturaufwand und spart somit eine Menge Geld.

Wir bieten Ihnen • langjährige Erfahrung und terminologisch geschulte Fachkräfte • Beratung und Unterstützung bei der Planung und Durchführung von Terminologieprojekten • Bereinigung von Terminologiebeständen • Aufbau und Pflege von TerminologieDatenbanken sowie Translation Memories • Einbindung von Terminologie-Datenbanken in Redaktions- und Übersetzungsumgebungen • bewährte Software-Tools Daniela Badel Translation Memory Systeme / Terminologie

Im nächsten Infotrend Expressübersetzungen – für Texte, die nicht warten können Die neue Maschinenrichtlinie 2006/42/EG Web-Based-Training – aktuell und global Praxisbericht: Automatisierte Kataloge für Print und Web erstellen Änderungen vorbehalten

Bahnhofstrasse 7 · CH 9443 W idnau · Phone +41 (0)71 727 98 98 · Fax +41 (0)71 727 98 99 · marketing@dogrel.com · www.dogrel.com