디지털 출판 WAI-ARIA 모듈 1.1

작품 또는 그 안의 섹션이나 발췌 부분의 주요 아이디어, 개념 및 결론에 대한 짧은 요약.

<section role="doc-abstract" aria-label="초록">
   <p>웹 콘텐츠의 접근성에는 위젯, 구조,
      및 동작에 대한 의미론적 정보가 필요합니다 …</p>
</section>

작품의 실현에 사람, 조직, 정부 및 기타 주체가 기여한 중요한 공헌을 인정하는 섹션 또는 진술.

<section role="doc-acknowledgments">
   <p>저는 …에 진심 어린 감사를 전하고 싶습니다 </p>
</section>

저자 또는 중요한 인물의 맺음말로, 일반적으로 콘텐츠가 어떻게 쓰이게 되었는지, 그 의의 또는 그 시간대 이후 발생한 관련 사건에 대한 통찰을 제공합니다.

<section role="doc-afterword">
   <h2>후기: 내가 이 책을 쓴 이유</h2>
   …
</section>

주요 콘텐츠 뒤에 위치하며 콘텐츠를 설명하지만 중심적이지는 않은 보충 정보 섹션.

<section role="doc-appendix">
   <h2>부록 A. 역사 연표</h2>
   …
</section>

사용자가 콘텐츠의 관련 위치로 돌아갈 수 있게 하는 링크(예: 각주에서 그 참조 위치로, 또는 용어집 정의에서 용어가 사용된 위치로).

<aside id="fn01" role="doc-footnote">
   <a role="doc-backlink" href="#fnref01">1.</a>
   이 연구와 유사 연구의 추가 결과는
   …에서 확인할 수 있습니다.
</aside>

[DPUB-ARIA 1.1에서 폐기됨] 참고 문헌의 외부 출처에 대한 단일 참조. biblioentry는 일반적으로 콘텐츠 안의 참조보다 더 자세한 정보 (예: 전체 제목, 저자, 출판사, 발행일 등)를 제공합니다.

작품에서 인용한 외부 참고 문헌 목록으로, 인쇄 또는 디지털 출처일 수 있습니다.

doc-bibliography 역할을 가진 요소는 참고 문헌 항목을 포함하는 하위 목록을 하나 이상 MUST 포함해야 합니다(항목이 예를 들어 알파벳순으로 세분화되어 있는 경우, 해당 요소는 둘 이상의 목록을 포함할 수 있습니다).

저자는 항목을 포함하는 목록에 doc-bibliography 역할을 직접 적용해서는 MUST NOT 됩니다.

<section role="doc-bibliography">
   <h2>선별 참고 문헌</h2>
   <ul>
      …
   </ul>
</section>

참고 문헌 항목에 대한 참조.

<p>
   <a role="doc-biblioref"
      href="#b8cab5dd-bc24-459c-9858-7afa9da69b64">Steinbeck</a>가
   그의 위대한 소설에서 말했듯이 …
</p>

작품 안의 주요 주제별 콘텐츠 섹션.

<section role="doc-chapter">
   <h2>1장. 어렴풋한 그림자.</h2>
   …
</section>

해당 판본에 특화된 짧은 제작 관련 설명 섹션(예: 사용된 서체 설명)으로, 종종 작품 끝에 위치합니다.

<section role="doc-colophon" aria-label="서체 정보">
   <p>이 출판물은 …을 사용해 조판되었습니다. </p>
</section>

작품을 요약하거나 서사를 마무리하는 결론 섹션 또는 진술.

<section role="doc-conclusion">
   <h2>요약</h2>
   <p>페미니즘 학문에서 중심 과제는 고정관념을 드러내고 해체하는 것입니다 … </p>
</section>

작품의 분위기나 어조를 설정하고 일반적으로 제목과 저자를 포함하는 이미지.

<img role="doc-cover" src="coverimage.jpg" alt="버지니아 울프의 자기만의 방"/>

사진과 같은 제3자 출처에서 통합된 콘텐츠의 출처에 대한 인정. 일반적으로 작성자, 저작권 및 재사용 제한 사항을 식별합니다.

<p role="doc-credit">
   <cite>“경제적 비용-효과 분석의 기초”</cite>에서 가져온 62쪽, 표 3.1,
   A. M. Garber 및 C. E. Phelps 저 …
</p>

크레딧 모음.

<section role="doc-credits">
   <h2>사진 크레딧</h2>
   …
</section>

작품 앞부분의 헌사로, 일반적으로 저자와 가까운 한 명 이상의 사람에게 바칩니다.

<p role="doc-dedication">이 일이 결코 가능하지 않았을 나의 가족에게.</p>

[DPUB-ARIA 1.1에서 폐기됨] 작품 또는 그 안의 섹션 끝에 나타나는 주석 모음 중 하나로, 참조된 텍스트 구절에 추가 맥락을 제공합니다.

작품 또는 그 안의 섹션 끝에 있는 주석 모음.

doc-endnotes 역할을 가진 요소는 미주를 포함하는 하위 목록을 하나 이상 MUST 포함해야 합니다(주석이 예를 들어 장별로 세분화되어 있는 경우, 해당 요소는 둘 이상의 목록을 포함할 수 있습니다).

저자는 미주 안에서 doc-footnote 역할을 가진 요소를 선언해서는 MUST NOT 됩니다. 이는 암시된 역할과 중복되기 때문입니다.

저자는 미주를 포함하는 목록에 doc-endnotes 역할을 직접 적용해서는 MUST NOT 됩니다.

<section role="doc-endnotes">
   <h2>주석</h2>
   <ol>
      <li id="6baa07af">
         <p>이 연구의 추가 결과는 …에서 확인할 수 있습니다. </p>
      </li>
      <li id="7b2c0555">
         <p>…</p>
      </li>
      …
   </ol>
</section>

<section role="doc-endnotes">
   <h2>주석</h2>
   <section>
      <h3>제1곡</h3>
      <div role="list>
         <div role="listitem">
            <p>1. 여기서 두운의 사용은 … </p>
         </div>
         …
      </div>
   </section>
   …
</section>

작품 또는 섹션의 시작 부분에 배치되어 주제를 확립하거나 분위기를 설정하는 인용문.

<blockquote role="doc-epigraph">
   <p>“제발 말해 주시겠어요, 여기서 어느 길로 가야 하나요?”</p>
   <p>“그건 네가 어디에 가고 싶은지에 꽤 많이 달려 있지,” 고양이가 말했다.</p>
</blockquote>

작품의 행동과 사건을 마무리하거나 논평하는 서사의 결론 섹션으로, 일반적으로 미래의 관점에서 제시됩니다.

<section role="doc-epilogue">
   <header>
      <h2>에필로그</h2>
      <p>프로스페로가 말함</p>
   </header>
   <p>이제 나의 마법은 모두 무너졌고, …</p>
   …
</section>

작품의 최초 출판 후 발견된 수정 사항 모음으로, 때때로 corrigenda라고도 합니다.

<section role="doc-errata">
   <h2>수정 사항</h2>
   …
</section>

코드 목록, 사례 연구 또는 문제와 같은 작품의 핵심 개념에 대한 예시.

<figure role="doc-example">
   <figcaption>예제 1 — 안녕, 세상!</figcaption>
   …
</figure>

인용 또는 해설과 같은 부가 정보로, 참조된 텍스트 구절에 추가 맥락을 제공합니다.

doc-footnote 역할은 작품 본문 안에 나타나는 개별 주석을 표현하기 위한 용도로만 사용됩니다. 섹션 끝에 나타나는 주석 모음에 대해서는 doc-endnotes를 참조하세요.

<aside id="6baa07af" role="doc-footnote">
   * 이 연구 및 유사 연구의 추가 결과는 …에서 확인할 수 있습니다.
</aside>

작품에 앞서 나오는 소개 섹션으로, 일반적으로 작품의 저자가 쓰지 않습니다.

<section role="doc-foreword">
   <h2>머리말</h2>
   …
</section>

콘텐츠에서 사용되는 새롭거나 흔하지 않거나 전문적인 용어의 간략한 사전.

용어집의 구조는 최종 사용자가 각 용어와 관련 정의를 식별할 수 있도록 SHOULD 해야 합니다(예: [HTML] dfn 요소 사용).

<section role="doc-glossary" aria-label="용어집">
   <dl>
      …
      <dt id="bcc0f155"><dfn>신용부도스와프</dfn></dt>
      <dd>
         신용부도스와프는 차입자의 채무불이행에
         사실상 대비해 보험을 제공합니다.
      </dd>
      …
   </dl>
</section>

<section role="doc-glossary" aria-labelledby="glosshd">
   <h2 id="glosshd">기술 용어 해설</h2>
   <ul>
      <li id="gtt00110001"><dfn>알고리즘</dfn> 규칙의 집합 …</li>
      …
   </ul>
</section>

용어집 정의에 대한 참조.

<p>
   이는
   <a href="#bcc0f155" role="doc-glossref">신용부도스와프</a> 비용에 나타납니다 …
</p>

작품에서 다루는 주요 주제, 이름 및 기타 중요한 항목에 대한 링크의 상세 목록을 제공하는 탐색 보조 수단.

<section role="doc-index">
   <h2>색인</h2>
   <section>
      <h2>A</h2>
      <ul>
         <li>A/B 테스트, <a href="chapter03.xhtml#page230">230</a></li>
         …
      </ul>
   </section>
   …
</section>

일반적으로 작품의 범위 또는 성격을 소개하는 예비 섹션.

<section role="doc-introduction">
   <p>모든 사람은 마케팅에 대해 어느 정도 경험이 있습니다 … </p>
</section>

각주 또는 미주에 대한 참조로, 일반적으로 본문에 위첨자 숫자 또는 기호로 나타납니다.

<p> … 연구들이 보여 주었듯이.<a href="#fn01" id="fnref01" role="doc-noteref">[1]</a></p>

행동 또는 사건에서 발생할 수 있는 결과를 사용자에게 알립니다. 예에는 경고, 주의 및 위험이 포함됩니다.

<section role="doc-notice">
   <img src="warning.png" alt="경고 아이콘"/>
   <p>글꼴을 포함할 수 있다고 해서 반드시 그래야 하는 것은 아닙니다.
      가독성에 대해 신중하게 생각하세요. 또한 지식 재산권을 존중하세요.
      훌륭한 무료 오픈 소스 글꼴이 많이 있습니다.</p>
</section>

저자는 알림을 탐색 대상으로 삼아야 할 때 레이블을 포함하는 것이 SHOULD 됩니다.

<div role="doc-notice" aria-label="폭발 위험">
   <p><em>위험!</em> 반응성 물질을 혼합하면 폭발이 발생할 수 있습니다.</p>
</div>

콘텐츠의 정적으로 페이지가 매겨진 버전에서 연속된 두 페이지 사이에 나눔이 발생하는 위치를 나타내는 구분자.

페이지 나눔 위치 지정자는 순수 디지털 출판물(즉, 정적으로 페이지가 매겨진 동등물이 존재하지 않는 경우)에서 정적 마커를 제공하는 데도 흔히 사용됩니다. 이러한 마커는 글꼴 및 화면 크기의 차이와 관계없이 일관된 탐색을 제공하며, 그렇지 않으면 콘텐츠의 동적 페이지 매김에 영향을 줄 수 있습니다.

저자는 페이지 나눔의 이름이 시작되는 페이지를 식별하는 최종 사용자가 이해할 수 있는 페이지 번호가 되도록 MUST 보장해야 하며, 이를 통해 보조 기술이 필요에 따라 페이지를 알릴 수 있어야 합니다 (예: 현재 페이지를 식별하는 명령에서).

페이지 나눔 위치 지정자는 자신이 식별하는 페이지의 콘텐츠보다 앞에 와야 MUST 합니다. 페이지에 헤더(doc-pageheader)가 포함되어 있는 경우, 페이지 나눔 위치 지정자는 헤더에 보이는 페이지 번호가 포함되어 있더라도 그 앞에 위치하는 것이 SHOULD 됩니다. 페이지 나눔 위치 지정자는 페이지 헤더 안의 페이지 번호가 헤더의 다른 모든 콘텐츠보다 앞서는 경우 해당 번호와 함께 사용될 MAY 있습니다.

정적 페이지 동등물에서 페이지 나눔 위치 지정자를 재현할 때, 단어가 페이지 사이에서 하이픈으로 나뉘는 경우가 있습니다. 이런 경우 페이지 나눔 위치 지정자는 텍스트 음성 변환 재생을 방해하지 않도록 단어 앞이나 뒤에 배치하는 것이 SHOULD 됩니다.

페이지 하단에 나타나 현재 작품과 그 안의 위치에 대한 맥락을 제공하는 텍스트 섹션. 페이지 푸터는 본문 텍스트와 구별되며 일반적으로 문서 제목, 현재 섹션, 저자명 및 페이지 번호와 같은 항목(잘릴 수 있음)을 포함하는 반복 템플릿을 따릅니다.

doc-pagefooter 역할은 페이지 푸터의 모든 인스턴스에 사용되어야 MUST 합니다.

doc-pagefooter는 doc-pagebreak를 포함해서는 MUST NOT 됩니다.

doc-pagefooter는 각주(doc-footnote)를 포함해서는 MUST NOT 됩니다.

보조 기술은 사용자가 페이지 푸터의 방해 없이 문서 콘텐츠를 연속적으로 읽을 수 있도록 허용할 MAY 있습니다.

<section role="doc-pagefooter">
   <div>레프 톨스토이</div>
   <div>321</div>
   …
</section>

페이지 상단에 나타나 현재 작품과 그 안의 위치에 대한 맥락을 제공하는 텍스트 섹션. 페이지 헤더는 본문 텍스트와 구별되며 일반적으로 문서 제목, 현재 섹션, 저자명 및 페이지 번호와 같은 항목(잘릴 수 있음)을 포함하는 반복 템플릿을 따릅니다.

doc-pageheader 역할은 페이지 헤더의 모든 인스턴스에 사용되어야 MUST 합니다.

보조 기술은 사용자가 페이지 헤더의 방해 없이 문서 콘텐츠를 연속적으로 읽을 수 있도록 허용할 MAY 있습니다.

<section role="doc-pageheader">
   <div>전쟁과 평화</div>
   <div>321</div>
   …
</section>

콘텐츠 안의 페이지 나눔에 대한 링크 목록을 제공하는 탐색 보조 수단.

<nav role="doc-pagelist">
   <h2>페이지</h2>
   <ol>
      <li><a href="chapter.xhtml#Page_1">1</a></li>
      <li><a href="chapter.xhtml#Page_2">2</a></li>
      …
   </ol>
</nav>

특정 주제, 서사 흐름 또는 유사하게 캡슐화된 테마를 다루는 관련 섹션 집합을 포함하는 작품의 주요 구조적 구획.

<section role="doc-part">
   <h2>제1부</h2>
   <section role="doc-chapter">
      <h2>1장</h2>
      …
   </section>
   …
</section>

작품에 앞서 나오는 소개 섹션으로, 일반적으로 작품의 저자가 씁니다.

<section role="doc-preface">
   <h2>소개: 은하계 안내서</h2>
   …
</section>

작품의 배경을 설정하는 소개 섹션으로, 일반적으로 서사의 일부입니다.

<section role="doc-prologue">
   <header>
      <h2>프롤로그</h2>
      <p>합창</p>
   </header>
   <p>위엄이 같은 두 가문이, …</p>
   …
</section>

현재 콘텐츠에서 가져와 눈에 띄게 배치되거나 강조된 인용문으로, 주제에 주의를 끌거나 핵심 사항을 강조하도록 설계되었습니다.

다른 출처에서 인용한 구절과 달리, pullquote는 현재 문서 안의 텍스트를 직접 반복한 것입니다. 따라서 저자는 표현용으로 나타나는 항목이 보조 기술 사용자에게 숨겨지도록 MUST 보장해야 합니다(예: aria-hidden 속성 사용).

다음 예제는 다른 위치에 표시될 pullquote의 식별을 보여 줍니다 (예: 스크립트를 통해). 이 경우 표시된 텍스트가 표현용이 아니므로 pullquote는 숨겨지지 않습니다.

<p>… 나는 죽을 수도 있지만, 먼저 너, 나의 폭군이자 고문자는 너의 비참함을 바라보는 태양을 저주하게 될 것이다.
   <span id="pq01" role="doc-pullquote">조심하라, 나는 두려움이 없으므로 강하다.</span>
   나는 뱀의 교활함으로 지켜보다가 그 독으로 찌를 것이다. … </p>

다음 예제는 텍스트를 중복하는 pullquote를 보여 줍니다. 이 인용문은 표현 목적만을 위한 것이므로 숨겨집니다.

<p>… 더 나은 습관은 성장을 향한 길을 열고, 성장은 더 큰 행복으로 이어집니다.</p>
<aside role="doc-pullquote" aria-hidden="true">
   더 나은 습관은 성장을 향한 길을 열고, 성장은 더 큰 행복으로 이어집니다.
</aside>

인터뷰나 자주 묻는 질문 목록처럼 일련의 질문과 답변으로 구성된 콘텐츠 섹션.

<section role="doc-qna">
   <h2>저자와의 인터뷰</h2>
   <dl>
      <dt>질문: 언제 이 책을 쓰기 시작했나요?</dt>
      <dd>답변: 처음 아이디어를 얻은 것은 …</dd>
      …
   </dl>
</section>

작품 또는 그 안의 섹션이나 구성 요소에 대한 설명적 또는 대체 제목.

<header>
   <h2>2장 전투</h2>
   <p role="doc-subtitle">다시 한번 돌파구 속으로</p>
</header>

콘텐츠의 어떤 측면을 명확히 하거나 이해를 돕는 유용한 정보.

<aside role="doc-tip">
   <h3>팁</h3>
   <p>이전 값을 포함하는 표현식의 결과인 새 값을
      변수에 할당할 수 있습니다.</p>
</aside>

콘텐츠의 주요 섹션 제목에 대한 정렬된 링크 목록을 제공하는 탐색 보조 수단. 목차는 전체 작품을 다룰 수도 있고 그보다 작은 섹션만 다룰 수도 있습니다.

<nav role="doc-toc">
   <h2>목차</h2>
   <ol role="directory">
      <li><a href="preface_001.xhtml">원본 필사자의 주석:</a></li>
      <li><a href="introduction_001.xhtml">어원.</a></li>
      <li><a href="epigraph_001.xhtml">발췌문(하위-하위-사서가 제공).</a></li>
      <li><a href="chapter_001.xhtml">1장. 어렴풋한 그림자.</a></li>
      …
   </ol>
</nav>