Skip to content

Commit

Permalink
Merge pull request #130 from daisy/gitlocalize-31676
Browse files Browse the repository at this point in the history 
finalized japanese translation files
  • Loading branch information
@mattgarrish
mattgarrish authored Dec 2, 2024
2 parents bfcc5af + 8763f6a commit 7aca66d
Show file tree
Hide file tree
Showing 3 changed files with 419 additions and 0 deletions.
115 changes: 115 additions & 0 deletions publishing/ja/navigation/content-list.html
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,115 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>コンテンツリスト（Content Lists）</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="description" content="Best practices for adding navigational lists of tables, figures, and similar content.">
<script>
var page_info = {
'category': 'Navigation',
'appliesTo': ['EPUB3','EPUB2']
};
</script>
<script src="/js/init.js"></script>
</head>

<body>
<main>
<section id="summary">
<h3>要約</h3>

<p>表、イラスト、ビデオなどの重要なコンテンツのリストを提供することで、読者は容易にそれらの項目との間を往復できます。</p>
</section>

<section id="tech">
<h3>テクニック</h3>

<ul>
<li>
<p>二次コンテンツ用のナビゲーションリストを含めます。[[WCAG-2.4.5]]</p>
</li>
<li>
<p>リスト内の項目を区別するために意味のある名前を付けます。[[WCAG-2.4.6]]</p>
</li>
</ul>
</section>

<section id="ex">
<h3>例</h3>

<figure id="ex-01">
<figcaption>
<div class="label">例1 — 図表一覧</div>
</figcaption>
<pre id="ex-01-src" class="prettyprint linenums"><code>&lt;nav epub:type="loi"&gt;
&lt;h2&gt;List of Figures&lt;/h2&gt;
&lt;ol&gt;
&lt;li&gt;
&lt;a href="s01.xhtml#fig1"&gt;Figure 1 — Gaseous anomalies&lt;/a&gt;
&lt;/li&gt;
…
&lt;/ol&gt;
&lt;/nav&gt;</code></pre>
</figure>

<figure id="ex-02">
<figcaption>
<div class="label">例2 — ビデオのリスト</div>
</figcaption>
<pre id="ex-02-src" class="prettyprint linenums"><code>&lt;nav epub:type="lov"&gt;
&lt;h2&gt;List of Video&lt;/h2&gt;
&lt;ol&gt;
…
&lt;li&gt;
&lt;a href="s04.xhtml#vid04-1"&gt;4.1 — Cell mitosis&lt;/a&gt;
&lt;/li&gt;
…
&lt;/nav&gt;</code></pre>
</figure>
</section>

<section id="faq">
<h3>よくある質問</h3>

<dl>
<dt id="faq-001">EPUBナビゲーション ドキュメントにコンテンツリストを組み込むべきでしょうか？</dt>
<dd>
<p><em>spineにナビゲーション ドキュメントを含んでいる場合に限り必要です。</em></p>
<p>ナビゲーション ドキュメントにコンテンツリストを組み込むのが理想ですが、EPUBリーディングシステムは通常は目次のみのサポートであり、場合によってページ一覧がサポートされるといった状況です。EPUB規格の上ではEPUBリーディングシステムはナビゲーション ドキュメントのすべてのコンテンツにアクセスできるようにする必要がありますが、現実にはそのようになっていません。以上のような理由で、ナビゲーション ドキュメントがspineにない場合には読者はリストにアクセスできません。</p>
</dd>
<dt id="faq-002">
<code>epub:type</code>属性を付ける必要はありますか？</dt>
<dd>
<p>リストがナビゲーション ドキュメントに含まれている場合のみ必要です。これらの値は、リーディングシステムがリストの目的を判断するのに役立ちますが、現時点ではそれらの使用法は知られていません。通常、<a href="toc.html"><code>toc</code></a> 、<a href="pagelist.html"><code>pagelist</code></a> 、および<a href="landmarks.html"><code>landmarks</code></a>の値のみが認識されます。</p>
</dd>
</dl>
</section>

<section id="desc">
<h3>解説</h3>

<p>印刷出版物では、情報のある場所をすぐに見つけられるように、図、表、イラストのリストが組み込まれてきました。読者が主要な内容を読む際には、思考の流れを見失わないようにこの情報をスキップすることが多く、通常、この項目を含む作品や章を読み終えた後などに、この情報に戻ります。</p>

<p>視覚的に読む読者は、そのようなコンテンツを視覚的に素早くざっと読み飛ばせるという利点がありますが、支援技術を使用している人や認知障害のある人にとっては、このコンテンツに戻るのは時間がかかり、困難な場合があります。</p>

<p>コンテンツ リストを作成するときは、HTML <code>nav</code>要素を使用して、リストに意味のあるタイトルを付けます。また、リスト内の各エントリがリンク先のコンテンツを意味のある形で説明するようにします（たとえば、詳細なコンテキストがない「図 1」などの単純なラベルは使用しないでください）。</p>

<p>デジタル出版物のリストでは、印刷物のような従来の2次元コンテンツに限定されません。出版物に音声、ビデオ、インタラクティブ コンテンツが含まれている場合には、これらのコンテンツのリストを組み込めます。</p>
</section>

<section id="refs">
<h3>関連リンク</h3>

<ul>
<li>EPUB 3 —<a href="https://www.w3.org/TR/epub/#sec-package-nav-def-types-other">その他の<code>toc nav</code>要素</a>
</li>
<li>EPUB Structural Semantics Vocabulary — <a href="https://www.w3.org/TR/epub-ssv/#navigation">ドキュメントナビゲーション</a>
</li>
<li>HTML — <a href="https://html.spec.whatwg.org/multipage/sections.html#the-nav-element"><code>nav</code>要素</a>
</li>
</ul>
</section>
</main>
</body>
</html>
138 changes: 138 additions & 0 deletions publishing/ja/navigation/landmarks.html
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,138 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>ランドマーク（Landmarks）</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="description" content="Guidance for including a list of landmarks in EPUB publication.">
<script>
var page_info = {
'category': 'Navigation',
'title': 'Landmarks',
'appliesTo': ['EPUB3','EPUB2']
};
</script>
<script src="/js/init.js"></script>
</head>

<body>
<main>
<section id="summary">
<h3>要約</h3>

<p>ランドマークを使用すると、出版物の複数ドキュメントに広がる主要な構造セクションに容易にアクセスできます。</p>
</section>

<section id="tech">
<h3>テクニック</h3>

<ul>
<li>ランドマーク ナビゲーション要素を組み込みます。[[WCAG-2.4.5]]</li>
</ul>
</section>

<section id="ex">
<h3>例</h3>
<figure id="ex-01">
<figcaption>
<div class="label">例 1 — ランドマーク ナビゲーション（EPUB 3）</div>
<p>ランドマークは、通常リンクを均一に並べたリストとして表現します（ネストしたリンクはありません）。</p>
</figcaption>
<pre id="ex-01-src" class="prettyprint linenums"><code>&lt;nav epub:type="landmarks"&gt;
&lt;h2&gt;Guide&lt;/h2&gt;
&lt;ol&gt;
&lt;li&gt;
&lt;a
epub:type="toc"
href="#toc"&gt;Table of Contents&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;a
epub:type="loi"
href="front.html#loi"&gt;List of Images&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;a
epub:type="lot"
href="front.html#lot"&gt;List of Tables&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;a
epub:type="bodymatter"
href="c01.html#c01"&gt;Start of Content&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;a
epub:type="glossary"
href="gloss.html#gloss"&gt;Glossary&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;a
epub:type="bibliography"
href="app.html#biblio"&gt;Bibliography&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;a
epub:type="index"
href="index.html#index"&gt;Index&lt;/a&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;/nav&gt;</code></pre>
</figure>
</section>

<section id="faq">
<h3>よくある質問</h3>

<dl>
<dt id="faq-001">すでに<code>toc nav</code>ですべてにリンクしている場合、なぜ<code>landmarks nav</code>を含める必要があるのですか？</dt>
<dd><p><code>landmarks nav</code>により、目次全体をナビゲートしなくても出版物の主要セクションに簡単にアクセスできるようになるだけでなく、ユーザー エージェントの動作も容易になります。たとえば、本文の最初のページを自動的に開くオプションを提供したり、索引や用語集へのクイック リンクを提供したりできるデバイスでは、 <code>landmarks nav</code>の追加のセマンティクスをこの目的で利用できます。</p></dd>
<dt id="faq-002">パッケージドキュメントに<code>guide</code>を組み込む必要がありますか？</dt>
<dd><p>NCX ファイルを組み込む機能と同様に、<code>guide</code>要素は、古いユーザー エージェントでの前方互換性を容易にするためだけにEPUB 3に存在します。古いシステムのサポートは必須ではありませんが、サポートしたい場合には<code>guide</code>を組み込むべきです。</p></dd>
</dl>
</section>

<section id="desc">
<h3>解説</h3>

<p>ランドマーク ナビゲーションを使用すると、コンテンツの主要なセクションに素早くアクセスできます。これはARIAランドマークと似ていますが、ARIAランドマークは、ユーザーが現在いるページを対象に支援技術によって動的に構成されます。一方、ランドマーク ナビゲーションは、複数のドキュメントから構成される出版物全体に広がるセクションを一覧できる静的リストです。また、ランドマーク ナビゲーション要素は、ARIAランドマークとは異なり、支援技術ユーザーだけでなくすべてのユーザーが利用できます。</p>

<section>
<h4>EPUB 3</h4>

<p>すべてのEPUB出版物には、すべての主要なランドマーク（<code>landmarks nav</code>）へのガイドが組み込まれるべきです。</p>

<p>各ランドマークの性質は、そのリンク要素 ( <code>a</code> ) の<code>epub:type</code>属性で識別される必要があります。<a href="https://www.w3.org/TR/epub-ssv/">EPUB 3 Structural Semantics Vocabulary</a>の一般的なランドマーク プロパティには、次のものがあります。</p>

<ul>
<li>bodymatter（出版物のメインコンテンツ）</li>
<li>toc（見出し）</li>
<li>bibliography（参考文献）</li>
<li>index（索引）</li>
<li>glossary（用語集）</li>
</ul>

<p><a href="toc.html"><code>toc nav</code></a>とは異なり、<code>landmarks nav</code>リンクは、単一の均一なリストでなければなりません。</p>
</section>

<section>
<h4>EPUB 2</h4>

<p>EPUB 2では、ランドマークはNCX の<code>guide</code>要素を用いて指定します。</p>
</section>
</section>

<section id="refs">
<h3>関連リンク</h3>
<ul>
<li>HTML — <a href="https://html.spec.whatwg.org/multipage/sections.html#the-nav-element"><code>nav</code>要素</a>
</li>
<li>EPUB 3 — <a href="https://www.w3.org/TR/epub/#sec-nav-landmarks"><code>landmarks nav</code>要素</a>
</li>
<li>EPUB 2 —<a href="http://idpf.org/epub/20/spec/OPF_2.0.1_draft.htm#Section2.6">ガイド</a>
</li>
</ul>
</section>
</main>
</body>
</html>
Loading

0 comments on commit 7aca66d

Please sign in to comment.