Inhoudsbeheer met DITA en XML

Inhoudsbeheer met DITA en XML

Deskundig beheer van DITA en XML-inhoud voor meertalige publicatie. Gestructureerd schrijven, topic-gebaseerd schrijven en oplossingen voor hergebruik van inhoud.

Wat is de DITA-standaard?

DITA (Darwin Information Typing Architecture) is een op XML gebaseerde architectuur voor het schrijven, produceren en distribueren van technische informatie. De architectuur en de bijbehorende DTD en W3C-Schema zijn ontwikkeld door IBM.

De volledige naam van de architectuur heeft deze samengestelde verklaring:
Darwin: het maakt gebruik van de principes van specialisatie en overerving
Information Typing: het maakt optimaal gebruik van de semantiek van onderwerpen (concept, taak, referentie) en van inhoud (berichten, getypeerde zinsdelen, semantische tabellen)
Architecture: het biedt verticale uitbreidingsmogelijkheden (nieuwe toepassingen) en horizontale uitbreiding (specialisatie naar nieuwe types) voor informatie

In tegenstelling tot boekgeoriënteerde benaderingen die gebaseerd zijn op hoofdstukken en pagina's, maakt DITA gebruik van onderwerpen – kleine informatieblokken die eenvoudig in verschillende contexten en leveringsvormen kunnen worden hergebruikt. DITA heeft ook ingebouwde uitbreidingsmogelijkheden, wat betekent dat u documenttypedefinities (DTD's) kunt aanpassen zonder de compatibiliteit met bestaande toepassingen en processen te verbreken. Om deze redenen en meer helpt DITA u de drempels voor XML-toepassing te overwinnen, hergebruik van inhoud te maximaliseren en informatieredundantie te verminderen.

DITA specificeert een aantal onderwerptypen, zoals Task, Concept en Reference. Binnen DITA is een Task-onderwerp bedoeld voor een procedure waarin wordt beschreven hoe u een taak kunt uitvoeren; het geeft een reeks stappen weer die gebruikers volgen om een bepaald resultaat te bereiken; en identificeert wie wat, wanneer, waar en hoe doet. Een Reference-onderwerp is bedoeld voor onderwerpen die opdrachtensyntaxis, programmeringsinstructies en ander referentiemateriaal beschrijven; meestal gedetailleerd, feitelijk materiaal.

Wat is de DocBook-standaard?

DocBook is een opmaaktaal voor technische documentatie, oorspronkelijk bedoeld voor het schrijven van technische documenten met betrekking tot computerhardware en -software, maar kan ook voor elke ander soort documentatie worden gebruikt.

Een van de belangrijkste voordelen van DocBook is dat gebruikers documentinhoud in een presentatieneutrale vorm kunnen maken die de logische structuur van de inhoud vastlegt; die inhoud kan vervolgens in diverse formaten worden gepubliceerd, waaronder HTML, PDF, man pages en HTML Help, zonder dat gebruikers wijzigingen in de bron hoeven aan te brengen.

Wat is DocBook?

DocBook biedt een systeem voor het schrijven van gestructureerde documenten met behulp van SGML of XML. Het is bijzonder geschikt voor boeken en artikelen over computerhardware en -software, hoewel het zeker niet tot deze onderwerpen beperkt is.
Kortom, DocBook is een gemakkelijk te begrijpen en wijd verbreid DTD. Tientallen organisaties gebruiken DocBook voor miljoenen pagina's documentatie in verschillende print- en onlineformaten, wereldwijd.

Waarom DocBook nodig is?

Het DocBook-formaat is door het OASIS-consortium specifiek ontworpen voor technische documentatie. Het biedt een uitgebreide set tags om de inhoud van uw document te beschrijven.
Hier volgen enkele belangrijke punten die helpen DocBook te begrijpen:

• DocBook is een opmaaktaal
  Het lijkt in dit opzicht sterk op HTML. De tags geven uw document structuur en verschijnen gemengd met de informatietekst.
  Dit bijzondere kenmerk is revolutionair voor documentatievertaling, omdat de DTP-fase (het document fraai opmaken) eenmalig indirect gebeurt door het originele tekst te taggen. Vertalers hoeven alleen "tussen de tags" te vertalen en met één toetsaanslag wordt de vertaalde uitvoer gegenereerd.
• Het is gemaakt voor technische documentatie
  DocBook is perfect geschikt voor documentatie van motoronderdelen. Het is echter sterk gericht op computerprogrammatuur-documentatie.
• Technisch is DocBook een SGML- of XML-DTD
  Dit betekent dat men gebruik kan maken van vele SGML- en XML-bewuste tools. Hoewel DocBook als XML-implementatie relatief nieuw is, heeft het een lange geschiedenis als SGML-implementatie.
• DocBook is geen presentatietaal
  DocBook let er zorgvuldig op niet vast te leggen hoe de uiteindelijke documentatie eruitziet. Dit stelt de schrijver in staat zich te concentreren op de organisatie en betekenis van het document. Alle presentatieaspecten worden uitbesteed aan stylesheets.
  Dit waarborgt dat al uw documenten een consistent uiterlijk hebben, ongeacht wie de technisch schrijver is.
• DocBook is aanpasbaar
  Het is vrij eenvoudig om de DTD aan te passen aan uw behoeften dankzij de modulaire opbouw. U moet er echter voorzichtig mee omgaan conform SGML/XML-conventies, omdat dit incompatibiliteiten kan introduceren.
  Wanneer DocBook wordt gebruikt in combinatie met Norman Walsh's modulaire stylesheets, is het ook mogelijk om aan te passen hoe een DocBook-bestand kan worden afgedrukt of online gezet.
• DocBook is uitgebreid
  Het grote aantal tags in DocBook zorgt ervoor dat het een breed scala aan situaties en verwerkingsverwachtingen kan ondersteunen.
  Dit maakt het enigszins moeilijk om te leren, maar u kunt documentatie schrijven met slechts een beperkte set tags en raadpleeg de referentiedocumentatie wanneer nodig.

Wat is XML-contentbeheer?

Een XML-contentbeheersysteem kan uw content omzetten voor verschillende media en apparaten, waaronder internet, cd-rom, offline presentaties, printcatalogi, PDA-apparaten en draadloze telefoons. Door content eenmaal aan te maken en opnieuw in te zetten voor verschillende media, garandeert u consistentie en relevantie van uw boodschap over alle communicatiekanalen. Op deze manier stelt XML-contentbeheer bedrijven in staat om effectiever aan e-business te doen door hergebruik van content, scheiding van content en opmaak, platformonafhankelijke uitwisseling, probleemloze integratie en multi-channel publicatie.

Wat is Web Content Management?

Web content management stelt zakelijke gebruikers en niet-technisch geschoold personeel in staat om een website te onderhouden en verder te ontwikkelen door de structuur en inhoud ervan los te koppelen van het ontwerp. Dit vervangt traditionele methoden die kennis van HTML en ontwerptechnieken vereisen, en zorgt door systeembrede regels ervoor dat aspecten zoals navigatie en paginalay-outs consistent worden afgehandeld. Hiermee kunt u de website beheren zonder u zorgen te maken over het beschadigen van de bedrijfsstijl, hoe u een nieuw item aan het menu toevoegt, of welke extra kosten uw wijzigingen kunnen veroorzaken. In plaats daarvan kunt u zich concentreren op het gebruiken van de website voor effectievere communicatie met klanten, potentiële klanten en Partners.