Skip to content

Commit

Permalink
Merge pull request #132 from daisy/gitlocalize-31787
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 7aca66d + 75b791b commit f273fde
Show file tree
Hide file tree
Showing 4 changed files with 483 additions and 0 deletions.
162 changes: 162 additions & 0 deletions publishing/ja/navigation/pagelist.html
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,162 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>ページリスト（Page List）</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="description" content="Guidance for including a page list in a digital publication.">
<script>
var page_info = {
'category': 'Navigation',
'appliesTo': ['Audiobooks', 'EPUB3','EPUB2'],
'related': ['nav-pagenav','nav-pagebreaks','nav-pagesrc']
};
</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>ページリストは、ページ区切り位置へのリンクの単純な順序付きリストです。これは<code>epub:type</code>属性値<code>page-list</code>によって識別されます。</p>
<p>spineに<a href="toc.html">目次</a>を含んでいる場合には、リストがユーザーに表示されないようにページリストに対して<code>hidden</code>属性を設定するよう注意してください。</p>
<p>ページリストが常にユーザーに対して非表示になっている場合、あるいはEPUBナビゲーション ドキュメントがspineに含まれていない場合には、ARIA <code>role</code>属性（<a href="#ex-02">次の例</a>を参照）は必要ありません。</p>
</figcaption>
<pre id="ex-01-src" class="prettyprint linenums"><code>&lt;nav epub:type="page-list" hidden="hidden"&gt;
&lt;ol&gt;
&lt;li&gt;&lt;a href="georgia.xhtml#page752"&gt;752&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="georgia.xhtml#page753"&gt;753&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="georgia.xhtml#page754"&gt;754&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="georgia.xhtml#page755"&gt;755&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="georgia.xhtml#page756"&gt;756&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="georgia.xhtml#page757"&gt;757&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="georgia.xhtml#page758"&gt;758&lt;/a&gt;&lt;/li&gt;
&lt;/ol&gt;
&lt;/nav&gt;</code></pre>
</figure>

<figure id="ex-02">
<figcaption>
<div class="label">例 2 — ページリスト (Web)</div>
<p>Web 上で使用されるページリストは、通常、 <code>role</code>属性値<code>doc-pagelist</code>によって識別されます。<code>aria-label</code>属性は、ナビゲーション要素のタイトルを提供するために使用されますが、明示的な見出しも使用できます（2 番目の<code>nav</code>要素を参照）。</p>
</figcaption>
<pre id="ex-02-src" class="prettyprint linenums"><code>&lt;nav role="doc-pagelist" aria-label="Page list"&gt;
&lt;ol&gt;
&lt;li&gt;&lt;a href="georgia.xhtml#page752"&gt;752&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="georgia.xhtml#page753"&gt;753&lt;/a&gt;&lt;/li&gt;
…
&lt;/ol&gt;
&lt;/nav&gt;

&lt;nav role="doc-pagelist" aria-labelledby="pg-hd"&gt;
&lt;h2 id="pg-hd"&gt;Page List&lt;/h2&gt;
&lt;ol&gt;
&lt;li&gt;&lt;a href="georgia.xhtml#page752"&gt;752&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="georgia.xhtml#page753"&gt;753&lt;/a&gt;&lt;/li&gt;
…
&lt;/ol&gt;
&lt;/nav&gt;</code></pre>
</figure>

<figure id="ex-03">
<figcaption>
<div class="label">例 3 — ページリスト（EPUB 2 および DAISY 3）</div>
<p>EPUB 2 および DAISY 3 出版物のページリストは、NCXと呼ばれるカスタムXML文法を使用して表現されます。</p>
</figcaption>
<pre id="ex-03-src" class="prettyprint linenums"><code>&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;ncx xmlns:ncx="http://www.daisy.org/z3986/2005/ncx/"
xmlns="http://www.daisy.org/z3986/2005/ncx/"
version="2005-1" xml:lang="en"&gt;
…
&lt;pageList&gt;
&lt;navLabel&gt;
&lt;text&gt;Pages&lt;/text&gt;
&lt;/navLabel&gt;
&lt;pageTarget type="normal" id="page752" value="752" playOrder="1"&gt;
&lt;navLabel&gt;
&lt;text&gt;752&lt;/text&gt;
&lt;/navLabel&gt;
&lt;content src="georgia.xhtml#page752"/&gt;
&lt;/pageTarget&gt;
&lt;pageTarget type="normal" id="page753" value="753" playOrder="2"&gt;
&lt;navLabel&gt;
&lt;text&gt;753&lt;/text&gt;
&lt;/navLabel&gt;
&lt;content src="georgia.xhtml#page753"/&gt;
&lt;/pageTarget&gt;
…
&lt;/pageList&gt;
&lt;/ncx&gt;</code></pre>
</figure>
</section>

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

<dl>
<dt id="faq-pl-001">ページリストのリンクはどのような順序にすれば良いでしょうか？</dt>
<dd>
<p>現在、ページリスト内のリンクの順序に関する要件はありません。一般的な手法はリンクを数字順に並べることですが、電子出版物のコンテンツの順序が物理的な順序と一致しない場合があります（たとえば、出版社が前書きを最後に移動する場合があります）。このような場合、一部のEPUB作成者は、デジタルコンテンツに合わせたページリスト順番を好みます。</p>
</dd>

<dt id="faq-pl-002">ページリストを含む出版物にはページ区切りマーカーが必要ですか？</dt>
<dd>
<p>ページリストは、ページ区切りマーカーのない電子出版物に含まれる場合がありますが、この方法はまれであり、ユーザーにとってあまり役に立ちません。例としては、各章の最初のページにのみリンクするページリストがあります。ページリストは、ページ区切りマーカーの代わりに、章の見出しにリンクできます。ただし、通常は目次によって各章へのアクセスが提供されるので、このアプローチの活用は限定的です。</p>
</dd>
</dl>
</section>

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

<p>印刷物のような静的にページ番号が付けられた原本よりリフロー可能な出版物が製作される場合、ページリストを組み込むと、ユーザーは静的なページ位置に移動できます。たとえば、クラスメイトが印刷物の本を使用しているクラスでデジタル版を使用している学生は、授業中にまったく同じページに移動できます。</p>

<p>ページリスト自体は、すべてのページ区切り位置へのリンクのリストです。ユーザーエージェントはこのリストを使用して自動ページ ジャンプ機能を提供できます。また、ユーザーはこのリストに直接アクセスして手動で移動したいページを選択できます。</p>

<p>EPUB 3 では、ページリストはナビゲーション ドキュメント内の<a href="https://www.w3.org/TR/epub-33/#sec-nav-pagelist">ページリスト nav 要素</a>で表現されます。この要素は、基本的に各ページ区切り位置へのリンクのフラットリストです。</p>

<pre id="expl-pl-01-src" class="prettyprint linenums"><code>&lt;nav epub:type="page-list"&gt;
&lt;ol&gt;
&lt;li&gt;&lt;a href="chapter01.xhtml#page1"&gt;1&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="chapter01.xhtml#page2"&gt;2&lt;/a&gt;&lt;/li&gt;
…
&lt;/ol&gt;
&lt;/nav&gt;</code></pre>

<p>EPUB 2 では、ページリストは NCX ファイルの<a href="http://www.idpf.org/epub/20/spec/OPF_2.0.1_draft.htm#Section2.4.1.2"><code>pageList</code>要素</a>を使用して表現されます（<a href="#ex-02">例 2</a>を参照）。</p>
</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-pagelist"><code>page-list nav</code>要素</a>
</li>
<li>EPUB 2 — <a href="http://www.daisy.org/z3986/2005/Z3986-2005.html#li_392a"><code>pageList</code>要素</a>
</li>
</ul>
</section>
</main>
</body>
</html>
40 changes: 40 additions & 0 deletions publishing/ja/navigation/pagenav.html
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>ページナビゲーション（Page Navigation）</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="description" content="Guidance for including page navigation a digital publication.">
<script>
var page_info = {
'category': 'Navigation',
'related': ['nav-pagebreaks','nav-pagelist','nav-pagesrc']
};
</script>
<script src="/js/init.js"></script>
</head>

<body>
<main>
<section id="desc" aria-label="overview">
<p>電子出版物に対するページ ナビゲーションの提供には多くの利点があります。学校などで、印刷版とデジタル版が混在する環境にいるユーザーは、容易に表示箇所を調整できます(たとえば、教師の指示があれば、印刷版とデジタル版のどちらを持っているかに関係なく、すべての生徒がまったく同じページにアクセスできます）。また、デジタルのみの出版物でも一般的な利点があります。デジタルのみの出版物の場合、ページナビゲーションが利用できなければ、複数のユーザーは同じ場所に移動するために、同じリーディングシステムを用いて、まったく同じテキストに関する設定をしなければならないことがあるためです。</p>

<p>ページナビゲーションには 3 つの重要な側面があります。</p>

<ul>
<li>出版物に<a href="pagebreaks.html">ページ区切りマーカー</a>を追加します。</li>
<li>ユーザーがページにアクセスできるように<a href="pagelist.html">ページリスト</a>を組み込みます。</li>
<li>静的なページのある原本から作成している場合は、<a href="pagesrc.html">ページ区切りの原本</a>を設定します。</li>
</ul>

<p>ページ区切りマーカーは、電子出版物内の特別なマークアップです。ユーザーが現在いるページに関する情報を支援技術に提供します。また、ページリストからのリンク先でもあります。詳細については、ナレッジ ベースの<a href="pagebreaks.html">ページ区切り</a>ページを参照してください。</p>

<p>ページリストは、リーディングシステムの「ページ移動」機能を動作させるのに必須な情報です。これは、電子出版物内のすべてのページ区切り先へのリンクのリストです。通常ユーザーには、目次などのように、探りたいページのリスト全体は提供されません。詳細については、ナレッジ ベースの<a href="pagelist.html">ページリスト</a>ページを参照してください。</p>

<p>ページ区切り原本の設定は、ページ ナビゲーションを提供するための最後のステップです。ユーザーはページ区切りが役立つかどうかを判断する際、ページ区切りとページ リストがどの静的なページのある原本に対応しているかを知る必要があります（たとえば、クラスメートが使用している印刷版の教科書と一致しているかどうか）。ページ区切り原本は、電子出版物のメタデータとして提供します。詳細については、ナレッジベースの<a href="pagesrc.html">ページ区切りの原本</a>ページを参照してください。</p>

<p>ページ付けのあるすべての電子出版物に、これらの側面がすべて備わっているわけではありません。たとえば、出版物にページリストのみがあり、ページ区切りマーカーが省略されている場合があります。また、デジタルのみの出版物にはページ付けの原本がない場合があります。ただし、一般的にはアクセシビリティのためにページナビゲーションを提供している電子出版物には、これらすべてが含まれます。</p>
</section>
</main>
</body>
</html>
115 changes: 115 additions & 0 deletions publishing/ja/navigation/pagesrc.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>ページソース（Page Source）</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="description" content="Guidance for identifying the source of pagination in a digital publication.">
<script>
var page_info = {
'category': 'Navigation',
'appliesTo': ['Audiobooks', 'EPUB3','EPUB2'],
'related': ['nav-pagenav','nav-pagebreaks','nav-pagelist']
};
</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-1.3.1]]</li>
</ul>
</section>

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

<figure id="ex-01">
<figcaption>
<div class="label">例 1 - ページ区切りソースの識別 ( <code>pageBreakSource</code> )</div>

<p>ページネーション ソースを識別するために、<code>dc:source</code>と<code>source-of</code>の二つのプロパティを用いる必要は無く、<code>pageBreakSource</code>プロパティのみを用います（つまり、以前は2つのプロパティが必要だったことを1つのプロパティで表現できます)。</p>
</figcaption>
<pre id="ex-01-src" class="prettyprint linenums"><code>&lt;meta property="pageBreakSource"&gt;urn:isbn:9781234567891&lt;/meta&gt;</code></pre>
</figure>

<figure id="ex-02">
<figcaption>
<div class="label">例 2 — ページ区切りのソース識別 ( <code>source-of</code> )</div>

<p>この例では、古い<code>source-of</code>プロパティを使用してページネーション ソースを識別します。<strong>この方法は推奨されなくなりました。</strong>詳細については、以下の<a href="#faq-001">FAQ エントリ</a>を参照してください。</p>
</figcaption>
<pre id="ex-02-src" class="prettyprint linenums"><code>&lt;dc:source id="pg-src"&gt;urn:isbn:9781234567891&lt;/dc:source&gt;
&lt;meta property="source-of" refines="#pg-src"&gt;pagination&lt;/meta&gt;</code></pre>
</figure>
</section>

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

<dl>
<dt id="faq-001">
<code>source-of</code>プロパティまたは<code>pageBreakSource</code>プロパティのどちらを使用するべきでしょうか？</dt>
<dd>
<p>EPUB でページ区切りのソースを識別する古い方法は、 <code>dc:source</code>と<code>source-of</code>メタデータ プロパティの組み合わせです。ただし、この方法には 2 つの重大な欠陥があります。1 つは、EPUB でしか機能しないこと (メタデータの調整は他のフレームワークでは機能しません)、もう 1 つは、デジタル版のみでは機能しないこと (つまり、ページ区切りにソースがない場合) です。</p>

<p id="pbs">現在は、<code>pageBreakSource</code>という単一のプロパティのみを使用する方法が推奨されています (<a href="#ex-07">例 7</a>を参照)。このプロパティが標準に完全に統合されるまでには EPUB の別の改訂が必要になりますが、使用に問題はありません。Epubcheck はこのプロパティを正しく検証します。</p>

<p>ページ区切りがデジタル版専用に作成された場合は、 <code>pageBreakSource</code>プロパティの値を「none」に設定して、 <code>dc:source</code>の使用に関する問題を解決できます。</p>

<p><code>pageBreakSource</code>プロパティの詳細については、 <a>「ページ ソースの識別」</a>を参照してください。</p>
</dd>

<dt id="faq-002">ページネーション ソースに ISBN のような一意の識別子がない場合はどうなりますか?</dt>
<dd>
<p><code>pageBreakSource</code>プロパティに一意の識別子が含まれている必要はなく、ソースを一意に識別するだけで十分です。一意の識別子がない場合は、ソース ドキュメントに関する情報を使用して、ソース ドキュメントの一意の名前を作成します。</p>

<p>PDF マニュアル、ワードプロセッサ ドキュメントなど、静的なページ番号を持ちながら一意の識別子を持たない、EPUB として表現できるドキュメントの種類は多数あります。</p>

<p>このような種類のドキュメントでは、ページ区切りのソース識別のために最低でもタイトルが利用できます。より詳細にするには、作成者、作成日などを識別子に追加します。</p>

<pre><code>&lt;metadata …&gt;
…
&lt;meta property="pageBreakSource"&gt;
ACME Explosive Tennis Balls -
User Manual, 5th Edition, PDF
&lt;/meta&gt;
…
&lt;/metadata&gt;</code></pre>
</dd>
</dl>
</section>

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

<p><a href="pagelist.html">ページ リスト</a>と<a href="pagebreaks.html">ページ区切りマーカー</a>は、ユーザーが静的なページ区切りの場所にアクセスできるテクノロジーですが、ページ区切りのソースが判らなければ、ユーザーは電子出版物の有用性を判断できません。たとえば、教室の生徒は、ページ区切りがクラスの他の生徒が使用している印刷書籍と同じバージョンから派生したものかを知る必要があります。</p>

<p>ページ区切りのソースは、 <code>pageBreakSource</code>プロパティを使用して識別されます。</p>

<pre id="expl-01-src" class="prettyprint linenums"><code>&lt;meta property="pageBreakSource"&gt;urn:isbn:9780123456789&lt;/meta&gt;</code></pre>

<p>プロパティの値は、ISBN など、静的にページ分けされたソースの一意の識別子です。</p>
</section>

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

<ul>
<li>EPUB —<a href="https://www.w3.org/publishing/a11y/page-source-id/">ページソース識別</a>
</li>
</ul>
</section>
</main>
</body>
</html>
Loading

0 comments on commit f273fde

Please sign in to comment.