initial commit

1 files changed, 148 insertions, 0 deletions

diff --git a/files/ja/web/html/element/sup/index.html b/files/ja/web/html/element/sup/index.html
new file mode 100644
index 0000000000..e1d70562d5
--- /dev/null
+++ b/files/ja/web/html/element/sup/index.html
@@ -0,0 +1,148 @@
+---
+title: '<sup>: 上付き文字要素'
+slug: Web/HTML/Element/sup
+tags:
+  - Element
+  - HTML
+  - HTML text-level semantics
+  - 'HTML:Flow content'
+  - 'HTML:Palpable Content'
+  - 'HTML:Phrasing content'
+  - Reference
+  - Web
+translation_of: Web/HTML/Element/sup
+---
+<div>{{HTMLRef}}</div>
+
+<p><span class="seoSummary">HTML の <strong>上付き文字要素</strong> (<strong><code>&lt;sup&gt;</code></strong>) は、表記上の理由で上付き文字として表示するべき行内文字列を指定します。</span>上付き文字は普通、小さめのテキストを使用して高いベースラインで表示されます。</p>
+
+<div>{{EmbedInteractiveExample("pages/tabbed/sup.html", "tabbed-shorter")}}</div>
+
+<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div>
+
+<table class="properties">
+ <tbody>
+  <tr>
+   <th scope="row"><a href="/ja/docs/Web/HTML/Content_categories">コンテンツカテゴリ</a></th>
+   <td><a href="/ja/docs/Web/HTML/Content_categories#Flow_content">フローコンテンツ</a>, <a href="/ja/docs/Web/HTML/Content_categories#Phrasing_content">記述コンテンツ</a>, 知覚可能コンテンツ</td>
+  </tr>
+  <tr>
+   <th scope="row">許可されている内容</th>
+   <td><a href="/ja/docs/Web/HTML/Content_categories#Phrasing_content">記述コンテンツ</a></td>
+  </tr>
+  <tr>
+   <th scope="row">タグの省略</th>
+   <td>{{no_tag_omission}}</td>
+  </tr>
+  <tr>
+   <th scope="row">許可されている親要素</th>
+   <td><a href="/ja/docs/Web/HTML/Content_categories#Phrasing_content">記述コンテンツ</a>を受け入れるすべての要素</td>
+  </tr>
+  <tr>
+   <th scope="row">暗黙の ARIA ロール</th>
+   <td><a href="https://www.w3.org/TR/html-aria/#dfn-no-corresponding-role">対応するロールなし</a></td>
+  </tr>
+  <tr>
+   <th scope="row">許可されている ARIA ロール</th>
+   <td>すべて</td>
+  </tr>
+  <tr>
+   <th scope="row">DOM インターフェイス</th>
+   <td>{{domxref("HTMLElement")}}</td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="Attributes" name="Attributes">属性</h2>
+
+<p>この要素には<a href="/ja/docs/Web/HTML/Global_attributes">グローバル属性</a>のみがあります。</p>
+
+<h2 id="Usage_notes" name="Usage_notes">使用上のメモ</h2>
+
+<p><code>&lt;sup&gt;</code> 要素は、単純に表現や表示の結果を得るためではなく、表記規則上の理由、つまり、表記上の習慣や規則でテキストの位置を変更する必要がある場合にのみ使用してください。</p>
+
+<p>例えば、高いベースラインを使用しているビジネスや製品の{{interwiki("wikipedia", "ワードマーク")}}をスタイル付けするには、 <code>&lt;sup&gt;</code> ではなく CSS を使用してください (例えば {{cssxref("vertical-align")}})。例えば、 <code>vertical-align: super</code> とするか、ベースラインを50%上げるのであれば、 <code>vertical-align: 50%</code> とするかしてください。</p>
+
+<p><code>&lt;sup&gt;</code> の適切な使用例には次のようなものがあります (但し、制約するものではありません)。</p>
+
+<ul>
+ <li>べき乗の表示、例えば "x<sup>3</sup>"。これには、特に複雑な場合には、 <a href="/ja/docs/Web/MathML">MathML</a> の使用を検討する価値があるかもしれません。以下の{{anch("Examples", "例")}}の{{anch("Exponents", "べき乗")}}を参照してください</li>
+ <li>一部の言語で特定の略語を表示する際の {{interwiki("wikipedia", "superior letter", "superior lettering")}}。例えば、フランス語では、 "mademoiselle" は "M<sup>lle</sup>" のように略すことができます。例は {{anch("Superior lettering")}} を参照してください。</li>
+ <li>序数の表現、たとえば "fourth." を "4<sup>th</sup>" と表現すること。例は {{anch("Ordinal numbers")}} を参照してください。</li>
+</ul>
+
+<h2 id="Examples" name="Examples">例</h2>
+
+<h3 id="Exponents" name="Exponents">べき乗</h3>
+
+<p>以下のようにべき乗は、上付き文字のもっとも一般的な使い方です。</p>
+
+<pre class="brush: html notranslate">&lt;p&gt;物理学の中でもっとも有名な等式の一つが、
+&lt;var&gt;E&lt;/var&gt;=&lt;var&gt;m&lt;/var&gt;&lt;var&gt;c&lt;/var&gt;&lt;sup&gt;2&lt;/sup&gt;.&lt;p&gt;</pre>
+
+<p>結果の出力は次のようになります。</p>
+
+<p>{{EmbedLiveSample("Exponents", 650, 80)}}</p>
+
+<h3 id="Superior_lettering" name="Superior_lettering">Superior lettering</h3>
+
+<p>Superior lettering は、厳密には上付き文字と同じではありません。しかし、 HTML で superior lettering を表現することは <code>&lt;sup&gt;</code> の一般的な利用方法です。最も多い superior lettering の使用例はフランス語の略語の表現です。</p>
+
+<pre class="brush: html notranslate">&lt;p&gt;Robert a présenté son rapport à M&lt;sup&gt;lle&lt;/sup&gt; Bernard.&lt;/p&gt;</pre>
+
+<p>結果の出力は次の通りです。</p>
+
+<p>{{EmbedLiveSample("Superior_lettering", 650, 80)}}</p>
+
+<h3 id="Ordinal_numbers" name="Ordinal_numbers">序数</h3>
+
+<p>英語の "fourth" やスペイン語の "quinto" などの序数は、数字と上付き文字で表示される言語に依存したテキストを使用して略されることがあります。</p>
+
+<pre class="brush: html notranslate">&lt;p&gt;The ordinal number "fifth" can be abbreviated in various
+languages as follows:&lt;/p&gt;
+&lt;ul&gt;
+  &lt;li&gt;English: 5&lt;sup&gt;th&lt;/sup&gt;&lt;/li&gt;
+  &lt;li&gt;French: 5&lt;sup&gt;ème&lt;/sup&gt;&lt;/li&gt;
+&lt;/ul&gt;</pre>
+
+<p>出力は以下の通りです。</p>
+
+<p>{{EmbedLiveSample("Ordinal_numbers", 650, 160)}}</p>
+
+<h2 id="Specifications" name="Specifications">仕様書</h2>
+
+<table class="standard-table">
+ <thead>
+  <tr>
+   <th scope="col">仕様書</th>
+   <th scope="col">状態</th>
+   <th scope="col">備考</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <td>{{SpecName('HTML WHATWG', 'text-level-semantics.html#the-sub-and-sup-elements', '&lt;sub&gt; and &lt;sup&gt;')}}</td>
+   <td>{{Spec2('HTML WHATWG')}}</td>
+   <td></td>
+  </tr>
+  <tr>
+   <td>{{SpecName('HTML5 W3C', 'textlevel-semantics.html#the-sub-and-sup-elements', '&lt;sub&gt; and &lt;sup&gt;;')}}</td>
+   <td>{{Spec2('HTML5 W3C')}}</td>
+   <td></td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>
+
+<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div>
+
+<p>{{Compat("html.elements.sup")}}</p>
+
+<h2 id="See_also" name="See_also">関連情報</h2>
+
+<ul>
+ <li>下付き文字を表現する HTML の {{HTMLElement("sub")}} 要素。sup 要素と同時に使用することはできません。化学式で上付き文字と下付き文字の両方が必要な場合には、<a href="/ja/docs/MathML">MathML</a> を用いる必要があります。</li>
+ <li>MathML 要素: <a href="/ja/docs/Web/MathML/Element/msub"><code>&lt;msub&gt;</code></a>, <a href="/ja/docs/Web/MathML/Element/msup"><code>&lt;msup&gt;</code></a>, <a href="/ja/docs/Web/MathML/Element/msubsup"><code>&lt;msubsup&gt;</code></a></li>
+ <li>CSS の {{cssxref("vertical-align")}} プロパティ</li>
+</ul>