initial commit

1 files changed, 166 insertions, 0 deletions

diff --git a/files/ja/web/html/element/samp/index.html b/files/ja/web/html/element/samp/index.html
new file mode 100644
index 0000000000..9f3b50130b
--- /dev/null
+++ b/files/ja/web/html/element/samp/index.html
@@ -0,0 +1,166 @@
+---
+title: '<samp>: サンプル出力要素'
+slug: Web/HTML/Element/samp
+tags:
+  - Element
+  - HTML
+  - HTML text-level semantics
+  - Inline Sample
+  - Reference
+  - Sample Output
+  - Sample Text
+  - Web
+translation_of: Web/HTML/Element/samp
+---
+<div>{{HTMLRef}}</div>
+
+<p><span class="seoSummary"><strong>HTML のサンプル要素</strong> (<strong><code>&lt;samp&gt;</code></strong>) は、コンピュータープログラムからのサンプル出力を表す行内文字列を含めるために使用されます。</span>内容は普通、ブラウザーの既定の等幅フォント（{{interwiki("wikipedia", "en:Courier (typeface)", "Courier")}} や Lucida Console など）を使用して表示されます。</p>
+
+<div>{{EmbedInteractiveExample("pages/tabbed/samp.html", "tabbed-shorter")}}</div>
+
+<p class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</p>
+
+<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>CSS 規則を定義して <code>&lt;samp&gt;</code> 要素におけるブラウザーの既定フォントを上書きすることができますが、ブラウザーの設定が指定した CSS よりも優先されることもあります。</p>
+
+<p>既定のフォントを上書きする CSS は次のようになります。</p>
+
+<pre class="brush: css notranslate">samp {
+  font-family: "Courier";
+}</pre>
+
+<div class="note">
+<p>ウェブサイトや JavaScript コードによって生成された出力を含めるコンテナーとして提供する要素が必要であれば、代わりに {{HTMLElement("output")}} 要素を使用してください。</p>
+</div>
+
+<h2 id="Examples" name="Examples">例</h2>
+
+<h3 id="Basic_example" name="Basic_example">基本的な例</h3>
+
+<p>この単純な例では、段落にプログラムの出力の例を含めます。</p>
+
+<pre class="brush: html notranslate">&lt;p&gt;When the process is complete, the utility will output the text
+&lt;samp&gt;Scan complete. Found &lt;em&gt;N&lt;/em&gt; results.&lt;/samp&gt; You can then
+proceed to the next step.&lt;/p&gt;</pre>
+
+<p>結果の出力は次のようになります。</p>
+
+<p>{{EmbedLiveSample("Basic_example", 650, 100)}}</p>
+
+<h3 id="Sample_output_including_user_input" name="Sample_output_including_user_input">ユーザー入力を含むサンプル出力</h3>
+
+<p><code>&lt;samp&gt;</code> ブロックの中で {{HTMLElement("kbd")}} 要素を使用することで、ユーザーが入力した文字列を含んだ例を表現することができます。例えば、 Linux （または macOS）のコンソールセッションを表現したこのテキストを考えてみてください。</p>
+
+<h4 id="HTML">HTML</h4>
+
+<pre class="brush: html notranslate">&lt;pre&gt;
+&lt;samp&gt;&lt;span class="prompt"&gt;mike@interwebz:~$&lt;/span&gt; &lt;kbd&gt;md5 -s "Hello world"&lt;/kbd&gt;
+MD5 ("Hello world") = 3e25960a79dbc69b674cd4ec67a72c62
+
+&lt;span class="prompt"&gt;mike@interwebz:~$&lt;/span&gt; &lt;span class="cursor"&gt;█&lt;/span&gt;&lt;/samp&gt;&lt;/pre&gt;</pre>
+
+<p>なお、 {{HTMLElement("span")}} を使用して、シェルのプロンプトやカーソルのような、サンプル文字列の中にある特定の部分の表示ができるようにしています。また、 <code>&lt;kbd&gt;</code> を使用して、サンプル文字列の中のプロンプトでユーザーが入力したコマンドを表現しています。</p>
+
+<h4 id="CSS">CSS</h4>
+
+<p>実現したい表示を達成するための CSS は次の通りです。</p>
+
+<pre class="brush: css notranslate">.prompt {
+  color: #b00;
+}
+
+samp &gt; kbd {
+  font-weight: bold;
+}
+
+.cursor {
+  color: #00b;
+}</pre>
+
+<p>これはプロンプトとカーソルにわずかに着色し、サンプル文字列の中のキー入力を太字にしています。</p>
+
+<h4 id="Result" name="Result">結果</h4>
+
+<p>結果の出力は次のようになります。</p>
+
+<p>{{EmbedLiveSample("Sample_output_including_user_input", 650, 120)}}</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', 'semantics.html#the-samp-element', '&lt;samp&gt;')}}</td>
+   <td>{{Spec2('HTML WHATWG')}}</td>
+   <td></td>
+  </tr>
+  <tr>
+   <td>{{SpecName('HTML5 W3C', 'textlevel-semantics.html#the-samp-element', '&lt;samp&gt;')}}</td>
+   <td>{{Spec2('HTML5 W3C')}}</td>
+   <td></td>
+  </tr>
+  <tr>
+   <td>{{SpecName('HTML4.01', 'struct/text.html#h-9.2.1', '&lt;samp&gt;')}}</td>
+   <td>{{Spec2('HTML4.01')}}</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.samp")}}</p>
+
+<h2 id="See_also" name="See_also">関連情報</h2>
+
+<ul>
+ <li>関連要素: {{HTMLElement("kbd")}}, {{HTMLElement("code")}}, {{HTMLElement("pre")}}</li>
+ <li>{{HTMLElement("output")}} 要素: スクリプトが生成した出力のためのコンテナー</li>
+</ul>