html5/spec-ja/notes.html.u8

<!DOCTYPE HTML>
<html lang=en>
<title>Notes</title>
<link rel=license href="edit/#license" title="You are granted a license to use, reproduce and create derivative works of this document.">
<link rel=stylesheet href="http://suika.fam.cx/www/style/html/xhtml">
<link rel=stylesheet href=ja-style>
<link href=only-ja-style rel="stylesheet" title="Show only Japanese text" id=style-only-ja>
<link href=both-en-ja-style rel="alternate stylesheet" title="Show both English and Japanese texts" id=style-both-en-ja>
<style>
dt {
  display: block;
  font-weight: bolder;
  font-family: sans-serif;
}
dt:after {
  content: ": ";
}
</style>
<script src=ja-script defer async></script>

<h1 class="has-ja-translation" data-ja-hash="f4c6f851b00d5518bf888815de279aba"><span class=en-original lang=en>Notes</span><span class=ja-translation lang=ja>メモ</span></h1>

<ul>
<li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="92eab6549df56f461f0cfa7687f81cc1"><span class=en-original lang=en><a href=non-normative>HTML5 (Japanese translation)</a>
</span><li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="4d7a1ba06a7e5fbf2a32d2981b0ddd56"><span class=en-original lang=en><a href=workers-non-normative>Web Workers (Japanese translation)</a>
</span></ul>

<ins class=ja-note>
<p class="no-ja-translation" data-ja-hash="afdd1db9eeaf666310fea21e7927a286"><span class=en-original lang=en><button type=button onclick="
  document.getElementById ('style-only-ja').disabled = false;
  document.getElementById ('style-both-en-ja').disabled = true;
">日本語訳だけ表示 <span lang=en>Show only Japanese translation</span></button>
</span><p class="no-ja-translation" data-ja-hash="97d06b11b336b157d7f28563061adf66"><span class=en-original lang=en><button type=button onclick="
  document.getElementById ('style-only-ja').disabled = true;
  document.getElementById ('style-both-en-ja').disabled = false;
">英和対訳表示 <span lang=en>Show both English and Japanese texts</span></button>
</ins>

</span><section id=involved>
<h2 class="has-ja-translation" data-ja-hash="8372692ac95eb7fc27fe8f964e134d59"><span class=en-original lang=en>Get involved</span><span class=ja-translation lang=ja>参加</span></h2>

<p class="has-ja-translation" data-ja-hash="7e6840499baa948708bea80c47dbaa33"><span class=en-original lang=en><strong>You can take part in this work.</strong>

</span><span class=ja-translation lang=ja><strong>みなさんにも作業にご参加いただけます。</strong></span><p class="has-ja-translation" data-ja-hash="c18cf918924c53f3ec11aeec4a0acca5"><span class=en-original lang=en>First, <a href="http://suika.fam.cx/~wakaba/pbin/accounts/add">get
a <code>suika.fam.cx</code> account</a> (if you have not) and join the
<code>spec-ja</code> group from <a
href="http://suika.fam.cx/~wakaba/pbin/accounts/edit">your user
page</a>.

</span><span class=ja-translation lang=ja>まず、 <code>suika.fam.cx</code> アカウントをお持ちでない場合は<a href="http://suika.fam.cx/~wakaba/pbin/accounts/add">取得</a>し、
<a
href="http://suika.fam.cx/~wakaba/pbin/accounts/edit">利用者の頁</a>から
<code>spec-ja</code> グループに参加してください。
</span><p class="has-ja-translation" data-ja-hash="92a9cc4bce236eb99a7e3e8a12d9c736"><span class=en-original lang=en>Then:

</span><span class=ja-translation lang=ja>その後、</span><dl>

<dt class="has-ja-translation" data-ja-hash="28ec63e44e52fee5a70f664be097c274"><span class=en-original lang=en>Translate a paragraph that is not translated yet

</span><span class=ja-translation lang=ja>まだ翻訳されていない段落を翻訳する</span><dd class="has-ja-translation" data-ja-hash="a692b10a8f35e0f3cf6fd511ca6a6151"><span class=en-original lang=en>Double-click the paragraph and input the translated text into the
second textbox.

</span><span class=ja-translation lang=ja>段落をダブルクリックして、2つ目のテキスト欄に訳文を入力してください。</span><dt class="has-ja-translation" data-ja-hash="086d0e4b57341f5cd2d4cb3f36826e95"><span class=en-original lang=en>Fix a typographical error in the translated text
</span><span class=ja-translation lang=ja>訳文中の誤植を修正する</span><dt class="has-ja-translation" data-ja-hash="730cbe705d1e4756740712e7a51a3f1d"><span class=en-original lang=en>Fix a paragraph that has been translated incorrectly

</span><span class=ja-translation lang=ja>誤訳が含まれる段落を修正する</span><dd class="has-ja-translation" data-ja-hash="8d45df313157a64a6969321f30531a9e"><span class=en-original lang=en>Double-click the paragraph in which the error is found and fix the
error.

</span><span class=ja-translation lang=ja>誤っている段落をダブルクリックして、訂正してください。</span><dd class="has-ja-translation" data-ja-hash="d001157868e617afc964fc89f6eb2f0f"><span class=en-original lang=en>Alternatively, you can report the problem to <a
href="edit/_bugs">the _bugs page</a>.

</span><span class=ja-translation lang=ja>または、<a
href="edit/_bugs">_bugs 頁</a>に報告してください。</span><dt class="has-ja-translation" data-ja-hash="b4ab93390c623c3d78715fb10b4d4c4a"><span class=en-original lang=en>Discuss the choice of a Japanese term
</span><span class=ja-translation lang=ja>訳語の選択について議論する</span><dt class="has-ja-translation" data-ja-hash="6500bd44ff2be0f322d6e6abb5c47dba"><span class=en-original lang=en>Discuss any other topic

</span><span class=ja-translation lang=ja>その他の問題提起を行う</span><dd class="has-ja-translation" data-ja-hash="c5decf76b49e52c6e8669c2df522cf33"><span class=en-original lang=en>Write on <a href="edit/_notes">the _notes page</a>.

</span><span class=ja-translation lang=ja><a href="edit/_notes">_notes 頁</a>に書き込んでください。</span></dl>

</section>

<section id=intro>
<h2 class="has-ja-translation" data-ja-hash="8014bbeb50acd84d5c92d021fa758bd4"><span class=en-original lang=en>Introduction to the interactive translation interface</span><span class=ja-translation lang=ja>対話的翻訳ツールの説明</span></h2>

<p class="has-ja-translation" data-ja-hash="e374f40e99a08bc848e10eff93d867db"><span class=en-original lang=en>For the translating work of the HTML5 specification, a new
interactive paragraph-level editing interface has been developed.
Since the HTML5 specification adopts a new specification development
model &mdash; publishing a large Editor's Draft with sections in
different levels of maturity, in daily basis &mdash; it is unrealistic
to follow the traditional model for the development of a Japanese
translation of a technical specification &mdash; obtaining a copy of a
relatively stable Working Draft or a final Recommendation, translating
the whole document at once, and then publishing the finalized Japanese
translation.

</span><span class=ja-translation lang=ja>HTML5 仕様書の翻訳のために、新たに段落毎に対話的に編集できるツールを開発しました。
HTML5 仕様書は、これまでの仕様書とは異なる新しいスタイルで開発されています。
仕様書は非常に膨大な内容で、その内容は章節毎に異なる安定度にあります。
そして、編集者案の形で公開される仕様書は、日々頻繁に更新されています。
そのため、旧来の仕様書日本語訳のように、比較的安定した作業原案や最終的な勧告の全文を翻訳し、
翻訳完了してから公開するという方法を採るのは非現実的です。</span><p class="has-ja-translation" data-ja-hash="f3a5d8962fa4722e56ff9fe5c26efcde"><span class=en-original lang=en>The new interactive translation editing interface (and its backend
management tools) enables a different style of the translation work:

</span><span class=ja-translation lang=ja>この新しい対話的翻訳ツールは、新しいスタイルでの仕様書の翻訳を支援します。</span><ul>

<li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="75e8c1cd2ba7f6c9687e934ecf8c60c5"><span class=en-original lang=en><strong>Use of an interactive Web interface</strong>.  A
translated version of a paragraph can be added or modified by just
choosing the paragraph to add or modify and then editing the text in a
Web browser.  You no longer have to prepare your environment for the
translatioon work; you just need an interactive standard-compliant Web
browser.

</span><li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="e2a6c25e559b1c75253c040954831368"><span class=en-original lang=en><strong>Paragraph-level editing</strong>.  The minimum unit of
text is <dfn>paragraph</dfn> (in this context the contents of a
heading, list item, or table cell is also referred to as “paragraph” 
unless it contains another paragraph).  The Web interface and the
management tools handle text in per-paragraph basis.  Since the
original spec text is frequently updated and paragraphs are frequently
modified or reorganized, handling translated texts in this level seems
better choice than other possibilities (e.g. section-level).</span></li><!--
Though sentense-level might be more robust, sentenses are not marked
up so that clipping a sentense is not a trivial work. -->

<li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="7de89f0111dffba2a49a8e4d0519c873"><span class=en-original lang=en><strong>Automatic synchronization with the original spec
text</strong>.  Translation of an old draft version of the
specification is rather harmful, since readers of the translation
don't check whether the text is up-to-date or not in general and
therefore they would not be even aware that what they read is
out-of-date.  This system is so set up that any change to the original
specification text will be reflected to the translated version within
a day.  If a paragraph that was already translated is then updated in
the original text, the paragraph is taken over by the newer English
version.  It would take a step backward, but is better than leaving
out-of-date translation as is.

</span></ul>

</section>

<section id=ui>
<h2 class="has-ja-translation" data-ja-hash="ad99b1fd46eec1837581f4755c65eb20"><span class=en-original lang=en>How to use Web interface</span><span class=ja-translation lang=ja>Web 界面の使い方</span></h2>

<p class="has-ja-translation" data-ja-hash="e97ff708b42f7b2066f731e4fff90d97"><span class=en-original lang=en>By double-clicking a paragraph that can be translated, or that has
been translated, a editing form is shown as below:</span><span class=ja-translation lang=ja>翻訳できる段落や翻訳された段落をダブルクリックすると、次のような編集フォームが表示されます。</span></p>

<blockquote>

<div class="ja-edit-form" style="position: static"><p class="no-ja-translation" data-ja-hash="4e4ad746435edde3e2ec48ebd9c0292d"><span class=en-original lang=en><label>Original
text:<br><textarea name="en" readonly></textarea></label><br>
(<label><input name="pattern" type="checkbox" disabled>
Pattern</label><span hidden=""> <button type="button">Load original
text</button></span>) </span></p><p class="no-ja-translation" data-ja-hash="5a8e236969837dff4e08d03d228bb2d0"><span class=en-original lang=en><label>Translated text:<br><textarea
name="ja" readonly></textarea></label></span></p><p class="no-ja-translation" data-ja-hash="85eb311e84f6f44a52ca107015da3b40"><span class=en-original lang=en><label>Tags:<br><textarea
name="tags" readonly></textarea></label></span></p><p class="no-ja-translation" data-ja-hash="f553a42859e74d92ae9ae8ab06c46388"><span class=en-original lang=en><button type="button"
class="ja-save-button" disabled>Save and close</button> <button
type="button" class="ja-close-button" disabled>Close</button>
(<output>Load: 200 OK</output>; see also <a
href="edit/#license">license</a>)</span></p></div>

</blockquote>

<dl>

<dt class="has-ja-translation" data-ja-hash="806d4c5a68eba04de1c9b4abccbcb42e"><span class=en-original lang=en>The “Original text” field

</span><span class=ja-translation lang=ja>「Original text」欄</span><dd>

<p class="has-ja-translation" data-ja-hash="c7deb58de67a0cd0446149511ef70ba1"><span class=en-original lang=en>The original English text in the paragraph of the original
document.  It may contain HTML tags and references as in the original
document.  A run of white space characters is considered equivalent to
a space (U+0020) character.  Leading and trailing white space
characters are ignored.

</span><span class=ja-translation lang=ja>元の文書の中の当該段落の英語原文です。
原文中にある HTML のタグや参照を含むことができます。
空白文字列は間隔 (U+0020) 1文字と等価とみなされます。
先頭と末尾の空白文字列は無視されます。</span><dt class="has-ja-translation" data-ja-hash="1f72430d61ae1392d75c942c61237a46"><span class=en-original lang=en>The “Translated text” field

</span><span class=ja-translation lang=ja>「Translated text」欄</span><dd>

<p class="has-ja-translation" data-ja-hash="89d2bbcc9e340b320535ef324766c17e"><span class=en-original lang=en>The translated text for the paragraph.  It may contain HTML tags
and references.

</span><span class=ja-translation lang=ja>当該段落の訳文です。
HTML のタグや参照を含むことができます。</span><div id=rfc2119>

<p class="has-ja-translation" data-ja-hash="5136c42f6dd97bf5e29d10838c6d601e"><span class=en-original lang=en>In addition, you can use special notation for RFC 2119 keywords as:

</span><span class=ja-translation lang=ja>RFC 2119 キーワードのための特別な記法を使うことができます。</span><ul lang=ja>
<li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="b01f2279be43e45041cfa436945bb48c"><span class=en-original lang=en><code>しなければ<mark>[[MUST:</mark>なりません<mark>]]</mark>。</code>
</span><li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="22053077a4175fba779f51b287436457"><span class=en-original lang=en><code>しては<mark>[[MUST NOT:</mark>なりません<mark>]]</mark>。</code>
</span><li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="5cf974d781f2f4aeef189db09f805e73"><span class=en-original lang=en><code><mark>[[REQUIRED:</mark>必須<mark>]]</mark>です。</code>
</span><li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="6c5fa43cb59b32c3ee9bd3a1026bdf4f"><span class=en-original lang=en><code><mark>[[SHOULD:</mark>するべきです<mark>]]</mark>。</code>
</span><li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="c04d3c42d19b1bf9a0c5f30b20b9001a"><span class=en-original lang=en><code><mark>[[SHOULD NOT:</mark>するべきではありません<mark>]]</mark>。</code>
</span><li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="01514a33a5c08fc1f6072ce4b4cc84d6"><span class=en-original lang=en><code>して<mark>[[MAY:</mark>構いません<mark>]]</mark>。</code>
</span></ul>

</div>

<dt class="no-ja-translation" data-ja-hash="0561b477834f8af0cbacab0856517388"><span class=en-original lang=en>The “Pattern” flag

</span><dd>

<p class="no-ja-translation" data-ja-hash="79d5eafe69f077fb0b3375f2cab26c12"><span class=en-original lang=en>If this flag is <em>not</em> set, then the “Original text” is
compared with paragraphs in the original document by exact match
(except for the aforementioned white space normalization).  <em>You
should use exact match (leave the flag unchecked) as far as
possible.</em>

</span><dd>

<p class="no-ja-translation" data-ja-hash="ae401fd03bfee0a8d0953998f6f5da05"><span class=en-original lang=en>If this flag is set, the “Original text” is compared with
paragraphs in the original document by pattern matching rule, where a
<code>*</code> character in the “Original text” matches <em>one</em>
or more characters.  If there are more than one patterns matching the
same paragraph, then only the longest pattern is considered as
matching.  When this flag is set, variables
<code>$<var>d</var></code>, where <var>d</var> is the index of the
<code>*</code> (starting with <code>1</code>) in the “Translated text” 
is replaced by the substring matching the corresponding <code>*</code>
in the pattern.

</span><dt class="no-ja-translation" data-ja-hash="b61103fed8580504ba651610d9ea641d"><span class=en-original lang=en>The “Tags” field

</span><dd>

<p class="no-ja-translation" data-ja-hash="ff14c63397a249f972480615b34b30d8"><span class=en-original lang=en>The tags associated to this paragraph.  One tag can be specified
in a line.  Tags are not used in general; it can be specified for the
convinience of <a href="find?word=tag:example">the paragraph search</a>.
Common tags are:

  </span><dl>
  <dt class="no-ja-translation" data-ja-hash="9ce487cdf412b0c7bd2d41d82d00efb2"><span class=en-original lang=en><code>cell</code></span><dd class="no-ja-translation" data-ja-hash="c53138fcdf024e961d0fee569b14b23c"><span class=en-original lang=en><code>td</code>/<code>th</code> contents.
  </span><dt class="no-ja-translation" data-ja-hash="043f1e18bc503e6f2a53fd641c4bf51e"><span class=en-original lang=en><code>dt</code></span><dd class="no-ja-translation" data-ja-hash="89c00de03430054fcb043d1217b5d363"><span class=en-original lang=en><code>dt</code> contents.
  </span><dt class="no-ja-translation" data-ja-hash="0e6312b546fb3d2f3ac1db337b043fd3"><span class=en-original lang=en><code>headings</code></span><dd class="no-ja-translation" data-ja-hash="2bf92e1af1e5f4643a05df2ce2f2a10f"><span class=en-original lang=en><code>h<var>n</var></code>/<code>caption</code> contents.
  </span><dt class="no-ja-translation" data-ja-hash="8d38c99700dc7469d769c6e6063f7f76"><span class=en-original lang=en><code>item</code></span><dd class="no-ja-translation" data-ja-hash="4069920811232a7a04d00c2afd4b0516"><span class=en-original lang=en><code>li</code> contents other than steps.
  </span><dt class="no-ja-translation" data-ja-hash="fadf0fd3e91ce5e60c9bb5dff1897d16"><span class=en-original lang=en><code>non-normative</code></span><dd class="no-ja-translation" data-ja-hash="4c2e9b4d54174e04cedd7f1bc96ef454"><span class=en-original lang=en>Non-normative contents.
  </span><dt class="no-ja-translation" data-ja-hash="dfe2ead8a97bb989040c290883bb4481"><span class=en-original lang=en><code>step</code></span><dd class="no-ja-translation" data-ja-hash="7b6010c67d690c83a26fcd90c0eb61e4"><span class=en-original lang=en>Steps.
  </span></dl>

<p class="no-ja-translation" data-ja-hash="ee885b53867655146181eed72fb099d5"><span class=en-original lang=en>Any other tags may also be specified.  Tags are case-ensitive.

</span><dt class="no-ja-translation" data-ja-hash="6e77f35fe3d6acd27f4b553a6a53938f"><span class=en-original lang=en>The “Save and close” button

</span><dd>

<p class="no-ja-translation" data-ja-hash="3be88aa32d79c33c69e81286278ce40d"><span class=en-original lang=en>Save changes and close the form.

</span><dt class="no-ja-translation" data-ja-hash="8dd5dd1ba1da16f3f73a1145c96a23a1"><span class=en-original lang=en>The “Close” button

</span><dd>

<p class="no-ja-translation" data-ja-hash="346d2de8ac50f6e4ee7619d971db6cdc"><span class=en-original lang=en>Close the form without saving any change.

</span><dt class="no-ja-translation" data-ja-hash="0462c54488bf595d82f701c939320792"><span class=en-original lang=en>Text next to the buttons

</span><dd>

<p class="no-ja-translation" data-ja-hash="208062400483cb11afaa8743747ab7bd"><span class=en-original lang=en>Progress of transactions is shown here.

</span></dl>

</section>

<section id=guides>
<h2 class="has-ja-translation" data-ja-hash="40f73fd726a51f2c294d2544b2ed6e84"><span class=en-original lang=en>Translation Guidelines</span><span class=ja-translation lang=ja>翻訳指針
</span></h2>

<p class="has-ja-translation" data-ja-hash="a433ff51d7f82e3f3af2a1bf3019d2a1"><span class=en-original lang=en><strong>Use <i lang=ja>desu‐masu</i> style</strong>.

</span><span class=ja-translation lang=ja><strong>ですます調を使います</strong>。</span><p class="no-ja-translation" data-ja-hash="17add160d031b71c3b047430b4dce8df"><span class=en-original lang=en><strong><a href="#rfc2119">Markup RFC 2119 keywords</a></strong>,
otherwise what is requirement and what is not might become unclear.
Note that keywords in non-normative parts (e.g. examples) of the spec
are <em>not</em> RFC 2119 keywords, so don't markup them.

</span><p class="has-ja-translation" data-ja-hash="f432eabc2ec6c47ee3e0da246a517d5d"><span class=en-original lang=en><strong>Avoid <i lang=ja>Katakana</i> words where
possible</strong>.  Don't use <i lang=ja>Katakana</i> words, unless
you are confident in that it is now a common word in Japanese.  If you
have no idea how to translate a technical term, please try to <a
href="http://sciterm.nii.ac.jp/cgi-bin/reference.cgi">check the
practice in other areas</a> or consult at <a href="edit/_notes">the
_notes page</a>.

</span><span class=ja-translation lang=ja><strong>カタカナ語は極力避けます</strong>。日本語文中で既に普通に使われている語以外、
カタカナ語を使わないようにします。専門用語の訳語が思い当たらない時は、<a
href="http://sciterm.nii.ac.jp/cgi-bin/reference.cgi">他分野での用例</a>を調べるか、
<a href="edit/_notes">_notes 頁</a>で相談してください。</span><p class="has-ja-translation" data-ja-hash="fe1a175755c087c2972f1cc022364eff"><span class=en-original lang=en><strong>Append “ー” character</strong> to the <i
lang=ja>Katakana</i> word when the original term ends with ‐ar, ‐er,
or ‐or.  However, avoiding <i lang=ja>Katakana</i> word where
possible is always preferred.

</span><span class=ja-translation lang=ja>原語が ‐ar、‐er、‐or で終わるカタカナ語は、<strong>語尾に「ー」を付けます</strong>。
しかし、カタカナ語の使用は極力避けてください。</span><p class="ed has-ja-translation" data-ja-hash="3f9a02a129cb491583a8021b5ef77b73"><span class=en-original lang=en>More to come...</span><span class=ja-translation lang=ja>適宜追加します。</span></p>

</section>