miau's blog?

TracWiki の箇条書きと連番についてつらつらと

思うところを書いてみます。

実は 前のアイテムに書こうと思って忘れてた→いそいで追加したけどまとまりが悪かった→改めて別アイテムに切り出し という流れだったり。




■箇条書きについて

TracWiki では

* 1 xxx
* 2 xxx
* 2-1 xxx
* 2-2 xxx

みたいな感じで箇条書きができるのですが、「先頭に空白を入れないとダメ」という制限がわかりにくいですよね。あと、いくつ空白を入れるのがいいんだろう?なんて疑問も。

しばらくは
・先頭は 1 スペース
・それ以降は 2 スペース
で記述してたんですけど、最近 DocuWiki を触ったら「先頭は 2 スペース」と決まってまして。今後はそれにあわせてぜんぶ 2 スペースでいこうかなと考えています。まあ参考に。

■連番について

TracWiki では

1.
a.
b.
c.
2.
3.

と書かず、

1.
a.
a.
a.
1.
1.

と書いても、ちゃんと連番を振ってくれます。これもどっちにすべきかたまに迷ってしまいます。

「1. は〜だけど 2. は~」みたいに番号を参照する必要があれば前者、項目の増減が予想される&番号を参照しなそうであれば後者、でやってますけど、なかなか難しいですね。


こういうのはいろんなツールに触れないと何がベストかわかりにくいですね。もっと経験豊富な方の意見を聞きたいところ。


(2010-12-10 追記)

「箇条書きするときに先頭項目は 1 スペース、それ以降は 2 スペースずつ増やす形でインデントする」と書きましたが、その理由を書いていませんでした。

これは TracWysiwygPlugin で自動整形されたときに余計な diff が発生しないようにするためにやっています。

Trac のヘルプも箇条書きは 2 スペースでのインデントになっていますが、「1.」等は 3 スペースのインデントです。これに従わず 2 スペース固定にしているのは上記の理由ということで。

「DokuWiki にあわせて 2 スペースで〜」と書きましたが、なんだかんだでプラグインとの併用が怖いので先頭は 1 スペースで習慣づいてしまっています。
posted at 08:13:14 on 2009-02-06 by miau - Category: Trac No Trackbacks - Permalink

TrackBack

このエントリにトラックバックはありません
現在トラックバックは受け付けていません。

Comments

No comments yet

Add Comments

現在コメントは受け付けていません。
お手数ですが、 こちら のコメント欄にでも記載していただければと思います。