ページ名は半角英数字に

ページ名や名前空間名は半角英数字のみにすべきか?

DokuWiki自体は、昔から名前空間名やページ名に日本語が使えた。

ただ、以前のDokuWikiは本体もプラグインもテンプレートもマルチバイト文字対応が今以上に不完全で、日本語の名前空間名やページ名を使うと様々なトラブルが発生していた。

たとえば、OrphansWantedプラグイン(リンク切れチェックプラグイン)のような割と人気のプラグインでも、「日本語を含むページ名だと、リンク切れしてなくてもリンク切れと判定する」といった現象が起こった。
よって、「ページ名は、出来る限り半角英数字を使う」のが望ましかった

2009年頃には、これらの問題はかなり解消されている。ただ、

といったことを考えると、名前空間名やページ名は半角英数字に統一した方がよいかも

具体的な進め方

  • ページを新規作成する時は、[[pagename]]、[[namespace:pagename]]というように、名前空間名もページ名も常に半角英数字にする。
  • 「最初の見出しをページ名とする(useheading)」を有効にし、 最初の見出しをきちんと書く 。これにより
    • リンクテキストが分かりやすくなる。
    • 各ページのtitleタグやナビゲーションメニューが分かりやすくなる。
  • リンクテキストがあまりあっていない場合は、[[pagename | ページ名]]のように表題をつける。

(参考→タイトルを変更

表題をあれこれ工夫するよりも、見出しを適切に書く方が楽な事が多いです。

単数形か複数形か

名前空間名やページ名を単数形にするか複数形にするかは、好みです。(参考→単数形か複数形か)。

DokuWiki公式サイトは、以下のようになっています。

  • ページ名は内容によって使い分けている
  • 複数形の名前空間はなるべく作らないようにしてる風に見える

名前空間を何で単数形にしようとするのかは微妙に謎ですが、たぶん「最初の見出しをページ名とする(useheading)」を無効にしているためと思われます。その設定で名前空間に複数形を使うと、ページタイトルに違和感が出やすいし。

 
dokuwiki/tips/highbyte.txt · 最終更新: 2009/04/27 23:01 by admin
 
特に明示されていない限り、本Wikiの内容は次のライセンスに従います:CC Attribution-Noncommercial-Share Alike 3.0 Unported
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki