code 要素型 (HTML, XHTML 1)

[1] code 要素型は、計算機符号コードの素片を示します。

仕様書:

HTML 2
- HTML 2.0 RFC 1866
HTML 4
- IW:HTML4:"struct/text.html#edef-CODE"
XHTML 1.0
- DTD IW:XHTML10:"dtds.html#dtdentry_xhtml1-frameset.dtd_code"
XHTML m12n
- 抽象モジュール IW:XHTML1m12n:"xhtl-modularization.html#s_textmodule"
- DTD 実装 IW:XHTML1m12n:"dtd_module_defs.html#dtdelement_code.qname"

[2]

開始タグ

必須

終了タグ

必須

内容模型 (HTML 2)

(%text;)*

内容模型 (HTML 4)

(%inline;)*

内容模型 (XHTML 1.0)

%Inline;

最小内容模型 (XHTML m12n)

(PCDATA | Inline)*

出現できる文脈 (HTML 2)

%phrase ⊂ %text が出現できる文脈

出現できる文脈 (HTML 4)

%phrase ⊂ %inline が出現できる文脈

出現できる文脈 (ISO-HTML)

%logical.styles ⊂ %text (ISO-HTML) が出現できる文脈

所属内容集合

(InlPhras.class) ⊂ (Inline.class) ⊂ Inline (Inline.mix)

モジュール (XHTML m12n)

Inline Phrasal ⊂ Text

属性

`class`		級	[HTML3.0] %attrs, [HTML4] %coreattr, [ISO-HTML] %core
`dir`		書字方向	[HTML4] %i18n, [ISO-HTML] %i18n
`id`		一意識別子	[HTML3.0] %attrs, [HTML4] %coreattr, [ISO-HTML] %core
`lang`		自然言語	[HTML3.0] %attrs, [HTML4] %i18n, [ISO-HTML] %i18n
`xml:lang`		自然言語	[XHTML1]
`onclick`			[HTML4] %events
`ondblclick`			[HTML4] %events
`onkeydown`			[HTML4] %events
`onkeypress`			[HTML4] %events
`onkeyup`			[HTML4] %events
`onmousedown`			[HTML4] %events
`onmousemove`			[HTML4] %events
`onmouseout`			[HTML4] %events
`onmouseover`			[HTML4] %events
`onmouseup`			[HTML4] %events
`SDAFORM`	`Lit` (固定)		[HTML2]
`style`		スタイル情報	[HTML4] %coreattr
`title`		注釈的題	[HTML4] %coreattr, [ISO-HTML] %core

符号と自然言語

[44] Xユーザーの竹麻呂さん: 「というか、<code>の場合<code lang="">として自然言語との関連付けを切った方が適当という感もあり・・・」 / X, 午後3:00 · 2017年10月19日2017-10-19T06:00:53.000Z, 2024-05-01T07:29:01.000Z https://twitter.com/Takemaro_001/status/920892490118340608
- [45] Xユーザーの竹麻呂さん: 「BCP 47にはzxxとかいう言語タグがあるのか…(No linguistic content)うーむ…」 / X, 午後3:20 · 2017年10月19日2017-10-19T06:20:48.000Z, 2024-05-01T07:29:01.000Z https://twitter.com/Takemaro_001/status/920897501187547136
- [46] Xユーザーの竹麻呂さん: 「というかHTMLの<code>それ自体がコンピュータコードを表現するのだから、その時点で意味論として要素が自然言語の情報を持ってもあまり意味のないものだという気もする」 / X, 午後3:33 · 2017年10月19日2017-10-19T06:33:26.000Z, 2024-05-01T07:29:01.000Z https://twitter.com/Takemaro_001/status/920900681975738368
- [47] Xユーザーの竹麻呂さん: 「あるいは、一般のコンピュータコードについては予約語や識別子名の由来からしてlang="en"でなでしこのコードならlang="ja"みたいにするのが適当?まさか」 / X, 午後3:36 · 2017年10月19日2017-10-19T06:36:14.000Z, 2024-05-01T07:29:01.000Z https://twitter.com/Takemaro_001/status/920901384546828288
- [48] Xユーザーの竹麻呂さん: 「にしたって、<code>に限らずURLとかだって自然言語ではないわけで、うーんこの…」 / X, 午後3:56 · 2017年10月19日2017-10-19T06:56:41.000Z, 2024-05-01T07:29:01.000Z https://twitter.com/Takemaro_001/status/920906531184316416

[49] これは言語とは何か、符号とは何かという哲学的課題で、考え込んだことがある人は多いと思われる(多いか?)。

[50] が、マーク付け言語はあくまで実用目的のものなのだから、あまり深く考えても仕方ないんだよぬ。役に立つようにマークを付けるので、マークを付けるために悩むのは本末転倒なのよぬ。

[51] ただいえることは、符号やプログラミング言語であるからといって、必ずしも自然言語と切り離された独立の存在とは言えないのだ。例えば電話番号は符号だが、自然言語の文脈内で読み書きされる。また、プログラミング言語の識別子に英語を使ったり、日本語を使ったり、コメントを自然言語で書いたりする。

[53] もっと実際的な例を出すなら、日本語話者が読み書きするプログラミング言語のコードは、文字列リテラルやコメントが中華フォントでなく日本語フォントでレンダリングされるように、 lang="ja" が適用されるべきである。

[52] もちろんそれは、逆にすべての符号が自然言語に属するということではないから、 zxx のようなものを使ったり、 lang="" (空文字列) を使ったりした方がいいケースもある。

歴史

`code` の誕生

語句化内容

HTML4 まで

[13] RFC 1866 (HTML 2.0) は、典型的に固定幅のフォントでレンダリングされると述べています。 >>11

[3] HTML 4 仕様書は特に典型的レンダリング例を挙げていません。

[8] 語句化内容も参照。

[17] It was made using the <CODE>EM</CODE> element. (HTML 1.0 I-D, HTML 3.0 I-D より)

[12] >>11 の RFC 1866 (HTML 2.0) の例を参照。

[10]

<p>
  This is text that uses our 
  <code>internal stylesheet</code>.
</p>

出典: http://www.w3.org/TR/2002/REC-xhtml1-20020801/Overview.html#C_14

この例で code にはどういう意味があるのでしょう。よくわかりません。

[30]

<p>Examples in this document that use the namespace prefix "<code>ev</code>" all assume an <code>xmlns</code> declaration <code>xmlns:ev="http://www.w3.org/2001/xml-events"</code> somewhere suitable in the document involved. All examples are informative.</p>

出典: XML Events http://www.w3.org/TR/2003/REC-xml-events-20031014/#s_event_module_elements

[32]

<dt><code class="attribute-name"><a name="DOMStringList-length">length</a></code> of type <code>unsigned long</code>, readonly</dt>

出典: Document Object Model Core http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407/core.html#DOMStringList-length

DOM の仕様書の HTML 版では、定義する属性の名前の部分にこの例のようなマークがなされており、スタイル・シートで背景が黄色に指定されています。同様に定義するメソッドや定数は別の色になっています。 class 属性とスタイル・シートを効果的に利用した例であると言えるでしょう。

この例のように code でマークする内容が実際にどのような種類のコードであるのか class で記述しておくと、スタイル・シートやスクリプトで利用する時に便利です。

[33] SPARQL Protocol for RDF http://www.w3.org/TR/2006/WD-rdf-sparql-protocol-20060125/

この文書ではスタイル・シートによりcode要素に下線を引いています。

[22] 最近の W3C の Note を見ていると、マーク付け文書の素片が code でマークされていたりします。 Texinfo は @code をプログラムに限定していますし、 HTML の仕様書でも半分くらいはプログラムと限定していますけど、マークにも応用するくらいは許されてもよさそうなものです。

同様にプロトコル要素の素片 (たとえば HTTP のメッセージの一部、言語札、媒体型、更に言えば URI参照やファイル名) にも適用するのも良いかもしれませんが、これは議論の余地があるかもしれません。

@code 命令 (GNU Texinfo)

[5] GNU Texinfo の @code 命令は、プログラム片 (構文的字句全体) を示します。 http://www.gnu.org/software/texinfo/manual/texinfo/texinfo.html#code

@code が相応しい例:

プログラムの式
プログラムの変数名
プログラムの関数名
プログラム言語の鍵語
プログラム言語風の言語 (例: Texinfo) の命令

@code が相応しくない例:

シェルの命令名 → @command
シェルのオプション (単独) → @option
シェル命令全体は @code より @samp の方が良いこともある。
環境変数 → @env
構文的字句より小さな単位の文字列片・文字 → @samp
打鍵文字列 → @kbd

使用例:

@code{@@code}
The function returns @code{nil}.

[6] 印刷版ではタイプライター風に出力します。 Info では単引用符で括って出力します。

[7] @command, @option, @env は新しい命令で、以前は @code や @samp が使われていました。

[20] 関連: 語句化内容

code 要素型 (HTML, XHTML 1)

符号と自然言語

歴史

`code` の誕生

HTML4 まで

@code 命令 (GNU Texinfo)

HTML もどき

`c` 要素、 `m` 要素

関連

メモ

code 要素型 (HTML, XHTML 1)

符号と自然言語

歴史

code の誕生

HTML4 まで

@code 命令 (GNU Texinfo)

HTML もどき

c 要素、 m 要素

関連

メモ

`code` の誕生

`c` 要素、 `m` 要素