Wiki 書式をやめて(簡略)HTML で書くようになったら、そのほうがむしろ書きたいように楽に書けることが判って、なんだという気がしている。
さてそうすると内容以外の、文章のスタイルについても気になってきた。それは何もここに書くときだけではない。自分のなかではこれまでの経験からある一定のルールというのが出来ているのだが、重要度 (自分にとっての) に応じてブレるものもある。
そこで文章のスタイルについてのガイドラインについて、検索してみた。Gnome.JP の Wiki を経由して、タイムリーにも出たばかりの What’s Translation@Sun の 日本語スタイルガイド を発見した。元々の Sun 内部の指針(【追記】リンク切れ)を再編されたものということだ。英語から日本語への翻訳を前提に書かれているが、はじめから日本語の文章を書く場合にもよく当てはまる。いったん通読したら普段は クイックリファレンスを見るだけでも随分役に立ちそうだ。何しろ個人や小さなコミュニティではこのような明文化の作業はしない (できない) ので、たいへんありがたい。
自分のなかのルールといくつかの点で違いはある。たとえば感嘆符・疑問符は使わない、としている点。横書きの、特にブログのような場面では既に日本語の一部として使用可能だと思う。さらに、もし使う場合 (メッセージでは使うとされている) には日本語と疑問符のあいだにスペースを入れるとしている点も疑問に思う。そのほか漢字とかなの使い分けのなかにもいくつか自分の基準と違うものがある。
しかしそれらを除いて大部分はたいへん有益な内容である。カタカナ語の末尾の長音は、自分のなかでも場面ごとにブレが大きく気になっていたので、100% 同意できるかどうかは別として、大いに参考になった。元々が技術文書、マニュアルを対象として作られているので、それ以外にそのまま適用できないかもしれないが、参照資料のひとつとして活用したい。
【追記】この記事を書いたときとリンク先が変更になっているので、修正しました。
WP-Dokuwiki をやめてしばらく WP 標準で書いてみようと思っている。
WP-Dokuwiki で便利に思っていたのはソースコードのハイライトと脚注。これに代わるプラグインを探す。それぞれ数種類づつ見つかったが、ちょっとづつ試してみて
iG:Syntax Hiliter プラグインと
Footnotes プラグインを使うことにした。
現在のバージョン v3.5 は、添付のマニュアルを見ると 19 ほどの言語に対応しているとある。が、ふとサブディレクトリの
GeSHi を最新版に入れ替えてみたらどうだろうと思い、やってみると特に問題はなさそうだ
[]。これで 80 ほどの言語に対応する(ほとんどは一度も使わないだろう)。Bash や diff, LaTeX もいけそうだ。
いろいろ探しているうちに “
iG:Syntax Hiliterの不具合(?)を直す” という記事を発見。ここでも何かの拍子に設定がリセットされてしまったことがあったので、これかと思い対策した。
使い方は
WP-Dokuwiki の脚注とほぼ同じで、簡単。ただ出力は、本文の最後に <br /> をつけてそのあとに番号付きリストを生成するようになっているらしい。するとなぜか自動で挿入される </p> がおかしくなり、HTML 的に間違ったことになる。それで
--- footnotes.php.orig
+++ footnotes.php
@@ -98,14 +98,14 @@
if ($footnotes){
$counter = $start_number;
- if ($start_number != 0) $data = $data.'<br /><ol start="'. ($start_number + 1) .'" class="footnotes">';
- else $data = $data.'<br /><ol class="footnotes">';
+ if ($start_number != 0) $data = $data.'<div><ol start="'. ($start_number + 1) .'" class="footnotes">';
+ else $data = $data.'<div><ol class="footnotes">';
foreach($footnotes as $footnote){
$counter++;
$data = $data.'<li id="footnote-'.$counter.'-'.$post->ID.'">'.$footnote.' '.$current_settings['pre_backlink'].'<a href="#footnote-link-'.$counter.'-'.$post->ID.'">'.$current_settings['backlink'].'</a>'.$current_settings['post_backlink'].'</li>';
}
- $data = $data.'</ol>';
+ $data = $data.'</ol></div>';
}
return $data;
}
と、<div> に入れることにした。
見栄えはスタイルシートで設定する。
残るこまごましたことについて。
ブロックの境界
本文や sidebar (という名の実質 bottombar)などで float で段組をしているため、それを解除する
clear:both を入れる必要がある。といって次のブロックの先頭に入れるのも気持ちが悪い。そこでブロックの境界に
<hr> を使い、これに
clear:both をつけることにした。スタイルで
hr {
display: block;
clear: both;
height: 0;
border: none 0px; /* 完全に消すにはこれも必要。 */
visibility: hidden;
}
として見かけ上は消してしまう。
「スタイルシートを使用しない」状態で見ても(といってそんな人はいないと思うが)見通しがよくなった。
page.php
Template Hierarchy に詳しい説明がある。
個別記事(single)と静的ページ(page)はよく似ている(コメントを許すかどうかを除いて)と思うのだが、静的ページで
page.php がない場合に
single.php を探しに行くことはないというのは意外だった。ここではコメントつきページのテンプレートは single と同じとした。
<?php
/*
Template Name: Page with comments
*/
?>
<?php include (TEMPLATEPATH . '/single.php'); ?>
テンプレートが増えるとややこしくなるので、コメントなしページのテンプレート
page.php は作らず、
index.php の中で
is_page() でそれ用の処理をすることにした。
index.php, single.php
ようやく本文について。
個々の記事を、本文とコメントの2段組にした。そもそもこのアイデアを思いつき、そんなテーマを探してみたものの見つからなかったので今回自分で作ってみたのだった。
個別記事の表示(single.php)のときだけでなく、index.php でも各々の記事にトラックバックURLを表示するようにした。こうしているテーマも滅多にない。私の場合 more を使うことはあまりないので、トップページを見るだけで記事全文を見られることになる。わざわざ single に行かなくてもここにトラックバックURLを表示したほうが親切だろうと考えたのだ。
このトラックバックURLは実に長くなり、レイアウトで苦労する
[]。そこで、よく他のサイトで見かけていたフォームの input に入れてある形を思い出した。入力させるところでもないのに何故こんな形にしているのだろうと不思議に思っていたが、ここにきて合点がいった。要するに幅を固定して表示できるのだ。さっそく真似ることにした。
comments.php
フォントは、他の部分では指定するとしても総称名までにしたが、コメントのところだけは遊び心で固有名を指定した。コメントとトラックバックは、順番は分けないが見かけが違うようにした。
Edit Commentsプラグインを使う。WordPress 2.1への対処法がコメントの 300 番にある。
もう一つ、
Subscribe To Commentsプラグインを使うようにした。旧版(2.0.*)は設置がやや面倒だったが新版(2.1)は複数のファイルが一本化されて簡単になっていた。ところで設定で clear:both を制御できるはずなのだが毎回元に戻ってしまい、いまのこのテーマはコメントを含む記事の部分を2段組にしているので非常に具合が悪い。
if ( !$settings['clear_both'] ) {
$settings['clear_both'] = 'clear_both';
$update = true;
}
の個所をコメントアウトして思いどおりになったのだが、他の人は困っていないのだろうか?
[]
メッセージは旧版とほとんど変わっていないので
Subscribe to Comments 日本語化より2.0.4版をいただいて流用する。
いずれも
Tech de Goより。簡にして要を得ている。
WordPressはなまじソースをいじれるので、ついそこに手を入れてしまうが、アップグレードなどがあるので管理が大変になる。そうか、このように前処理・後処理でできることもあるのだ。目から鱗。
footer.php
特に表示しなくてもいいのだろうが “Copyright © 年”を表示することにする。この年のところを、最も古い記事と最新の記事の日付を見て自動的に生成してくれるスクリプトを
Boxy But Goldというテーマの中に見つけたので使うことにした。
sidebar.php
sidebarという名は踏襲するが見かけはbottomで、 3 段組とした。アーカイブの選択には
monthchunksプラグインを使う。
身内の連絡・記録用には MediaWiki が使われていて、その後に Trac を使いはじめてみるとこちらは MoinMoin というのに似た書式で、ここ WordPress では WP-Dokuwiki プラグインで DokuWiki の書式。似て異なるため結局どれを使うときも書き方のページを横に出しておかなければ書けなくなってしまった。何だか余計に不便だ。
一年前に WordPress を使うことになり、Wiki 書式のプラグインを探したらちょうど WP-Dokuwiki が元気そうだったので導入してみたのだが、そのとたんに作者の興味がほかに移ってしまったのか、ぱったり開発が止まってしまった。DokuWiki は他の2つの書式とも随分違っていて、だんだん嫌になってきた。
あらためてまた探してみると WP-MediaWiki プラグインを見つけた。
しかしこの手のものの欠点は、一度導入してそれで書き始めると、やめるわけにはいかなくなるということだ。今後 WP-Dokuwiki で書くことはないとしても、過去の記事をちゃんと整形されて見られるためにはこのプラグインをはずすわけにはいかない。
WP-MediaWiki プラグインはまだ不完全のようだし、しかも昨秋以降は更新がなさそうだし、これまた不安だ。WordPressユーザの数は相当多いだろうに Wiki 書式のプラグインがあまり流行っていないのは、そもそも必要とされていないということなのだろうか。
確かにこのくらいの文章を書くくらいなら、HTML だろうがどの Wiki だろうが、たいしたことはない。WP 標準の、ちょっと HTML 混じりで書いておくのが将来的にもいちばんいいのかもしれない。
WP-MediaWiki もちょっと見てみたけれど、当分は WP-Dokuwiki からも離れて、標準ちょっとHTML混じりで書くことにしてみよう。
