power source*

記事の目次を自動生成してくれるプラグイン Table of Contents Generator が ver. 0.3 へバージョンアップ！待望の英語以外の見出し対応と、記事本文以外の場所（例えばサイドバー）での目次表示ができるようになりました。
うれしいので早速適用。

Table of Contents Generator WordPress plugin

機能概要	記事内の見出し要素（<hn>）から自動的に目次を生成して表示してくれる。
バージョン	0.3 （2006-06-28 リリース）
作者（web)	Scott Yang さま
配布元	FuCoder.com » Table of Contents Generator WordPress plugin
ドキュメント	同上
「ページ」対応	○
適用したWP	WordPress ME 2.0.3 [UTF-8]
注	現行バージョンは、見出しが markdown 等を用いて書かれている場合は目次を生成できない。見出しが HTML タグで括られていれば OK。

アップグレード手順

プラグインの更新作業は初めて。上書きするだけなら、一旦無効化しなくてもよいのかも？

• 配布元より toc_generator-0.3.zip をダウンロードし、解凍。（または ylsy_toc.php をダウンロード。）
• 一応、管理画面にて旧バージョンを無効化。
• ylsy_toc.php を wp-content/plugins/ ディレクトリへアップロード。
• 管理画面にて有効化。

使い方

• 記事中での目次生成は従来と変更なし。
• 記事本文以外での目次生成
  • テンプレートシンタックス <?php echo $post->post_toc; ?> を使用中のテーマのテンプレートファイルに挿入する。挿入できる位置は、ループ中か、$post が定義済みの位置。

日本語見出しからの目次生成について

• （例） 日本語・英語混在見出しからの目次生成例
• 見出しの id の付けられ方は、次のようになっている模様。
  • 英語のみの見出し（従来どおり） → toc-見出し名
  • 日英混在の見出し → toc-見出し中に含まれる英語
    • 半角スペースはハイフンに変換。（英語のみのときも同様。たぶん従来どおり）
      （例） 見出し「記事の中で php を使いたい」 → toc–php-
    • 見出しから英語を抽出した結果が同じになったら、末尾に1からの数字を追加
  • 日本語のみの見出し → 登場順に、toc-, toc-1, toc-2, …

記事本文以外での目次生成について 追記

一部の「ページ」に目次を追加

• 追加した場所 — サイドバーのない広幅ページ用テンプレート pagewide.php の ページタイトルと本文の間に、<?php echo $post->post_toc; ?> を挿入。
• 今まで 当該ページの本文中に <!--TOC--> を入れていたので、これを削除。
• 使用ページ例
  • WP: テンプレートタグ機能一覧 — h4 見出しのみ
  • WP: リファレンス — h4, h5 見出しあり

生成されたコード

• WP: リファレンス — 本文に h4, h5 見出しがある例

  <div class="toc">
  <ol><li><a href="http://bono.s201.xrea.com/wordpress/wp_references/#toc-">総合・導入・基本機能</a></li>
  <li><a href="http://bono.s201.xrea.com/wordpress/wp_references/#toc-1">プラグイン</a>
  <ol><li><a href="http://bono.s201.xrea.com/wordpress/wp_references/#toc-2">リスト・配布</a></li>
  <li><a href="http://bono.s201.xrea.com/wordpress/wp_references/#toc-3">使い方</a></li>
  <li><a href="http://bono.s201.xrea.com/wordpress/wp_references/#toc-4">作成</a></li></ol></li>
  <li><a href="http://bono.s201.xrea.com/wordpress/wp_references/#toc-5">テーマ</a>
  中略 </li></ol></div>

• Mme. Pierre Oger — 本文に見出しを持たないページの例

  <div class="toc">
  </div>

• 生成コードは、本文中の目次と同じ。
• 「目次：」の文字は CSS で出力させている。

メモ 追記

• Decoder と処理順序が合わないらしく、<!–TOC–> を［dec］ で囲むと、目次が生成された後で実体参照に変換されてしまっている様子。

関連ページ

• WP[TB]: ぼののお勧めプラグイン10選
• WP plugin: 記事の目次を自動生成 - Table of Contents Generator