Arkitekturen Darwin Information Typing Architecture (DITA bogstaveligt talt Architecture of Darwinian typed information ) er en modulær standard og struktureret skrivning dedikeret til udvikling, design og udgivelse af teknisk information. DITA er baseret på XML- teknologier .
Navnet forklares som følger:
Udvidelsen af DITA giver organisationer mulighed for at definere specifikke informationsstrukturer, mens de fortsætter med at bruge et standard og åbent format (dvs. både dokumenteret, ikke-proprietært og gratis). Evnen til at definere specifikke dokumentarkitekturer for en virksomhed eller industri (se underudvalg i OASIS-konsortiet) giver DITA mulighed for at genbruge indhold og reducere overflødige oplysninger ( i gennemsnit 50% ).
DITA-arkitekturen, dens DTD og dens XML-skema blev udviklet af IBM .
Den 1 st juni 2005 DITA bliver en standard for OASIS - konsortiet ansvarlige XML-standarder.
DITA version 1.2 blev vedtaget den 1. december 2010.
DITA version 1.3 blev vedtaget den 25. oktober 2016.
Blandt de virksomheder, der støtter DITAs tekniske udvalg, er:
OASIS-underudvalg kan arbejde på udviklingen af en specialisering for en bestemt industri: maskineindustri, farmaceutisk, halvledere eller endda se på en bestemt anvendelse eller aspekt (oversættelse, uddannelse, hjælp, tekniske standarder).
DITA bruger indholdet i form af selvstændige sektioner, der kan bruges i flere formater (web-, printbare, mobile og indlejrede applikationer) på tværs af en række produkter i flere typer dokumenter (vejledninger, specifikationer, træning, arkprodukter ...)
Hver sektion skal være lang nok til at imødekomme målgruppernes behov, mens den er kort nok til at være let at læse og genbruge. Det skal indeholde nok kontekst til at forstås i forskellige dokumenter.
DITA-standarden inkluderer et begrænset antal “typiske” sektioner, der opfylder specifikke mål:
Andre typer af emner er blevet tilføjet til disse tre grundlæggende typer, herunder: fejlafhjælpning ( fejlfinding ) og ordliste post ( glossentry ), maskiner opgave . Oplysninger om gendannelse af fejl kan også medtages i procedurerne.
DITA opfordrer derfor til at skrive indhold i form af små, uafhængige (ikke-kontekstualiserede) og typede informationsoverskrifter i modsætning til lange bog- / arbejdsorienterede filer.
Overskrifterne kan genbruges så mange gange som nødvendigt på et kort ved hjælp af links ( emnehenvisninger ). Fragmenter af oplysninger, der er mindre end overskrifter (et udtryk, et mærke, en sikkerhedsadvarsel osv.) Kan også genbruges gennem en dokumentation ( indholdsreferencer ).
Det er også muligt at oprette variabler gennem indirekte referencer navngivne nøgler. Dette gør det muligt at løse værdier i henhold til konteksten. Faktisk leveres værdierne af kortene. Således kan det samme element have en anden værdi afhængigt af det kort, der bruger det.
Den betingede tekst godkender den betingede offentliggørelse, det vil sige filtrering af information i sektionerne i henhold til typiske attributter såsom: offentligheden (ekspert, uerfarlig ...), platformen (Linux, Windows ...), produktet , etc.
De metadata omfattende og kan tilpasses lette forsøgspersoner, deres kategorisering og overvågning af projekter (stater, meddelelse om ophavsret, produktserie, etc.)
DITA kan udvides og begrænses - så det er muligt at tilføje nye elementer gennem specialisering af grundlæggende elementer (dette er dets darwinistiske side). Gennem specialisering kan informationsarkitekter eller forfattere derfor modulere og kombinere nye modultyper og standardelementer i henhold til behovene hos virksomheder og industrier. Den omvendte mekanisme for specialisering kaldes generalisering.
DITA inkluderer nogle officielle specialiseringer, herunder DITA Learning and Training til oprettelse af uddannelsesindhold. Sektionerne og kortene er især beriget med metadata relateret til oprettelsen af kursusmoduler, programmer og læseplaner. For eksempel: krævet viden, modulets varighed osv. Nogle sektioner er tilgængelige til videnkontrol og introduktion til modulerne.
Standarden indeholder også disse typer overskrifter:
Oprettelse af indhold med DITA handler om at skrive emner og kort. Et kort indeholder links til overskrifterne og definerer omridset af dokumentet, på dette er det på en måde en afspejling af den fremtidige indholdsfortegnelse. Den definerer sekventeringen og strukturen af sektionerne, hvilket vil blive afspejlet i leverancerne.
Kortet giver redaktøren mulighed for at specificere, hvilke emner der er relateret til, og fjerne eller tilføje links og sekvenser af trin.
DITA-filer (kort og emner) er XML-filer. Hvert billede, videofil og enhver anden fil, der vises i output, er integreret med et link. Enhver XML-editor (eller endda tekst) kan bruges til at skrive DITA-indhold. Det er dog lettere at bruge en editor, der ikke kun forstår og validerer XML, men også DITA-standardoverensstemmelse.
DITA yder support til oversættelse med lokaliseringsattributten, f.eks. @ Translate = "nej". Dette indikerer, om et element ikke skal oversættes. Andre elementer inkluderer skriveretningen (højre mod venstre eller venstre mod højre), sprog, indeksfiltrering og udtryk, der skal medtages i publikationen.
DITA administrerer end-to-end-produktion af dokumentarisk indhold. Ud over at specificere hvilke elementer, attributter er en del af DITA-sproget, inkluderer DITA-specifikationerne regler for udskrivning af indhold, generering af HTML, online hjælp og eksport til andre formater. For eksempel angiver specifikationen, at hvis conref-attributten for element A indeholder et mål, der fører til element B, vil indholdet af element B blive vist inden for element A. DITA-standarden, eller DITA-processor, understøtter genbrugsattributter og løser linket ved offentliggør tid. Mekanismer findes også til at detaljer og offentliggøre betingede tekster, referencer til multimedieobjekter, links fra overskrifter til overskrifter ...
Da DITA blev en OASIS-standard, donerede IBM også sin DITA-processor til samfundet: DITA Open Toolkit . DITA OT er ikke en del af OASIS-standarden, men denne open source-værktøjssæt tillader, at DITA-indhold offentliggøres i forskellige udskrifts- og webformater, der leveres ved hjælp af Ant- sproget .
Da DITA er et åbent format, tillader mange udvidelser og plugins DITA OT at tilpasse eksportformater, for eksempel for at udgive dem til EPUB , OOXML. Gyldige filtyper, der understøttes, er:
De fleste DITA-brugere starter deres projekter med DITA Open Toolkit, og publiceringsværktøjer er integreret i dokumentationsprocessen i mange virksomheder.
DITA Open Toolkit er et meget aktivt open source-projekt understøttet af flere store virksomheder, der direkte bidrager til dets udvikling ( IBM , Adobe Systems , OASIS osv.). Download tilgængelig på GitHub .
DITA er kompatibel med følgende standarder: