2009.08.10.

SyntaxHighlighter Evolved を使ってみる

WordPressに便利機能を追加してくれるのがプラグインです。
ちょっと前から使っているのが、ソースコードを見やすくしてくれて行番号もふってくれる「SyntaxHighlighter Evolved」です。
ウェブ上でソースコードを表示するときって、どうやって書くのが正解なのか正直言ってよくわかりません。preタグの中でさらにcode要素としてソースを書くのが一般的なようなので、このサイトでもそれに習っていました。ただソースコード部分は、そのままだとうまく表示されないので、実体参照変換してから貼り付けるとかいろいろと面倒。
そういうのを非常に楽ちんにしてくれるのが、「SyntaxHighlighter Evolved」なわけです。

こんなふうに表示してくれます。

SyntaxHighlighter Evolved のスクリーンショット

SyntaxHighlighter Evolved のスクリーンショット

ステキだ。記入時に実態参照変換も必要ありません。
使い方も簡単。ソースの内容を例えばcssならば、[ css ] cssソース [ /css ] というふうにソース内容に合わせて囲ってあげるだけ。

で、例によってウェブサイトデザインに合わせて外観イメージを少しいじってみます。こんな感じで

<div id="menu">
	<ul>
		<li>Home</li>
		<li>Themes</li>
		<li>About</li>
	</ul>
</div>

「SyntaxHighlighter Evolved」を組み込むと、pluginsフォルダの中のsyntaxhighlighterの中にさらにsyntaxhighlighterがあってその中にstylesフォルダががあります。中には、cssファイルがいろいろはいっています。
今回は、shThemeDefault.cssを元にして改変します。「SyntaxHighlighter Evolved」でDefault設定を使う場合参照しているのは、shCore.cssとshThemeDefault.cssのふたつなので、shThemeDefault.cssの後ろの方にshCore.cssの変更分も合わせて下記のcssを書き加えました。

/*shThemeDefault.css改変部分*/

.syntaxhighlighter
{
	background-color: #e7e5dc !important; /*行番号部分の色*/
}

/* Highlighed line number */
.syntaxhighlighter .line.highlighted .number
{
	background-color: #ffdc40 !important; /*ハイライトしたときの行番号色*/
	color: black !important; /*ハイライトしたときの行番号文字色*/
}

/* Highlighed line */
.syntaxhighlighter .line.highlighted.alt1 .content,
.syntaxhighlighter .line.highlighted.alt2 .content
{
	background-color: #ffdc40 !important; /*ハイライトしたときのコード行色*/
}

/* Add border to the lines */
.syntaxhighlighter .line .content
{
	border-left: 3px solid #fff !important; /*行番号とコードの境界*/
}

/* Second line */
.syntaxhighlighter .line.alt2 .content
{
	background-color: #f6f6f6 !important; /*偶数行の色*/
	border-right: 3px solid #fff !important; /*偶数行の右端にボーダー追加*/
}

.syntaxhighlighter .line .content .block
{
	background: url(wrapping.png) 0 1.5em no-repeat !important; /*改行アイコン 行間調整*/
}

.syntaxhighlighter .toolbar /*ツールバーのバックカラー消去*/
{
	background-color: transparent !important;
	border: none !important;
}

.syntaxhighlighter /*追加項目*/
{
	width: 90% !important;
	overflow: auto !important;
	margin: 18px auto 36px !important;
	border: 1px dotted #959aa1 !important;
}

.syntaxhighlighter:before /*タイトル部分追加*/
{
	display: block !important;
	content: "Source Code";
	color: #6f6e69 !important;
	background-color: #e7e5dc !important;
	height: 20px !important;
	width: auto !important;
	padding-left: 5px !important;
	border-bottom: 3px solid #fff !important;
}

/*shCore.css改変部分*/

.syntaxhighlighter,
.syntaxhighlighter div,
.syntaxhighlighter code,
.syntaxhighlighter span
{
	line-height: 1.5em !important; /*行間調整*/
}

.syntaxhighlighter
{
	padding: 0px !important; /* 外周のpaddingは無し */
}

.syntaxhighlighter .toolbar
{
	padding: 2px 8px 2px 0 !important; /* ツールバー表示調整 */
}

お気に召したら、使ってみてください。

本当は、WordPressサイト管理画面の「SyntaxHighlighter Evolved」設定にある「Additional CSS Class(es)」という項目で、自分で作ったcssを読み込めるのかなと思ったんですが、使い方がよくわかりませんでした。英語のページもあさってみましたが、なにしろ英語は苦手なもんでチンプンカンプン。誰かこの設定の使い方わかった人がいたら、教えてください。
そんなわけで、ここでは単純にshThemeDefault.cssの後ろに書き足したというわけです。

わからないついでに、もうひとつ。
頭のところで「Source Code」と表示するようにしてありますが、できれば「CSS」とか「HTML」とかソースに合わせて表示したいところです。
前のバージョンでは、class名が”html”などとなっていたので、書き分けられましたが「Evolved」ではclass名が”brush: xml;”などとなっています。これってcssであつかうときは、どうしたらいいんだろう?よくわかりません。
「教えて、えらい人!」

詳しい導入方法、使い方などは、下記サイトをご覧になるとわかりやすいと思います。

2009.01.28.

WordPressの解説本

このサイトを作成するときに参考にした書籍を紹介します。

WordPress標準ガイドブック―導入&基本操作からフルチューンまで
マクラケン 直子 WordPress Japan
毎日コミュニケーションズ
売り上げランキング: 68207

WordPressを使ってみようと思って、最初に買った参考書です。WordPressはMovable Typeに比べて、解説本が少ないですが書店でいろいろ見比べながらわかりやすそうだったので購入しました。大正解。導入からカスタマイズまでこれ1冊でほぼ足りてしまうくらいで、説明も丁寧です。
cssをいじったことがあるくらいの人で(私です)少し試してみようかなという場合には最適だと思います。

この本を読みながら(もちろん他にもいろいろ参考にさせていただいた本やサイトはたくさんありますが…)こうかな?どうだろ?と試行錯誤しながら作ったのがこのサイトなわけです。

残念ながら私の手元にあるこの本は、2007年7月発行で対応しているのは古いバージョンです。中身的には問題なく使えると思いますが…
どちらにしても最新版が書籍で出る頃にはWordPressのバージョンもさらに上がっていたりするので、最新情報はネットで追いかけることになりますけどね。

解説本2冊目は、

WordPressサイト構築スタイルブック―デザイナーのためのテンプレートタグリファレンス+サイトデザインテクニック
エ・ビスコム・テック・ラボ
毎日コミュニケーションズ
売り上げランキング: 4061

こちらは、テンプレートタグの解説と、WordPressを使ってブログ以外にウェブサイト(ホームページ)を作成するための解説がたいへん役にたちました。参考例がたくさん載っていてわかりやすいです。この2冊があれば、ひととおり自分でWordPressを導入して自分のオリジナルブログを作るところくらいまで出来ると思います。ただしこれらの本にはcssについての説明は載ってませんので、オリジナルのテーマをデザインするには、別途cssの勉強も必要。

単純に、WordPressでブログをはじめたい人は、「WordPress標準ガイドブック」だけあれば十分じゃないかな。

2009.01.23.

WordPress 2.7 にアップグレード

WordPressのアップグレードってけっこう面倒くさい。バックアップを確認したり、ファイルのあれとこれを入れ替えて、でもこっちとそれは消しちゃダメよとか。
それでついつい先送りしちゃうんだよね。
そうは言っても、古いバージョンを使い続けるわけにもいかない。
どんどん使い勝手も良くなるし、いろんな機能も増えてくる。セキュリティ上も古いままでは問題あるし。
仕事の手も少しあいたので、「エイ、ヤッ」と2.7にアップグレードしました。
WordPress 2.7 の新機能で気になっていたのはこれ

皆さんが自分や友達のブログをアップグレードするのにどれだけうんざりしているかを聞いて、最新版が公開されたら自動的に通知する機能とビルドインアップグレード機能を組み込みました。これで、準備ができたらクリック一つで自動的にファイルをダウンロードし、インストールし、アップグレードすることができるようになりました。

WordPress|日本語 のブログ記事「WordPress 2.7”コルトレーン”」より

2.7ではいろんな新機能があるんだけど、これを読んでアップグレードしなきゃと思いました。次のバージョンからは、簡単にアップグレードできそうだって。

アップグレードの手順は、WordPressのサイトの「WordPress のアップグレード/詳細」に載ってる通り。
まだ、ざっと見まわしただけだけど、ダッシュボードもだいぶ洗練されてきた感じです。

参考サイト

2008.09.12.

WordPressのHTML投稿で困ったこと

WordPress(2.7)の投稿作成画面は、「ビジュアル」と「HTML」の2種類あります。
ごくごく普通の写真と文章で構成されたブログだと「ビジュアル」を使えばほぼ見た目通りに出来上がると思います。ところが、ちょっと複雑な構成にしたいなと思って、「HTML」で書き込んでから確認するために「ビジュアル」画面に移り、もう一度「HTML」に戻ったりしていると、段落やら改行が思わぬところで入って、とんでもないことになってしまいます。
そもそも「HTML」とうたいながらも画面上で改行したり1行あけて書いたりすると、ご親切にも<p>や<br>を自動的に入れてくれる。
せっかく「HTML」といってるんだから、そこまでしてくれなくてもいいのに。特にcodeタグなんか書いていると、全然思ったように表示してくれなくて、</code>の位置が勝手に動いてしまったり、どうしたもんだろうと思ってました。

で、わからないときは即Google。
やっぱり同じように不便を感じていて、しかも対策まで考えてくれてる人がいました。
Masaさんという方が「WordPressのエディタとの付き合い方」という記事を書いています。
WordPressのソースの改造など、この辺になると私にはちんぷんかんぷんですが、wp-includesのdefault-filters.phpをちょいといじるとpタグやbrタグの挿入を完全に停止できるみたいです。書いてあるとおりにやってみました。

具体的には、wp-includesのdefault-filters.phpを開いて、

PHPadd_filter('the_content', 'wpautop');
add_filter('the_excerpt', 'wpautop');

という2箇所を検索して探し出し、頭に「 // 」を書き込んでコメントとして無効化してやる。
こんな感じ

PHP// add_filter('the_content', 'wpautop');
// add_filter('the_excerpt', 'wpautop');

もともとエディタでpタグやbrタグを書込みながら記事を作成して、それを投稿作成画面に貼り付けていたので、この方がやりやすい。感謝、感謝です。

あ、それから管理画面の「ユーザー」タグでユーザー名をクリックし、プロフィールと個人設定画面でビジュアルエディタを使用する、しないを選べます。最初からビジュアルエディタがいらない人は、チェックを外しておけばいいです。

2008.09.05.

applemint

screenshot Theme Name: applemint (BETA) version: 0.01
固定幅、2コラム、ウィジェット対応。

WordPress 用のフリーテーマです。まだ、テストバージョンです。お気づきの点がございましたら、指摘していただけるとありがたいです。
MacのFirefox をメインに、Safari、Opera、WindowsのFirefox、Safari、IE6、IE7 で表示テストをしています。IEに関しては、ほんの少しだけ細かいデザインが変わっていますが、気にならない程度だと思っています。IE5.5 以下および Mac 版 IE は、対象外です。

ヘッダーは、数年前に富良野へ行ったときに写した写真です。ラベンダー以外でもいろんな種類の花畑がたくさんあって、とてもきれいです。とはいえ、アップで撮った写真では、富良野だかどこだかわかりませんね。

2008.08.31.

ivy

screenshot Theme Name: ivy (BETA) version: 0.01
固定幅、3コラム、ウィジェット対応。

WordPress 用のフリーテーマです。まだ、テストバージョンです。お気づきの点がございましたら、指摘していただけるとありがたいです。
MacのFirefox をメインに、Safari、Opera、WindowsのFirefox、Safari、IE6、IE7 で表示テストをしています。IEに関しては、一部透過している影が付かないとか、丸めたコーナーが四角いままなど細かいデザインが変わっていますが、基本的には大きく表示が崩れない程度にはなっています。IE5.5 以下および Mac 版 IE は、対象外です。Safari でもコメント欄で一部表示が崩れているところがあります。

2008.08.09.

「IE7.js」で IE6 でも透過 PNG、疑似クラス :hover に対応

「IE7.js」、「IE8.js」は、IE6 で対応していなかった透過 PNG、疑似クラス :hover、マージン:auto、min-、max-などなどが表示できるようになるという javascript です。
googleコードから直接読み込めるので、「Google Code」のページにある「IE7.js」または「IE8.js」のコードをコピーして<head>内に埋め込むだけ。簡単です。
「IE7.js」は、IE5と6用。「IE8.js」は、IE5から7まで。標準的な XHTM/CSSの 解釈をしてくれるようになるはず。なるはず、というのはまだベータ版だから。
私のサイトでは、ページに少しだけ影を付けていたり、メニュー部分で :hover や min-width を使っていますが、IE6 表示用にそれぞれの要素に対して個別に対応しなければなりませんでした。これらが「IE7.js」を使うだけでまとめて解決できれば、ずいぶん楽ちん。さっそく入れてみたのでした。

「IE7.js」を使った結果。
:hover はうまく動作しています。IE6 でもドロップダウンメニューが動くようになりました。min-width はうまく働きませんでした。透過 PNG 自体はちゃんと表示されますが、リピート表示が出来ない仕様になっていました。影表示の透過 PNG は、縦方向にリピートさせているので意図した形にはなりませんでした。とりあえず、メニュー部分が崩れてしまうと大変読みにくくなるので :hover だけでもありがたいです。
「IE8.js」のほうは、疑似要素の:after、:before にも対応しています。でもその要素をマイナスのマージンを指定して親要素の枠に重ねたり外に出したりの移動が出来なくて、思った形には使えませんでした。この辺は細かいデザインの話なので、今まで通り出来なければ出来ないなりに個別に対応するしかないですね。

とりあえず最小限の対応ということで「IE7.js」を使うことにしました。

2008.08.08.

WordPressのオリジナルテーマを国際化してみる

国際化。なんかかっこいい。
基本形は英語表示で、日本語で使用する場合のみ日本語表示になるようにします。
たとえばサイドバーの各タイトル。英語で見ているときは「Archives」だけど、日本語で見ているときは「アーカイブ」に切り替わって表示されるという具合。ん、単にカタカナにしただけ?
どうせフリーのテーマを作るなら、世界に通用するものをと、志だけは高く掲げます。

そもそも WordPress のファイルの中、wp-content フォルダ > languages フォルダの中に ja.mo と ja.po というファイルが入っていて、この人たちが英語を日本語に翻訳してくれているんですね。
それでテーマの PHP ファイルの中で、_e(‘Archives’)とか、__(‘(more…)’)と書いておくと、「アーカイブ」とか「(続きを読む…)」というふうに翻訳して表示してくれる。WordPress のディフォルトテーマではこの仕組みで日本語表示をしています。
自分でテーマを作るときは、標準的なものは上記 ja.po の中に英文と日本語訳が入っているから、それを見ながら日本語にしたい部分に書いていけばだいたい足りるみたい。
ところがやっぱりこれは、標準的なものしか入ってなくて、たとえば「月別アーカイブ」という語句を使いたくて、 ja.po の中で検索してみても
英文: “A monthly archive of your blog’s posts”
日本語訳: “ブログ投稿の月別アーカイブ”
なんていうのしか出てこない。ちょっと冗長すぎるからもっと簡潔にいきたいよね。

そこで活躍するのが、「Poedit」というソフト。
これは、ja.po を編集して新しい訳文に入れ変えたりした後、翻訳機能の本体である ja.mo を書き出してくれる。
Windows 用の他に、Mac 版も出ているようなので、さっそくMac 用をダウンロードして使ってみた。ところが、私の環境(Mac OS X の10.5.4)では、うまく動いてくれなかった。途中でかたまってしまう。しかたなく、Windows で作業。こちらは大丈夫みたい。

必要なファイル

  • pot ファイル:どのファイルの何行目の語句を訳しますよという、基本ファイル。たいてい訳語の方は空白になっている。
  • ja.po ファイル:編集作業を行うためのファイル。これを Poedit で読み込んで、対訳を編集していく。
  • ja.mo ファイル:Poedit では、ja.po を保存するときに同時に書き出してくれる。これが翻訳機能の本体。オリジナルテーマと同じ場所に置いておくと、翻訳してくれる。

今回は pot ファイルとして、WordPress 日本語ローカルサイトWordPress を翻訳するで翻訳ツールに関して説明してあり通りに、まずは公式 WordPress POT ファイル をダウンロードして使ってみる。

正直言って、Poedit の使い方はいまだによくわかっていない。なんとなく動いてくれてるからいいかというレベル。
詳しい使い方は一番下の参考サイトなど、細かく教えてくれるサイトがいろいろあるので探してみてください。

ここでは、私がやった方法の概略だけ記しておきます。

  1. Poeditを起動。
  2. ファイル > pot ファイルを元に新しいカタログを作成します… でダウンロードした wordpress.pot を選択
  3. プロジェクトの設定
  4. 原文を確認しながら対訳を書き込んでいく
  5. 保存するときに ja.po というファイルにする
  6. ja.po と同時に ja.mo というファイルが書き出される
  7. ja.po と ja.mo ファイルを自分で作ったオリジナルテーマのフォルダの中にアップロード
  8. functions.php の中に「 load_theme_textdomain(‘適当な名前’); 」を書き足す。私は、’ezorisu’ と付けました。
  9. オリジナルテーマの日本語化したい部分を修正
    たとえば、「月別アーカイブ」と表示したい部分に <h2><?php _e(‘Archives by Month’, ‘適当な名前’); ?></h2>
    と書き込む。
    ’適当な名前’のところに functions.php の中に書いたのと同じ名前を付けてやることで、オリジナルテーマフォルダ内の ja.po を読みに行くようにする。
    これを付けないと、もともとあった languages フォルダ内の ja.po を読みに行くことになる。
  10. 完了

で、ここで気が付いた。翻訳数が少ないのなら、最初に読み込んだ pot ファイルを直接編集しちゃった方が早いかも。
今回は、一般的な語句はもともとあった languages フォルダ内の ja.po の翻訳を使い、少し足りないところや、オリジナルの訳語を使いたいところだけ付け足してるだけだし。jp.po を編集して新しい語句を作る方法もよくわからなかった。
それなら pot ファイルをエディタで開いて直接編集したほうが楽。

#: ファイル名. php :行数
msgid “英語の原文”
msgstr “対訳”

と書いていって、不要な部分を消してしまいます。
再度、Poedit で ja.po を開きます。 「カタログ > POT ファイルを元に更新します…」で更新。数が少ないとこっちの方が簡単。

2008.08.03.

WordPressを入れてみる

なにはともあれ、WordPressをダウンロードするところから始まります。

場所は、WordPress 日本語ローカルサイト。最新版をダウンロードしましょう。

ちょっと前までは、日本語版としてWordPressMEという種類があったそうですが、開発元が閉鎖されています。古い情報を読んでると混乱しそうですが、現在はWordPress 日本語ローカルサイトに置いてあるWordPress日本語版が最新のものです。2008年8月現在は、バージョンが2.6になっています。

日本語ローカルサイトの「日本語ドキュメント」をクリックすると、WordPress Codex 日本語版に飛びます。設定や使い方などを解説してくれています。

解説はしてくれてるんだけど、読むとなんだか難しそう。

私の場合は、レンタルサーバーにロリポップを使っていますが、ユーザー専用ページのマニュアルの中にWordPressの設置方法がちゃんと書いてありました。それに従って設定していくと、あっという間に完成。ほんとに5分で終わってしまいます。

お使いのレンタルサーバーに設置方法が書いてないか探してみた方が、早いかもしれません。

参考サイト

2008.08.02.

WordPressを使ってみる

2ヶ月ほど前に初めてWordPressをダウンロードしてみました。

今までは、Movable Typeでブログを作っていました。

個人のブログをデザインする分には、XHTMLやCSSをいじるだけなので、なんてことはないのですが、いざ新しいテーマを作って公開しようかなと思うと、標準仕様に合わせる手間がなかなか面倒くさくて躊躇していました。

そこで目にとまったのが、WordPressです。テーマの導入も簡単そうでしたし、日本の外ではすでにブログツールのスタンダードらしいじゃないですか。

確かに、検索してみるとWordPressのフリーテーマはたくさん公開されているようです。

何よりも個人や商業使用を問わず、「Free」で使えるところが気に入りました。

というわけで、さっそくWordPressで作成したのでがこのサイトです。

テーマファイルは、PHP、CSS、イメージファイルなどで構成されていまが、PHPは初めてでした。こんな時こそインターネットの情報は役に立ちます。WordPressのわかりやすい解説書も出ていますので、やる気があればなんとかなるものです。

一応、私は意匠系の人間なのでテーマをデザインする上で使っているツールとか参考にさせていただいたサイトや書籍など、どうやったらやりたいデザインを実現できるかを中心にこれから書いていきたいなと思っています。

現時点では、このサイトは制作過程の実験的な要素もあり、ころっとデザインが変わったりするかもしれませんが、気にしないでください。

そのうちフリーのテーマもぼちぼち公開していくつもりです。