コンテンツにスキップ

テンプレート:TOC row l

提供: Wikisource
テンプレートの解説[表示] [編集] [履歴] [キャッシュを破棄]

使い方

[編集]

これらのテンプレートは、標準化されたテーブル構成を使用して目次（TOC）を作成するための補助テンプレート群です。 テーブルは {{TOC begin}} で開始し、{{TOC end}} で終了します。

これらのテンプレートの目的は、目次の構造を基礎コードから切り離すことにあります。新しい形式の目次を作る必要がある場合は、既存テンプレートを改変するのではなく、新しいテンプレートを作成することを推奨します。

TOC begin

[編集]
パラメーター
  • align：テーブルの配置位置（中央揃えが既定、任意）
  • width：テーブルの幅（任意、任意の CSS 単位で指定）例：| width = 100%
  • max-width：テーブルの最大幅（任意、任意の CSS 単位で指定）例：| max-width = 35em
  • sc：テーブル全体をスモールキャップにする（任意）例：| sc = yes
  • asc：全スモールキャップを適用（任意）例：| asc = yes
  • style：テーブル全体に任意の追加スタイルを適用（任意）例：| style = line-height:1
  • plus：追加コードを付与可能（任意）例：| plus = id {{=}} "example-table" 詳細は mw:Help:Extension:ParserFunctions#Raw_equal_signs を参照
  • caption：テーブルのキャプションを追加

命名規則

[編集]

テンプレート名は、セルの colspan の構成（順序）と、通常でないセルの特徴によって決まります。

例：

  • 3 つの単一セルの行 → {{TOC row 1-1-1}}
  • colspan=2 のセル＋1 つのセル → {{TOC row 2-1}}
  • 特徴を持つセルがある場合、そのセルの「1」は省略：{{TOC row 1-out-1}}

パラメーター

[編集]
  • 位置指定パラメータ 1, 2, ... は各セルの内容を指定します。
  • ほとんどの行テンプレートには省略可能な class パラメータがあり、その行に対して追加のページスタイル用 CSS を適用することができます。
    • クラス wst-toc-aux は、その行を緑色の背景で装飾し、その行がウィキソースによる追加項目（例：原本の目次にはない序文など）であることを示します。

特殊ケース

[編集]
  • {{TOC row l}}：1つのセルで構成し、テキストは左揃え。最初の引数で colspan（列の結合数）を指定し、2番目の引数でセル内の内容を指定します。
  • {{TOC row c}}：1つのセルで構成し、テキストは中央揃え。最初の引数で colspan（列の結合数）を指定し、2番目の引数でセル内の内容を指定します。
  • {{TOC row r}}：1つのセルで構成し、テキストは右揃え。最初の引数で colspan（列の結合数）を指定し、2番目の引数でセル内の内容を指定します。

3列テーブル

[編集]

3列構成は最も一般的です。既定では、最初と最後の列が右寄せ、中央列が左寄せになります。

  • {{TOC row 1-1-1}}：3つの単一セル（右・左・右寄せ）
  • {{TOC row 2-1}}：1つのセルはcolspan=2（2列分結合）で、もう1つは通常のセル。それぞれのセルは、左揃えと右揃えになっています。
インデント関連
  • {{TOC row 1-out-1}}：中列に {{hanging indent}} が適用された3セル構成。
  • {{TOC row 2out-1}}： "2-1"と同様だが、最初のセルにインデントを適用。
  • {{TOC row 1-dot-1}}："1-out-1"と同様だが、中列にドットリーダー（点線）付き。
    • symbol でドットの文字を、spaces で空白数（既定：ドット1つ＋空白5つ）を指定可能。
  • {{TOC row 2dot-1}}："2out-1"と同様だが、最初のセルにもドットリーダー。
主セルの配置変更
  • {{TOC row 1-r-1}}：3つの単一セルで構成されており、それぞれ 左揃え・右揃え・右揃え になっています。
  • {{TOC row 1-c-1}}：3つの単一セルで構成されており、それぞれ 左揃え・中央揃え・右揃え になっています。

例

[編集]
これはキャプションです
Table of Contents: {{TOC row c}}
序章・前文など : {{TOC row 2-1}} 1
1 第1章: {{TOC row 1-1-1}} 2
2 第2章: {{TOC row 1-1-1}} Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. 3
{{TOC row r}} 図版および付録
3 第3章: {{TOC row 1-out-1}} Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. 4
{{TOC row 2out-1}} Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. 5
4
第4章: {{TOC row 1-dot-1}} Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
.  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 6
{{TOC row 2dot-1}} Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
.  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 7

4列テーブル

[編集]

通常の配置では、1列目・2列目・最終列が右揃え、3列目が左揃え になります。3列目は、多くの場合（常にではありませんが）メインの大きなセルとして使われます。

Table of Contents: {{TOC row c}}
Prefatory Notice {{TOC row 3-1}} i
Introduction {{TOC row 2-1-1}} 1
1 a Section 1: {{TOC row 1-1-1-1}} 2
b Section 2: {{TOC row 1-1-1-1}} Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. 3
2 {{TOC row 1-2-1}} Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. 4
3
{{TOC row 1-2dot-1}} Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
.  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 5
3 {{TOC row 1-2out-1}} Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. 5
{{TOC row 3-1}} Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. 6
{{TOC row 3dot-1}} Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
.  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 7
Table of Contents: {{TOC row c}}
{{TOC row 2dot-1-1}} Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
.  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 1 2

不規則な行構成

[編集]

一部の作品では、右側の列の幅が行ごとに異なる目次（TOC）が見られます。その場合、他の行の左側の列が右列と重なって配置されることがあります。こうした形式は、定期刊行物（雑誌など）で連載作品の複数の部分が1行にまとめて掲載されている場合によく見られます。

  • {{TOC row ragged}}：
    • 1：左寄せの主内容
    • 2：右列の内容
    • colspan：このパラメータは、行全体の列結合（colspan）を指定するためのもので、他の行テンプレートと組み合わせて使えるようにするためにあります。既定値は3で、たとえば {{TOC row 1-1-1}} のようなテンプレートと標準で互換性があります。
    • margin：これは、項目の左側からのインデント（字下げ）幅を指定するためのパラメータです。既定値は 2em です。
    • indent：これは、最初の行のぶら下がり（インデントの突き出し）幅を指定するためのパラメータです。既定値は 2em です。
編集者への書簡（New Monthly Magazineについて）
1
グリムの幽霊・第X書簡
38, XI. 199, XII. 365

1つの不揃いの行が複数ページにまたがる場合は、{{TOC row ragged/s}} と {{TOC row ragged/e}} のテンプレートを使用し、ページ番号は {{TOC row ragged/e}} のパラメータ 1 に指定します。 {{TOC row ragged/e}} と {{TOC row ragged/s}} のマージン指定（marginパラメータ）は同じ値にする必要があります。

非常に長いテーブル

[編集]

非常に長い目次では、各行にクラス指定があるとテーブル全体が大きくなりすぎてしまうことがあります。その場合は、クラスを含まない最小限のテンプレートを使用します。 必要に応じて、Template:TOC templates/styles.css に定義されているクラス（例：__toc_row_1-m-1-1 など）を手動で追加してください。 また、他の TOC 行テンプレートによって上書きされる可能性もあります。

これらのテンプレートは TOC row min-[col] という名前で呼ばれます。ここで [col] は列の数を表し、現在は1列から5列までのテンプレートが用意されています

補足コンテンツ

[編集]

底本の目次には、序文などの内容が含まれていない場合があります。このような場合、その部分を作品のメインページ内のどこかにリンクしておく必要があります。これは エクスポート用の処理ツール（英語版）がその項目を検出し、出力に含められるようにするためです。wst-toc-aux クラスを使うことで、任意の行を視覚的にも意味的にも「補足コンテンツ」としてマークできます。また、必要に応じて「これは底本の目次には含まれていない補足項目です」といった説明文を追加することもできます。

例: 補足コンテンツの明示 

{{TOC begin|width=35em}}
|+ CONTENTS
{{TOC row 2-1|class=wst-toc-aux|序文 {{Smaller|(底本の目次には含まれていない)}}}}
{{TOC row 2-1|第1章 | 1}}
{{TOC row 2-1|...}}
{{TOC end}}
}}
CONTENTS
序文 (原本の目次には含まれていない)
第1章 1
...

ページ分割

[編集]

長い目次（TOC）では、表が複数のページにまたがることがあります。このような場合、前のページの最後の行が次のページの最初の行に続いてしまうのを防ぐため、各ページ本文の先頭に {{nop}} を追加する必要があります。また、ページを正しく表示するために、各ページのヘッダーには {{TOC begin}} を置く必要があります。これは Page:名前空間でのレンダリングを正しく行うためです。さらに、最後のページを除くすべてのページのフッターで{{TOC end}} を置いて表を閉じる必要があります。

最初のページ 本文 
{{TOC begin}}
{{TOC row.....}}
フッター 
{{TOC end}}
中間のページ ヘッダー 
{{TOC begin}}
本文 
{{nop}}
{{TOC row.......}}
{{TOC row.......}}
フッター 
{{TOC end}}
最後のページ ヘッダー 
{{TOC begin}}
本文 
{{nop}}
{{TOC row....}}
{{TOC end}}

エクスポート

[編集]

これらのテンプレートはエクスポート時にも正しく動作するよう設計されています

  • これらは連続した1つの表を生成するため、単純なHTMLレンダリング環境でも（例えば{{TOCstyle}} とは異なり）整列が維持されます。
  • CSSは、最小限のスタイルしか持たない表に比べて、ある程度のレスポンシブデザインを可能にするよう設計されています。たとえば
    • 表が狭いページの右端からはみ出さないように、max-width:100%; が適用されています。
    • 縦方向の位置揃え（は、セル内の折り返しが発生しても「中ぶらり」状態を防ぐように設定されています。多くの目次は、デスクトップでは折り返さない場合でも、モバイル端末や電子書籍リーダーでは折り返しが発生することがあります。
    • 「小さい」セルについては、長い数字（例：「1234」や「xxxviii」など）をハイフネーションしようとするエンジンを防ぐため、デフォルトで改行（折り返し）を無効化しています。ただし、一部のデバイスではこの動作が異なる場合もあります。

また、他のドットリーダー系テンプレートと同様に、ドットリーダーはエクスポート時に無効化されます。これは、既知の電子書籍リーダーエンジンのいずれも、ドットリーダーを適切に表示できず、単なる点の並びとして処理してしまうためです。 ただし、それ以外の点では、表は正しくエクスポートされます。

トラッキング

[編集]

以下のカテゴリで問題が検出された使用例を追跡します：

この解説は、テンプレート:TOC templates/docから呼び出されています。 (編集 | 履歴)
編集者は、このテンプレートをサンドボックス (作成 | 複製)とテストケース (作成)で試すことができます。（解説）
このテンプレートのサブページ一覧。
「https://ja.wikisource.org/w/index.php?title=テンプレート:TOC_row_l&oldid=233722」から取得