kr2akn

법제처 XML에서 Akoma Ntoso까지

akomantoso.kr 위키로 옮길 문서의 단일 페이지 진입점이다. 상세 예시는 docs/wiki/에 페이지별로 나뉘어 있다. 위키 빌더는 각 페이지의 wiki-meta와 compare:* 마커를 읽어 Before/After를 2단 레이아웃으로 렌더링한다.

5분 요약

질문 짧은 답
법제처 XML은 무엇에 강한가? 한 문서를 정확히 전달하고 원문을 보존하는 데 강하다.
AKN은 무엇에 강한가? 문서 간 인용, 계층, 식별자, 버전/시간, 표 구조를 기계가 바로 해석하게 한다.
kr2akn은 무엇을 하나? 표시용 텍스트를 AKN 구조로 옮기고, 한국 특유 필드는 kr: 확장으로 보존한다.
가장 큰 변화는? 제2조(신의성실) 같은 문자열이 <article><num>제2조</num><heading>신의성실</heading>...로 바뀐다.
왜 중요한가? 인용이 안정적인 URI가 되고, 표가 데이터가 되고, emit → decode → emit 검증이 가능해진다.

한 조문으로 보는 Before / After

Before — 법제처 XML

<조문단위 조문키="0002001">
  <조문번호>2</조문번호>
  <조문제목>신의성실</조문제목>
  <조문내용>제2조(신의성실)</조문내용>
  <항>
    <항번호>①</항번호>
    <항내용>①권리의 행사와 의무의 이행은 신의에 좇아 성실히 하여야 한다.</항내용>
  </항>
  <항>
    <항번호>②</항번호>
    <항내용>②권리는 남용하지 못한다.</항내용>
  </항>
</조문단위>

After — AKN

<article eId="part_1__chp_1__art_2"
         kr:revisionType="일부개정"
         kr:changed="false"
         kr:effectiveDate="2026-03-17">
  <num>제2조</num>
  <heading>신의성실</heading>
  <paragraph eId="part_1__chp_1__art_2__para_1">
    <num>①</num>
    <content>
      <p eId="...__para_1__content__p_1">권리의 행사와 의무의 이행은 신의에 좇아 성실히 하여야 한다.</p>
    </content>
  </paragraph>
  <paragraph eId="part_1__chp_1__art_2__para_2">
    <num>②</num>
    <content>
      <p eId="...__para_2__content__p_1">권리는 남용하지 못한다.</p>
    </content>
  </paragraph>
</article>

위키 페이지

순서 페이지 내용
1 왜 AKN인가 왜 바꾸는가, 5분 요약, 설계 근거
2 스키마 비교 필드 대응, 트리, kr: 확장
3 민법 제2조 — 기본 조문 조문단위/항 → article/paragraph
4 부동산등기법 제84조의2 — 계층과 인용 빈 <항>, 호/목, ref
5 부칙 — amendment-scoped citation hcontainer, kr:refType
6 별표 — box-drawing 표 rowspan/colspan, table
7 판례 — 사건번호에서 FRBR까지 judgment, caseHeader, references
8 코퍼스와 한계 현재 범위, 알려진 한계
9 직접 확인하기 CLI, 테스트, 데이터 위치

스키마 한눈에 보기

관점 법제처 XML AKN
문서 식별 법령ID, 판례정보일련번호 FRBRWork/FRBRExpression/FRBRManifestation URI
조문 계층 <조문단위>, <항>, <호>, <목> <article>, <paragraph>, <point>, <indent>
인용 제9조제2항 같은 일반 텍스트 <ref href="#eId"> 또는 urn:kr:...
별표 표 <별표내용> 안의 box-drawing 문자 <table><tr><th rowspan colspan>
시간 공포일자, 시행일자, 선고일자 문자열 lifecycle + temporalData + timeInterval
검증 사실상 원문 그대로 OASIS AKN 3.0 XSD

이 문서의 위치

  • 공개 레포의 원본 Markdown: docs/xml-to-akn.md, docs/wiki/*.md
  • 위키 페이지 맵과 2단 레이아웃 규약: docs/wiki/README.md
  • 사이트 CSS는 위키 빌더 단계에서 입힌다. 이 문서는 의미 구조와 compare:left/compare:right 마커만 제공한다.

관련 문서