power source*

news 2006.7.2 : 最新バージョン 0.3 へアップグレードしました。 cf. WP plugin [up]: 目次生成 - Table of Contents Generator を更新

使っているプラグインの紹介。

Table of Contents Generator WordPress plugin

機能概要	記事内の <!--TOC--> を挿入した箇所に、記事内の見出し要素（<Hn>）から自動的に目次を生成して表示してくれる。
バージョン	0.1
作者（web)	Scott Yang さま
配布元	FuCoder.com » Table of Contents Generator WordPress plugin
ドキュメント	同上
適用したWP	WordPress ME 2.0.2 [UTF-8]
注	現行バージョンは、見出しが日本語の場合や markdown 等を使っている場合には正常に動作しない。To-Do に入っているので、今後に期待してます。

↑ これはこのプラグインによって生成された目次です。最後の「メモ」には飛べないかと思います。

Installation

↑ この <h4> の id="toc-installation" も、このプラグインによって自動挿入されたものです。

• 配布元よりダウンロード。
• 解凍した ylsy_toc.php を wp-content/plugins/ ディレクトリにアップロード。
• 有効化。

Usage

• 記事内の目次を付けたい箇所に <!--TOC--> を挿入。
• 各 <hn> タグには id="toc-見出し名" が自動的に付く。
• <!--TOC--> の箇所に ol 形式リストの目次が入る。各見出しのid へリンク。
• 目次は <div class="toc"> で括られるので、様式を整えるには CSS に記述を追加。

メモ

• 「ページ」でも使用可。
• PHP Markdown 等を使っている場合でも、見出しさえ HTML タグで括ってあれば、TOC は生成される。見出しタグから拾って生成するので、このタグがないと拾われない、ということ。
• 日本語見出し対応： 生成されたHTMLソースでは、id 属性は URL エンコードされていたけど、ジャンプはできない。
  • メモ — id 属性の場合
  • メモ — アンカーが name 属性なら、こちらには飛んでくれる。
  • id は使える文字に制限があるんだったっけ？ → 使えるのは、英数字、「-」「_」「:」「.」。先頭は英字。

関連ページ

• WP plugin[up]: 目次生成 - Table of Contents Generator をアップグレード