tt 文書の文法 ( ver.4.2 )

English page

2021/11/25 改訂
2016/07/05 改訂(ver.4.2)
2015/01/21 改訂(ver.4.1)
2014/08/27 改訂(ver.4.0)
2007/10/16 更新
2007/10/02 改訂(ver.3.1)
2007/09/23 改訂(ver.3.0)
2005/07/15 更新

1. 一般規則

• tt 形式のタグは行に付きます。タグは “H1:” のように、タグは行の開始位置から書き始め、“:” で終わります。
  
• 本文はワープロと同様に、改行は改行キーで、段落の区切りは1行以上の空行で示します。
  
• 文章の中に HTML のタグや特殊文字を埋め込めます。従って
  < > &
  は原則として HTML のタグや特殊文字として扱われます。但し “ < ” や “ > ” や “ & ” の両側が空白の場合には特殊文字としての扱いは受けず、ブラウザではそのまま見えます。(その際には両端の空白は削除されます)
  
• タブで始まる行は、そのまま表示されます。プログラムなどを説明するのに適しています。
  
• 文中の URL は原則として自動的にリンクとして処理されます。URL とは
  http://ar.aichi-u.ac.jp/semi/
  のようにインターネットでアドレスを指定する文字列です。自動処理されるのは “http:” で始まる文字列です。 “http” の他、 “https” や “ftp” が使えます。二重引用符で始まる場合にはリンクされません。
  
• “ < ” で始まり “ > ” で終わる行は Ptt の加工を受けません。Ptt の加工を受けるようにするには行頭を空白で始めるとよいでしょう。(Ptt 3.2 の新機能)
  
• HTML の以下のブロックタグの開始タグと閉じタグの間は Ptt の加工を受けません。(Ptt 3.2 の新機能)
  script style pre textarea form select iframe
  

1.1. HTML 属性

属性名="値" 属性名="値" ...

I: cat.jpg width="400"

値は必ず二重引用符で囲みます。どのような属性が指定できるかはタグ毎に異なります。広く使えるのはスタイルを示す style 、配置を示す align、表示幅を示す width です。スタイルシートでクラスが定義されていれば class も使えます。

スタイルに関する情報を HTML 属性で指定するのは可能ならば避けるのが好ましく、一般的な好みはスタイルシートを使用するのが良いでしょう。

2. 表題

H1	H2	H3	H4

目次は表題を基に自動的に作成されます。但し

• 表題が1個の時には作成されません
  
• 作成しないオプションもあります。このオプションは “H1:” のオプションとして与えます
  

2.1. “H1:” のオプション

H1: [-lteqn] 表題

• l オプション: ロゴを表示しない
  
• t オプション: 目次を表示しない
  
• e オプション: 「目次」を「Contents」と表示する。また “ < html > ” の lang 属性を “en” にする。英文のウェブ頁の作成に使用する。
  
• q: 擬似二重引用符 " を “ と ” に変換する。つまり単に "二重引用符" と書くだけで、 “二重引用符” に変換される。このオブションを指定する時には -e オプションも指定して下さい。でないと、大抵のブラウザは奇麗な表示になりません。
  
• n オプション: セクションナンバーを付ける
  

なお、このページは “-eqn” オプションで作成されています。二重引用符の見え方はブラウザとフォントに依存しています。ブラウザで日本語文字フォントが指定されている場合には、“ と ” は(まるで全角文字フォントで代用したかのように)大きな空白が発生する場合があります。(Mac の場合、Safari や Opera は奇麗な二重引用符を表示しますが Camino や Firefox はダメです。それから Windows の場合 IE7.0 の二重引用符はため息が出る程ひどい!)

3. リスト

3.1. リストのタグ

UL:

番号づけないリスト

OL:

番号を付けるリスト

DL:

定義付けリスト

- 項目1
- 項目2
-

DL:
- 名前1
名前1の説明
- 名前2
名前2の説明
-

3.2. リスト項目の終了

3.3. リストの “-a” オブション

-a

UL:-a
- パス1	説明文1
- パス2	説明文2
-

4. 画像

4.1. 一つの画像

I: cat.jpg

パスに続けて表示の大きさを指定することもできます(注)。例えば

I: cat.jpg width=400

画像はセンター配置です。画像に続けて画像の説明を書く事が多いでしょう。その場合には C: タグあるいは CC: タグを使ってセンター配置で説明するとよいでしょう。

一般的な形式は

I: 画像ファイル [表示サイズ] [その他のオプション]

• 画像ファイル名に続く「表示サイズ」は 80% や 640 のように、ウィンドウの横幅に対する割合または絶対的なピクセル値で与えます。指定が無ければそのまま表示します。
  
• 「その他のオプション」では img タグに与える事のできるオプションを HTML 形式による属性の規則で与えます。
  

4.2. 画像配列

II: 終了文字列 [オプション0]
表題1	画像ファイル1 	[オプション1]
表題2	画像ファイル2 	[オプション2]
...
終了文字列

「オプション0」はテーブル全体に関するオプション(テーブル属性)で、実際には

width="90%"

「オプション1」、「オプション2」... はテーブルの個々の要素に対するオプションで、やはり実際には

width="30%"

例えば

II:!
リリー lily.jpg
アイリス iris.jpg
ポーチェラカ portyeraka.jpg
!

リリー	アイリス	ポーチェラカ

理想的には画像の高さで自動調整してくれた方が良いのですが、HTML の仕様のなかにはそれを可能にするものは見当たりません。

クリックすれば別頁に大きく表示される。
なお、この写真のポーチェラカは変わり花である。

画像配列にはテーブルが使用されており、オプションは table の td タグに与える HTML の属性を指定できる。
例えば

II:!
リリー lily.jpg width="30%"
アイリス iris.jpg  width="40%"
ポーチェラカ portyeraka.jpg width="20%"
!

リリー	アイリス	ポーチェラカ

表題に空白文字が含まれる場合には '(引用符) または "(二重引用符) で囲む。

5. テーブル

5.1. 簡単な例

Ta:
名前 年齢 性別
alice 16 女
bob 20 男

この例では、テーブルはマトリックス形で、どのデータにも空白文字が含まれていません。最初の行は、項目の説明欄で太字になっています。各行の最初の項目は、行の説明で、やはり太字で表示されています。

上の例では空白文字がデータを区切っていました。それではデータに空白が含まれる場合にはどのように書けばよいのか。誰でも考える事でしょうが、データを区切る文字(区切り文字)を指定できれば解決できます。区切り文字を “|” として指定するには

Ta: |
名前 | 年齢 | 性別
alice | 16 | 女
bob | 20 | 男

5.2. 形式

Ta: 区切り記号  属性
Ca: テーブルの説明
項目名:書式 	項目名:書式  項目名:書式
行説明  区切り記号	データ  区切り記号 	データ
行説明  区切り記号 	データ  区切り記号 	データ

などで

Ta: align="right"

• HTML属性の指定が省略された場合には
  align="center"
  が使用されます。Ptt 3.1 では表のデザインは全てスタイルシートで行われます。
  
• テーブルの説明( “C:” の行)は省略できます。
  
• テーブルの説明は tt 形式第1版では “Cap:” になっていましたが、ptt でこの旧形式を使うと警告メッセージがでますが正しく処理されます。
  
• データを記述する行は空行で終わります。
  

項目名が全て省略された場合には、その行は表示されません。例えば

Ta: |
 |  |
alice | 16 | 女
bob | 20 | 男

Ta: |
 :- |  |
alice | 16 | 女
bob | 20 | 男

5.3. 項目名の省略

Ta: |
:- | 2000 | | | 2010 | |
   | <b>名前</b> | <b>年齢</b> | <b>性別</b> | <b>名前</b> | <b>年齢</b> | <b>性別</b>
   | <b>alice</b> | 16 | 女 | <b>alice</b> | 26 | 女
   | <b>bob</b> | 20 | 男 | <b>bob</b> | 30 | 男

この表をグローバルな視点で見ると、表の中に表が埋め込まれていると解釈できます。そのような見方からこの表を構成することもできます。後の「長い文字列定義」を参照して下さい。

5.4. 書式

• 項目の書式は省略できます。その場合には、省略された列はセンター配置で、最小限の幅で表示されます。
  
• 表示幅は省略できます。その場合には、その列を表示するのに必要な最小限の幅がとられます。
  
• 表示幅で % が指定されていない場合にはピクセルが単位となります。
  
• 表示幅の数値に、相互に矛盾があった場合には、結果はブラウザに依存すると思われます。
  
• 項目の配置の指定が無い場合には中央配置になります。
  

ここに書いた書式の説明には実はテーブルが使用されており、このテーブルは次のように記述されています。

Ta: | class=noborder width="70%" align="center"
  :<150	| :<70%
項目名: < 表示幅 | データを左寄せで配置します
項目名: > 表示幅 | データを右寄せで配置します
項目名:表示幅 | データを中央に配置します
項目名:-表示幅 | この項目の列は捨てられます(データを隠すのに便利です)

• Ptt 3.0 では border="0" でしたが Ptt3.1 でが指定法が変更されています。
  
• この例のように全ての列で項目名が無く、単に書式部分だけが書かれている場合にはテーブルの最初の行(項目名を書く行)が表示されません。このようなテーブルは、整形の目的で使用されます。
  
• 区切り記号が明示的に与えられているのは “ < ” や “ > ” の両隣に空白が含まれているからです。
  

6. ブロック

6.1. センター配置

C: 文

CC: 終了文字列
文1
文2
...
終了文字列

6.2. プログラムコード

単に preformat の指定です。

プログラムコードを示すには、タブで書き始める方法の他に、

P: 終了文字列 [options]
プログラムの内容
終了文字列

タブサイズはオプションとして指定できます。省略されれば tab=8 が使用されます。
またプログラムの内容が長くなった場合には option では

style="overflow:auto; height:50ex"

例えば次の C のプログラムコードを表示するには

#include <stdio.h>
main(){
	printf("OK\n");
}

P:!
#include <stdio.h>
main(){
	printf("OK\n");
}
!

6.3. 注釈

これは長い注釈の例です。長い注釈の中では

• リスト
  
• テーブル
  
• 画像
  

なども扱えます。例えば次の画像は長い注釈の中で扱われています。

でもこれはまだ新しい機能なので殆どディバッグされていません。

6.3.1. 短い注釈

N: 注釈

6.3.2. 長い注釈

NN: 終了文字列
注釈
終了文字列

注釈は終了文字列またはヘッダによって終了します。

NN:!
<hr>
長い注釈には水平線によって視覚的な効果を持たせることができます。
<hr>
!

6.4. 引用

6.4.1. 短い引用

Q: 引用

6.4.2. 長い引用

QQ: 終了文字列
引用
...
終了文字列

6.5. コメント

6.5.1. 短いコメント

#: コメント

6.5.2. 長いコメント

##: 終了文字列
コメント
終了文字列

6.6. 純粋 HTML モード

!!: nantarakantara
この間の文は純粋な HTML の文書として扱われる
nantarakantara

!!: 終了文字列

Ptt 3.2 では純粋 HTML モードのニーズは殆ど無くなりました。現在では保険的な機能になっています。

7. 文字列定義

7.1. 単純な定義

7.1.1. 短い定義

D: 文字列 定義

D: {	<code>
D: }	</code>

{sample.txt}

<code>sample.txt</code>

7.1.2. 長い定義

DD: 文字列 終了文字列
定義の内容
...
終了文字列

“DD+:” はテーブルの中に複雑な内容、例えばテーブルを書きたい場合などに役に立ちます。

DD+: $1 !
Ta: class=noframe
名前 年齢 性別
alice 16 female
bob   20 male

!

DD+: $2 !
Ta: class=noframe
名前 年齢 性別
alice 26 female
bob   30 male

!

Ta: class=nopad align="center"
:-   2000 2010
-   $1 $2

空行はテーブル記述の終了を表しており、 “DD+:” の中でも必要です。ここで “noframe” と言うのは、外枠の無いテーブルです。この場合には次のようになっています。

これをテーブルに埋め込む場合には、padding されていると、罫線が繋がりません。 “nopad” は padding なしのテーブルのクラスです。 “nopad” も “noframe” もスタイルシートで定義されています。

Ptt 3.1 では、複雑なテーブルの構成を、「テーブル要素の中へのテーブルの埋め込み」によって解決しています。

7.1.3. 定義の取り消し

D: 文字列

DD: 文字列

7.1.4. 考察

<div>
alice
X
bob
</div>

<div>
<p>
alice
<br>X
<br>bob
</p>
</div>

DD+: X !
Q: carol
!

<div>
<p>
alice
<br><blockquote>carol</blockquote>
<br>bob
</p>
</div>

注*: http://www.w3.org/TR/html401/struct/text.html#h-9.3

8. その他

8.1. スタイルシート

In: ファイル

In: style.css

In: /style.css

8.1.1. テーブルのスタイル

<table border="0">

8.2. Body タグの中でのオプション

BO: オプション

<body オプション>

8.3. ラベルと参照

リストの label と ref に相当する Ptt 4.0 の仕様です。

#!/

${
プログラムコード
}$