Darwin Information Typing Architecture

Ponowne wykorzystanie treści

Podstawą do ponownego wykorzystywania utworzonych treści są topiki, które mogą być używane wielokrotnie w obszarze wielu publikacji. Fragmenty treści zawarte w topikach mogą być ponownie używane dzięki użyciu odniesień (ang. content references) z wykorzystaniem transkluzji.

Typowanie informacji

Najnowsza wersja DITA (DITA 1.3) obejmuje następujące rodzaje topików: Task (pol. zadanie), Concept (pol. pojęcie), Reference (pol. odniesienie), Glossary Entry (pol. wpis do słownika) i Troubleshooting (pol. rozwiązywanie problemów). Każdy z tych pięciu typów jest bardziej wyspecjalizowanym rodzajem bardziej ogólnego topiku, który zawiera elementy tytułu, prologu do metadanych i treści. Element treści zawiera elementy akapitu, tabeli i listy, podobnie jak w HTML.

• Task: typ przeznaczony dla procedury opisującej sposób wykonania zadania. Zawiera listę kroków (ang. steps), którą powinien śledzić użytkownik w celu osiągnięcia zamierzonego efektu. Kroki są zawarte w elemencie taskbody, który jest specjalizacją ogólnego elementu body. Element steps jest specjalizacją elementu listy uporządkowanej.
• Concept: typ przeznaczony do tworzenia treści obiektywnych, z definicjami, zasadami i wytycznymi.
• Reference: typ przeznaczony do opisu składni poleceń, instrukcji programowania, innych materiałów odniesienia. Zazwyczaj zawiera szczegółowy materiał merytoryczny.
• Glossary Entry: typ przeznaczony do zdefiniowania pojedynczego znaczenia danego pojęcia. Ten typ może identyfikować pojęcie, podawać jego definicję oraz zawierać podstawowe informacje o terminologii, akronimy i ich rozwinięcia związane z głównym pojęciem.
• Troubleshooting: typ opisujący stan, którego poprawy może oczekiwać użytkownik, oraz sugerowane środki zaradcze wraz z opisem przyczyn zajścia takiego stanu.

Mapy

Mapa DITA to kontener na topiki wykorzystywane do przekształcenia zbioru treści w publikację. Określa kolejność i strukturę topików. Mapa może zawierać tabele relacji (ang. relationship tables, reltables), które definiują hiperłącza między topikami. Mapy mogą być zagnieżdżane, mogą również odwoływać się do innych map, topików i zawierać różne typy treści oraz metadane.

Metadane

DITA zawiera obszerne elementy i atrybuty metadanych na poziomie tematu i elementów. Tekst warunkowy umożliwia filtrowanie lub stylizowanie treści w zależności atrybutów odbiorców, platformy, produktu i innych właściwości. Profil przetwarzania warunkowego (.ditaval) służy do identyfikowania wartości, które mają być używane do przetwarzania warunkowego.

Specjalizacja

DITA umożliwia dodawanie nowych elementów i atrybutów poprzez specjalizację podstawowych elementów i atrybutów DITA. Dzięki specjalizacji DITA może dostosowywać nowe typy tematów, typy elementów i atrybuty zgodnie z potrzebami określonych branż lub firm. Specjalizacje DITA dla określonych branż, takich jak przemysł półprzewodników, są standaryzowane przez komitety techniczne lub podkomitety OASIS. Część organizacji korzystających z DITA tworzy własne specjalizacje.

Możliwość rozszerzania DITA pozwala organizacjom na specjalizację DITA poprzez zdefiniowanie określonych struktur informacji przy zachowaniu możliwości używania standardowych narzędzi do pracy z nimi. Możliwość zdefiniowania architektury informacji charakterystycznej dla danej firmy umożliwia używanie DITA do wzbogacania treści o istotne dla firmy metadane oraz do egzekwowania określonych wewnętrznie zasad dotyczących struktury dokumentów.

Topic orientation

Treść DITA jest tworzona jako topiki, z których każdy jest osobnym plikiem XML. Na ogół każdy topik opisuje określony temat w jednym celu, na przykład topik typu Concept zawierający omówienie lub topik typu Procedure wyjaśniający sposób wykonania zadania. Treść powinna mieć strukturę przypominającą strukturę pliku, w którym jest zawarta.

Lokalizacja

DITA zapewnia obsługę tłumaczenia za pośrednictwem grupy atrybutów lokalizacji. Atrybuty elementu można ustawić tak, aby wskazać, czy zawartość elementu powinna zostać przetłumaczona. Istnieje możliwość określenia języka danego elementu, kierunku pisania, filtrowanie indeksu i niektóre terminy wstrzykiwane podczas publikowania do docelowego formatu. Projekt DITA można przekonwertować do pliku XLIFF i z powrotem do oryginalnych map i topików za pomocą narzędzia DITA-XLIFF Roundtrip Tool dla DITA-OT i narzędzi do tłumaczenia wspomaganego komputerowo, np. Fluenta DITA Translation Manager implementującego workflow tłumaczenia sugerowany w artykule „Using XLIFF to Translate DITA Projects” opublikowanym przez DITA Adoption TC w OASIS.

Przykładowy plik Ditamap (spis treści)

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN" "map.dtd">
<map id="map" xml:lang="en">
  <topicref format="dita" href="sample.dita" navtitle="Sample" type="topic"/>
</map>

Witaj świecie (topik DTD)

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
<topic xml:lang="en" id="sample">
  <title>Sample</title>
  <body>
  <p>Hello World!</p>
  </body>
</topic>

Przykładowy plik.ditaval (do warunkowania tekstu)

<?xml version="1.0" encoding="utf-8"?>
<val>
  <prop att="audience" val="novice" action="include" />
  <prop att="audience" val="expert" action="exclude" />
</val>

Przykład tekstu warunkowego:

<p>
  This is information useful for all audiences.
</p>
<p audience="novice">
  This is information useful for a novice audience.
</p>
<p audience="expert">
  This is information useful for an expert audience.
</p>