-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathdoc_users_flavour.html
180 lines (178 loc) · 20.9 KB
/
doc_users_flavour.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
<!DOCTYPE html>
<html lang="ja">
<head>
<meta charset="UTF-8">
<meta name="keywords" content="blosxom,日本語,翻訳">
<title>blosxomサイトの日本語訳::フレーバー（Flavour）</title>
<LINK REV="MADE" HREF=" ">
<LINK rel="INDEX" href="index.html">
<link rel="stylesheet" href="style/blosxom.css" type="text/css">
</head>
<body>
<div id="header"><span class="en">blosxom</span>::日本語訳</div>
<table id="frame" cellspacing="0" cellpadding="0" summary="フレーム">
<tbody>
<tr>
<td id="menu">
<h4>翻訳について</h4>
<ul class="mid">
<li><a href="index.html" title="お読みください">お読みください</a></li>
</ul>
<h4 class="en">blosxom</h4>
<ul class="mid">
<li><a href="about.html" title="Blosxomについて"><span class="en">Blosxom</span>について</a></li>
<li><a href="features.html" title="Blosxomの機能">機能</a></li>
<li><a href="colophon.html" title="奥付">奥付</a></li>
<li><a href="http://www.raelity.org/archives/computers/internet/weblogs/blosxom/" title="ニュース">ニュース（英語）</a></li>
<li><a href="http://groups.yahoo.com/group/blosxom/" title="メーリングリスト">メーリングリスト（英語）</a></li>
<li><a href="http://s1.amazon.com/exec/varzea/pay/T3ENE5Z31EQZ0O" title="寄贈">寄贈（英語）</a></li>
</ul>
<h4>ユーザ向けドキュメント</h4>
<ul class="mid">
<li><a href="doc_users_overview.html" title="Blosxomの概要">概要</a></li>
<li><a href="doc_users_install_dynamic.html" title="Blosxomのインストール">インストール</a></li>
<li><a href="doc_users_configure.html" title="Blosxomの設定">環境設定</a></li>
<li><a href="doc_users_blog.html" title="ウェブログ">ウェブログ</a></li>
<li><a href="doc_users_view.html" title="ウェブログの閲覧">閲覧</a></li>
<li><a href="doc_users_flavour.html" title="フレーバー">フレーバー</a></li>
<li><a href="doc_users_syndicate.html" title="シンジケート">シンジケート</a></li>
<li><a href="doc_users_plugins.html" title="プラグイン">プラグイン</a></li>
<li><a href="plugin_registry.html" title="プラグイン登録ページ">プラグイン登録ページ</a></li>
<li><a href="doc_users_configure_static.html" title="静的表示の設定">静的表示の設定</a></li>
<li><a href="faq.html" title="良くある質問"><span class="en">faq</span></a></li>
<li>使用例*</li>
</ul>
<h4>開発者向けドキュメント</h4>
<ul class="mid">
<li><a href="doc_dev_overview.html" title="概要：開発者向け">概要</a></li>
<li><a href="doc_dev_plugins.html" title="プラグイン：開発者向け">プラグイン</a></li>
<li><a href="doc_dev_plugin_register.html" title="開発者向け：プラグイン登録">プラグインの登録</a></li>
</ul>
<h4>ダウンロード</h4>
<ul class="mid">
<li><a href="downloads.html#macosx" title="Macintosh"><span class="en">mac</span></a></li>
<li><span class="en">windows</span>*</li>
<li><a href="downloads.html" title="全ての人へ">全ての人へ</a></li>
<li><a href="license.html" title="ライセンス">ライセンス</a></li>
<li>共同制作*</li>
</ul>
<p>*公式サイトで未執筆</p>
</td>
<td id="contents"><h1><a name="top" class="bl">フレーバー（<span class="be">Flavour</span>）</a></h1><h2>フレーバー</h2><p><span class="en">Blosxom</span>は2つのフレーバーを予め提供しています。基本のデフォルト <span class="en">HTML</span>と<span class="en">XML</span>ベースの<a href="doc_users_syndicate.html">シンジケート</a>のための<span class="en">RSS</span>です。</p><p>私はまた、<span class="en">Blosxom Flavour Sampler</span>（フレーバーのサンプル）を作成しました。幾つかのフレーバーテンプレートで構成されたものです（じきにお話します）。</p><p>標準の<span class="en">HTML</span>は簡単に変更できます。<span class="en">earth-shatteringly</span>な穏やかな白い背景に大きな文字の題名。記事は機能的ですがやはり少し穏やかな感じです：</p><p class="en">
<strong>Typical Post</strong><br>
Your typical <span class="undl">Blosxom</span> post consists of a required title<br>
on the first line and any manner of text and HTML<br>
markup in the body.<br>
<br>
posted at: 11:33 | path: <span class="undl">/</span> | <span class="undl">permanent link to this entry</span>
</p><p>ありがたいことに、再構成するのは非常に単純です。覚えることは2つしかありません：テンプレートコンポーネントとテンプレートファイルです。</p><h3>テンプレートコンポーネント...</h3><p>テンプレートコンポーネントは<span class="en">Blosxom</span>で動的に作成されるコンテンツの要素です。<span class="be">$blog_title</span>は、例えば、<a href="doc_users_configure.html">設定</a>でセットするウェブログのタイトルを入れておくところです。フレーバーテンプレートのどこでも、それが現われると動的に設定した値に置き換わって表示されます。</p><p>テンプレートコンポーネントは2つの種類があります：グローバルとストーリーです。</p><h3><a name="globaltemplatecomponent" class="anc">...グローバルテンプレートコンポーネント</a></h3><p>グローバルコンポーネントはテンプレートファイルのどこでも使用できます。いくつかは<span class="en">Blosxom</span>の<a href="doc_users_configure.html">設定</a>でセットし、他は動的に生成されます。</p><dl>
<dt class="bl"><span class="en">$blog_title</span></dt>
<dd>
<p>ウェブログのタイトルで、<span class="en">Blosxom</span>の設定で指定します。<br>
例 <span class="en">My Blosxom Blog</span></p>
</dd>
<dt class="bl"><span class="en">$blog_description</span></dt>
<dd>
<p>ウェブログの説明で、<span class="en">Blosxom</span>の設定で指定します。<br>
例 <span class="en">A blog about this and that.</span></p>
</dd>
<dt class="bl"><span class="en">$blog_language</span></dt>
<dd>
<p>言語コードで、<span class="en">Blosxom</span>の設定で指定します。<br>
例 <span class="en">en-us</span></p>
</dd>
<dt class="bl"><span class="en">$url</span></dt>
<dd>
<p>ウェブログの<span class="en">URL</span>。<span class="en">Blosxom</span>で自動判別されますが、<span class="en">Blosxom</span>の設定で指定もできます。<br>
例 <span class="en">http://www.example.com/cgi-bin/blosxom.cgi</span></p>
</dd>
<dt class="bl"><span class="en">$path_info</span></dt>
<dd>
<p>最初の<a href="doc_users_view.html">閲覧</a>記事を指定します。パス、日付、それらの組み合わせで指定します。<br>
例 <span class="en">/society/television/retro/1977/</span> </p>
</dd>
<dt class="bl"><span class="en">$flavour</span></dt>
<dd>
<p>使用するフレーバー。<br>
例 <span class="en">http://www.excampe.com/cgi-bin/blosxom.cgi/index.someflavour</span></p>
</dd>
</dl><h3>...ストーリーテンプレートコンポーネント</h3><p>ストーリーコンポーネントは記事（ログ）によって変化します。</p><dl>
<dt class="bl"><span class="en">$title</span></dt>
<dd>
<p>記事のタイトル。<br>
例 <span class="en">Typical Post</span></p>
</dd>
<dt class="bl"><span class="en">$body</span></dt>
<dd>
<p>記事の本文 --ファイルの最初の行以外の全部。<br>
例 <span class="en">Your typical ... in the body.</span> </p>
</dd>
<dt class="bl"><span class="en">$url</span></dt>
<dd>
<p>ウェブログの<span class="en">URL</span>。<span class="en">Blosxom</span>で自動判別されますが、<span class="en">Blosxom</span>の設定で指定もできます。これは実際はグローバルテンプレートコンポーネントですが、記事への<span class="en">permalink</span>を作成するのに便利なのでここでも紹介しました。<br>
例 <span class="en">http://www.example.com/cgi-bin/blosxom.cgi</span></p>
</dd>
<dt class="bl"><span class="en">$path</span></dt>
<dd>
<p>今いるウェブログのディレクトリ/フォルダ階層の中の<a href="doc_users_configure.html">パス</a>。<br>
例 <span class="en">travel/india</span></p>
</dd>
<dt class="bl"><span class="en">$yr, $mo, $mo_num, $da, $hr, $min</span></dt>
<dd>
<p>記事が書かれた日付/時間。左から、年、月 <span class="bl">(</span><span class="be">Jan-Dec</span>)、月 (<span class="be">01-12</span>)、日 (<span class="be">01-31</span>)、時 (<span class="be">00-23</span>)、分 (<span class="be">00-59</span>)。 <br>
例 <span class="en">2002, "Dec", 12, 01, 11, 33</span></p>
</dd>
<dt class="bl"><span class="en">$fn</span></dt>
<dd>
<p>記事のファイル名。拡張子（<span class="be">.txt</span>）は省略します。<br>
例 <span class="en">typical_post</span></p>
</dd>
</dl><p>サンプルの<span class="en">HTML</span>フレーバーに行くと、進むにつれて大小いろいろなことが紹介されます。これらのファイルはまだありません。デフォルトの<span class="en">HTML</span>はビルトインです（<span class="be">blosxom.cgi</span>自体に書かれています）。新しい<span class="en">HTML</span>を作るとこのデフォルトバージョンの代わりに使われます。</p><h3>テンプレートファイル...</h3><p> <span class="en">Blosxom</span>のテンプレートは次のもので構成されています。 </p><p><span class="en">head</span> (記事の前）、<span class="en">foot</span> (記事の後）、<span class="en">story</span> (記事ごとの書式）、<span class="en">content_type</span> (特定のフレーバーのコンテンツタイプ）、<span class="en">date</span>（タイムスタンプの見た目を操作。オプション）。</p><p>これらは次の名前を持つファイルとして存在します：<span class="en">head</span>、<span class="en">foot</span>、<span class="en">story</span>、<span class="en">content_type</span>、<span class="en">date</span></p><p>しかし<span class="en">Blosxom</span>では1つ以上のフレーバーが使えるので何らかの方法で表現しなくてはなりません。<span class="en">HTML</span>フレーバーに関しては次のようにします：<br>
<span class="be">head.html, foot.html, story.html, content_type.html, date.html</span></p><p>簡単でしょう？</p><h3>...ヘッダ</h3><p>ヘッダは記事の前に全て表示されます。<span class="en">HTML</span>フレーバーに対するヘッダは<a href="doc_users_configure.html">データディレクトリ</a>内の<span class="be">head.html</span>と言うファイルになります。</p><p><span class="en">head.html</span>のサンプルです：</p><pre class="en"><html>
<head>
<title>$blog_title</title>
</head>
<body bgcolor="#ffffcc">
<b>$blog_title</b>
<hr size="1" noshade />
<p />
</pre><p>好きなテキストエディタでこの<span class="en">HTML</span>をコピー＆ペーストして<span class="be">datadir/head.html</span>にテキストファイルとして保存して下さい。<span class="be">datadir</span>は<span class="en">Blosxom</span>の<a href="doc_users_configure.html">データディレクトリ</a>です。</p><p><span class="be">$blog_title</span>って何？ <a href="#globaltemplatecomponent">グローバルテンプレートコンポーネント</a>の一つで、このページのずっと上で説明しています。</p><h3>...フッタ</h3><p>ヘッダが記事の前に出現するのとは対照的にフッタは記事の後に出現します。<span class="en">HTML</span>フレーバーに対するフッタは<a href="doc_users_configure.html">データディレクトリ</a>で<span class="be">foot.html</span>と言うファイル名で置きます。</p><p><span class="be">foot.html</span>のサンプルです。水平線と<span class="en">"powered by blosxom"</span>ボタンがあります：</p><pre class="en"><p />
<hr size="1" noshade />
<a href="http://www.blosxom.com/"><img
src="http://www.raelity.org/images/pb_blosxom.gif"
border="0" /></a>
</body>
</html>
</pre><p>テキストエディタでコピー＆ペーストし、<span class="be">datadir/foot.html</span>にテキストファイルとして保存して下さい。</p><p><span class="en">Blosxom</span>ページを再読み込みすると変化に気付くでしょう。</p><p>貴方のページに<span class="en">"powered by blosxom"</span>ボタンを付けなくてはならないとはどこにも書かれていませんが、貴方が<span class="en">Blosxom</span>ユーザであると言うことを知ってもらい、ウェブログを始めたいと思っている人を<span class="en">Blosxom</span>に導くのにも良い方法です。</p><h3>...ストーリー</h3><p>記事の文章の見た目は<a href="doc_users_configure.html">データディレクトリ</a>の<span class="be">story.html</span>と言うテンプレートで決まります。デフォルトのレイアウトをちょっといじてみてストーリーテンプレートコンポーネントを使ってみませんか？</p><pre class="en"><p>
<a name="$fn"><b>$title</b></a>
<br />
$body
</p>
<p align="right">
<i>[<a href="$url$path">$path</a>]
<a href="$url/$yr/$mo_num/$da#$fn">permanent link</a></i>
</p>
</pre><h3>...ストーリー ...<span class="en">permalinks</span></h3><p>パーマネントリンク<span class="en">"permalinks"</span>。 <span class="en">permalink</span>は記事の一つへの参照の際に使われる、決して変更が無い事が約束された恒久的な<span class="en">URL</span>を提供するものです。ウェブログのホームページの下端から記事が落ちてしまった場合 --思い出して下さい、日付順に表示されます-- <span class="en">permalink</span>はリンクがばらばらになった時間とテンプレートに逆らう事を保証するものです。</p><p><span class="en">Blosxom</span>の標準の<span class="en">permalink</span>は日付を基準にしています（上で示しています）。例えば2003年2月1日に<span class="be">a_story.txt</span>として保存した記事は<br>
<span class="be">http://www.example.com/cgi-bin/blosxom.cgi/2003/01/01#a_story</span><span class="bl"><br>
</span>として恒久的にリンクされます。これによってその日付の記事として直接ブラウザでその記事を閲覧できます（<span class="be">#a_story</span>）。これを行うにはテンプレートで次のような感じのものを含めるようにします：<br>
<span class="be"><a href="$url/$yr/$mo_num/$da#$fn">permanent link</a> </span></p><p><a href="doc_users_configure.html">パス</a>を基準にした<span class="en">permalink</span>を望むかも知れません。<span class="be">datadir/fiction</span>に<span class="be">a_story.txt</span>として保存した記事は<br>
<span class="be">http://www.example.com/cgi-bin/blosxom.cgi/fiction#a_story.txt</span><span class="bl"><br>
</span>としてリンクされます。このタイプの<span class="en">permalink</span>はテンプレートで次のような感じにします：<br>
<span class="be"><a href="$url$path/index.$flavour#$fn">permanent link</a> </span></p><p><span class="en">permalink</span>で記事ごとに見た目を変えることもできます。これはパス基準の<span class="en">permalink</span>を修正します：<br>
<span class="be"><a href="$url$path/$fn.$flavour">permanent link</a> </span></p><h3>...<span class="be">content-type</span></h3><p>標準の<span class="en">content-type</span>エンコーディング -- <span class="en">Blosxom</span>がブラウザに出力のタイプを知らせるものです-- はプレーンテキストです（<span class="en">text/plain</span>）。異なるエンコーディング（<span class="be">text/xml</span> や<span class="be">text/html</span>等）のテンプレートを作成したいときはエンコーディングを指定する<span class="be">content_type.flavour</span>ファイル（<span class="be">flavour</span>は貴方の使うフレーバー）を作成しなくてはなりません。</p><p>我々の例では（<span class="en">HTML</span>フレーバー）、<span class="en">content-type</span>は<span class="be">text/html</span>でブラウザには<span class="en">HTML</span>ドキュメントと解釈されます。</p><p>テキストエディタで以下をコピー＆ペーストして<span class="be">datadir/content_type.html</span>にテキストファイルとして保存して下さい。</p><pre class="en">
text/html
</pre><p>例えば、<span class="en">"exemel"</span>と言うウェブログに対して<span class="en">XML</span>フレーバーを作成した時には<span class="en">content-type</span>は<span class="en">text/xml</span>になります。この場合、次の一行を持つ<span class="en">datadir/content_type.exemel</span>ファイルを作成します：</p><pre class="en">
text/xml
</pre><h3>...日付</h3><p>各記事には日付のスタンプがあります。以下は標準の見た目です：</p><pre class="en">
Wednesday, 01 Jan 2003
</pre><p>これが貴方の好みに合うのであれば<span class="be">date.html</span>テンプレートファイルの作成は読み飛ばして構いません。そうでなければ次に進んで日付に関するテンプレートコンポーネントを使って変更します：</p><pre class="en">
$yr, $mo, $mo_num, $da, $hr, $min
</pre><p>もしかすると、斜体の数字を<span class="en">HTML</span>フレーバーで使いたいかも知れません。以下の<span class="en">HTML</span>をテキストエディタでコピー＆ペーストして<span class="be">datadir/date.html</span>と言うテキストファイルで保存して下さい。</p><pre class="en">
<i>$mo_num/$da/$yr</i>
</pre><p>以下のように表示されます：</p><p class="it">01/01/2003</p><p>テンプレートファイルをどこに保存するかとかどのテンプレートコンポーネントを自由に組み合わせてとか知っているのはさておき、これでは空は有限である事に違いありません。<span class="en">CSS</span>、<span class="en">JavaScript</span>、<span class="en">XML</span>、プレーンテキスト...を使ってガツガツいきましょう。貴方のウェブログです。好きなように作りましょう。</p><h3>たくさんのフレーバー...</h3><p>まだわき道に入るわけには行きません。フレーバーに付いて知っておくべきことが他にもちょっとあるのです... たくさんのフレーバー。それは貴方の興味と創造性のみに制限をうけます。 <span class="en">HTML</span>フレーバーと<span class="en">RSS</span>フレーバーは既に"箱"に入っていますが、<span class="be">head.flavour, foot.flavour, story.flavour, content_type.flavour, date.flavour</span>（オプション）と言うファイルを作ればいろいろなフレーバーを使うことができます。このファイルの<span class="en">flavour</span>は貴方の付けたフレーバー名にします。</p><p>古いブラウザのために"西暦1993"フレーバーが欲しい？ <span class="en">HTML</span>フレーバーでやったように<span class="be">head.1993, foot.1993, story.1993</span>ファイルをデータディレクトリに作成しましょう。 ウェブログを"タイトルのみ"にするには題名だけを表示するフレーバーを用意する？ そうです： <span class="be">head.titles, foot.titles, story.titles</span></p><p>特定のフレーバーで閲覧するには<span class="en">Blosxom</span>の<span class="en">URL</span>の最後で<span class="be">index.flavour</span>と指定するか<span class="be">?flav=flavour</span>（<span class="be">flavour</span>はフレーバー名）と指定します。そのため、例えば<span class="en">1993</span>フレーバーの場合は<span class="be">http://localhost/cgi-bin/blosxom.cgi/index.1993</span> か<span class="be">http://localhost/cgi-bin/blosxom.cgi/?flav=1993</span>になります。</p><p>良いのは<span class="en">index.flavour</span>です。<span class="en">?flav=flavour</span>は古いバージョンの<span class="en">Blosxom</span>との互換のために用意されています。</p><p class="nextLink"><a href="doc_users_syndicate.html" class="bl">シンジケート...</a></p><p class="nextLink"><a href="#top">[ページの先頭へ戻る]</a></p></td>
</tr>
</tbody>
</table>
<div id="footer"> </div>
</body>
</html>