DITA(Darwin Information Typing Architecture)란 무엇인가? 아주 쉽게 기본 개념 알아보기

어떠한 문서를 작성할 때 아무런 규칙 없이 문서 작성을 한다면

다른 사람들과 문서를 공유했을 때, 그리고 서로 이 문서를 수정할 때, 그리고 나중에 이 문서를 업데이트할 때

다양한 문제가 발생할 수 있고, 문서의 구조가 엉망이 될 수 있습니다.

 

DITA는 문서를 “조각(Topic)” 단위로 만들어서 조립하는 방식의 문서 표준입니다.
쉽게 말하면, 레고 블록처럼 문서 조각을 만들어 놓고,
필요할 때 조합해서 하나의 문서를 만드는 시스템이라고 보시면 됩니다.

 

DITA가 무엇인지 관련 내용을 잘 모르시는 분들이 보셨을 때 이해가 가능하도록 정리했습니다.

---

DITA(Darwin Information Typing Architecture)란 무엇인가?

 

DITA는 OASIS(Open Architecture for Structured Information Standards)에서 제정한
구조화 문서(Structured Content) 표준입니다.

https://www.oasis-open.org/

OASIS Open Homepage-Aug2024

 

핵심 개념은 아래 두 가지입니다.

1. 정보를 Topic 단위로 분해하고 구조화
2. 이 Topic들을 재조합하여 여러 형태의 문서를 자동 생성

즉, DITA는 단순한 문서 포맷이 아니라
“컨텐츠를 체계적으로 관리하고 재사용하기 위한 정보 모델(Information Architecture)”입니다.

 

---

왜 이런 방식이 필요할까?

제품 설명서, 기술 문서, 소프트웨어 매뉴얼처럼 내용이 많고 반복되는 부분이 많을 때

• 같은 설명을 여러 문서에 반복해서 쓰거나
• 다른 팀이 문서를 섞어서 만들거나
• 버전이 계속 바뀌어서 매번 수정해야 하는 문제

이런 문제들이 계속 생기기 때문에 문서를 체계적으로 관리하려고 나온 표준이 바로 DITA입니다.

결국 DITA를 사용하는 이유는 복잡한 기술 문서를 체계적으로 관리하고, 재사용성과 유지보수 효율을 극대화하기 위해서입니다.

---

DITA의 핵심 개념 3가지

1) Topic (문서 조각)

DITA의 기본 단위.
하나의 Topic은 하나의 주제(Topic)만 다룹니다.

DITA에서 가장 중심이 되는 표준 Topic은 아래 3가지 타입입니다.

• 개념 설명(concept)
• 작업 절차(task)
• 사양·표(reference)

---

2) Map (문서를 조합하는 목차 역할)

여러 Topic을 순서대로 조합하여 완성된 문서를 만드는 상위 구조입니다.

예를 들면

• 제품 설명서
• 설치 매뉴얼
• 도움말 웹페이지
• 사용자 가이드

같은 Topic 조각으로 여러 문서를 만들 수 있는 구조입니다.

---

3) 재사용 (Reuse)

DITA가 강력한 이유는

• 설치 절차가 여러 제품에서 동일하다면
  → task topic 하나만 만들어두고 여러 문서가 공유
• 안전 주의 문구가 모든 제품 설명서에 필요하다면
  → concept topic을 재사용

한 번 작성한 내용은 어디서든 재활용 가능하다는 장점이 있습니다.

빅데이터가 중요해지고 딥러닝과 AI시대가 온 지금 이런 정보의 구조화, 데이터화는 정말 중요합니다.

---

DITA 구조를 한 줄로 말하면?

“문서를 잘게 나누고, 그 조각들을 조립해서 만드는 기술 문서 표준”

---

DITA를 쓰면 좋은 점

• 같은 내용을 여러 문서에서 재사용 가능
• 문서 변경 시, 하나만 수정해도 모든 문서에 반영
• 문서 구조가 표준화되어 팀 작업이 쉬워짐
• PDF / HTML / 웹 도움말 등 다양한 형태로 자동 출력
• 대규모 설명서 관리가 훨씬 효율적

---

예를 들어 쉽게 설명하면

기존 방식

하나의 제품 설명서를 Word·한글 같은 단일 문서로 작성
→ 내용이 겹치면 복붙 → 수정 생기면 여러 파일을 전부 다시 편집

DITA 방식

1. 구성품 설명 : 하나의 Topic
2. 설치 절차 : 하나의 Topic
3. 안전 안내 : 하나의 Topic
4. 사용 방법 : 하나의 Topic

그리고 마지막에 map 파일에서 이렇게 조립:

 

chapter 1. 제품 개요 chapter 2. 안전 지침 chapter 3. 설치 방법 chapter 4. 사용법 chapter 5. 사양

필요한 조각들만 불러와 ‘딱 맞는 설명서’를 만드는 구조.

---

기본 구조 형식

/manual_project
 ├─ maps/
 │    ├─ product_manual.ditamap
 │    ├─ toc_overview.ditamap
 │    ├─ toc_installation.ditamap
 │    └─ toc_spec.ditamap
 ├─ topics/
 │    ├─ 00_intro/
 │    │     ├─ concept_overview.dita
 │    │     └─ concept_safety.dita
 │    │
 │    ├─ 01_components/
 │    │     ├─ reference_parts_list.dita
 │    │     ├─ reference_dimensions.dita
 │    │     └─ concept_how_it_works.dita
 │    │
 │    ├─ 02_installation/
 │    │     ├─ task_installation.dita
 │    │     ├─ task_wiring.dita
 │    │     └─ task_initial_setup.dita
 │    │
 │    ├─ 03_operation/
 │    │     ├─ task_how_to_use.dita
 │    │     └─ concept_operation_principles.dita
 │    │
 │    ├─ 04_troubleshooting/
 │    │     └─ reference_errors.dita
 │    │
 │    └─ 05_specification/
 │          └─ reference_spec.dita
 │
 └─ reuse/
      ├─ safety_common.dita
      ├─ warranty_common.dita
      ├─ installation_environment.dita
      └─ ui_common_elements.dita

---

DITA는
기술 문서를 체계적으로 나누고, 재사용하고, 효율적으로 관리하기 위한 국제 표준 문서 구조입니다.
특히 제품 설명서, 소프트웨어 매뉴얼, 장비 설명서처럼 지속적으로 업데이트되고 반복되는 문서를 만드는 데 최적화되어 있습니다.

어떠한 기술 문서를 작성한다고 했을 때, 기본적인 구조를 DITA에 맞추고 이러한 문서 데이터가 쌓인다면

나중에 그 문서들이 데이터가 되고 다양한 부분에서 활용이 가능해집니다.