1 |
shindo 11/07/05 12:22:54 |
2 |
|
3 |
Added: gorg.xml |
4 |
Log: |
5 |
new translation |
6 |
|
7 |
Revision Changes Path |
8 |
1.1 xml/htdocs/proj/ja/gdp/doc/gorg.xml |
9 |
|
10 |
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/ja/gdp/doc/gorg.xml?rev=1.1&view=markup |
11 |
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/ja/gdp/doc/gorg.xml?rev=1.1&content-type=text/plain |
12 |
|
13 |
Index: gorg.xml |
14 |
=================================================================== |
15 |
<?xml version='1.0' encoding='UTF-8'?> |
16 |
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
17 |
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/ja/gdp/doc/gorg.xml,v 1.1 2011/07/05 12:22:54 shindo Exp $ --> |
18 |
|
19 |
<guide lang="ja"> |
20 |
<title>Gorgのインストール手順</title> |
21 |
|
22 |
<author title="Author"> |
23 |
<mail link="neysx"/> |
24 |
</author> |
25 |
<author title="Editor"> |
26 |
<mail link="nightmorph"/> |
27 |
</author> |
28 |
<author title="翻訳"> |
29 |
<mail link="横田修作"/> |
30 |
</author> |
31 |
|
32 |
<abstract> |
33 |
このガイドではgorgのインストールと設定の方法についての説明しています。 |
34 |
</abstract> |
35 |
|
36 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
37 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
38 |
<license/> |
39 |
|
40 |
<version>1</version> |
41 |
<date>2010-04-28</date> |
42 |
<!-- Original revision: 1.2 --> |
43 |
|
44 |
<chapter> |
45 |
<title>導入</title> |
46 |
<section> |
47 |
<body> |
48 |
|
49 |
<p> |
50 |
GorgはXMLベースのWebサイトのためのバックエンドXSLTプロセッサです。 |
51 |
XMLソースファイルはオンザフライで変換・出力されます。 |
52 |
出力ファイルやその依存ファイルはキャッシュとして保存されます。 |
53 |
Gorgの主な機能は下記のとおりです。 |
54 |
</p> |
55 |
|
56 |
<ul> |
57 |
<li>apache、lighttpdやwebrick(ruby実装のウェブサーバ)との連携</li> |
58 |
<li>効率的なキャッシュシステム</li> |
59 |
<li>複数のウェブノードで同一のコンテンツを出力した場合でも、矛盾のないHTTPヘッダの生成</li> |
60 |
<li>ウェブサーバの圧縮機能に依らない、自前の圧縮機能(mod_gzipとして知られてる)の実装</li> |
61 |
<li>クライアント側のキャッシングのサポート</li> |
62 |
<li>XSLによるクッキーの受け入れと書き込み</li> |
63 |
<li>検索エンジンの提供(サイトのインデックス作成は次のバージョン以降で実質的な更新を予定しています)</li> |
64 |
</ul> |
65 |
|
66 |
<p> |
67 |
Gorgを利用することで<uri>http://www.gentoo.org</uri>のローカルコピーを提供することができます。 |
68 |
apacheやlighttpdと連携しcgiやfastcgiスクリプトを利用することもできますし、 |
69 |
単体のウェブサーバとして利用することもできます。 |
70 |
Gorgは<b>G</b>entoo.<b>org</b>の略で、 |
71 |
AxKitから置き換えが必要であると感じられたGentooのサイトのために作成されました。 |
72 |
</p> |
73 |
|
74 |
<p> |
75 |
Gorgはx86、amd64、alpha、sparc、ppc、mipsそしてhppa上で以下のパッケージとともにテストされています。 |
76 |
</p> |
77 |
|
78 |
<pre caption="テスト環境"> |
79 |
>=net-www/apache-2.0.55 |
80 |
>=www-apache/mod_fcgid-1.0.8 |
81 |
|
82 |
>=dev-lang/ruby-1.8.4 |
83 |
>=dev-libs/fcgi-2.4.0 |
84 |
>=dev-ruby/ruby-fcgi-0.8.6 |
85 |
>=dev-libs/libxml2-2.6.23 |
86 |
>=dev-libs/libxslt-1.1.15 |
87 |
<comment>(滅多にないことですが、gorgの検索エンジンを調整したい場合)</comment> |
88 |
>=dev-db/mysql-4.0.26 <comment>(5系を含む)</comment> |
89 |
>=dev-ruby/ruby-dbi-0.0.21 |
90 |
>=dev-ruby/mysql-ruby |
91 |
</pre> |
92 |
|
93 |
</body> |
94 |
</section> |
95 |
</chapter> |
96 |
|
97 |
<chapter> |
98 |
<title>Gorgのインストール</title> |
99 |
<section> |
100 |
<body> |
101 |
|
102 |
<p> |
103 |
apacheとの連携、mod_fcgiを利用しないなど利用方法に応じてUSEフラグを定義します。 |
104 |
<c>mysql</c>USEフラグは検索エンジンを調整する場合にだけ必要です。 |
105 |
</p> |
106 |
|
107 |
<impo> |
108 |
アーキテクチャによっては依存関係によりkeywordの指定が必要かもしれません。 |
109 |
その場合は必要なパッケージのkeywordの指定や、異なるアーキテクチャを受け入れることができます。 |
110 |
gorgはx86、amd64、alpha,sparc,ppc,mipsそしてhppaでインストールされ、テストされています。 |
111 |
</impo> |
112 |
|
113 |
<pre caption="gorgのemerge"> |
114 |
<comment>(apacheと<b>連携する</b>する場合)</comment> |
115 |
# <i>echo www-servers/gorg fastcgi apache -mysql >> /etc/portage/package.use</i> |
116 |
|
117 |
<comment>(apacheと<b>連携しない</b>する場合)</comment> |
118 |
# <i>echo www-servers/gorg -fastcgi -apache -mysql >> /etc/portage/package.use</i> |
119 |
|
120 |
<comment>(アーキテクチャによる依存関係があるか確認する場合)</comment> |
121 |
# <i>emerge -pv gorg</i> |
122 |
|
123 |
<comment>(gorgのインストール)</comment> |
124 |
# <i>emerge gorg</i> |
125 |
</pre> |
126 |
|
127 |
</body> |
128 |
</section> |
129 |
</chapter> |
130 |
|
131 |
<chapter> |
132 |
<title>Gorgの設定</title> |
133 |
<section> |
134 |
<title>apacheの設定</title> |
135 |
<body> |
136 |
|
137 |
<note> |
138 |
もしapacheをまったく利用しないなら、この章はとばしてください。 |
139 |
</note> |
140 |
|
141 |
<p> |
142 |
もしfastcgiを利用するなら、<path>/etc/conf.d/apache2</path>の<c>APACHE2_OPTS</c>に<c>-D FCGID</c>を設定する必要があります。 |
143 |
</p> |
144 |
|
145 |
<p> |
146 |
そして、提供されているサンプルファイル<path>/etc/gorg/vhost.sample</path>と、 |
147 |
設定済みのvhost設定のapacheの設定ディレクティブを<path>/etc/apache2/vhost.d/10_gorg.conf</path>のように統合します。 |
148 |
サンプル設定ファイルのコメントで内容は理解できるでしょう。 |
149 |
</p> |
150 |
|
151 |
<p> |
152 |
最後に、(c)cgiスクリプトを<path>/usr/lib/ruby/site_ruby/<ruby-version>/gorg/fcgi-bin/gorg.fcgi</path>と、 |
153 |
<path>/usr/lib/ruby/site_ruby/<ruby-version>/gorg/cgi-bin/{gorg,search}.cgi</path>を、 |
154 |
(f)cgiディレクトリにコピーするかシンボリックリンクを設定し、実行可能か確認してください。 |
155 |
<path>search.cgi</path>は、検索エンジンを統合して利用する場合のみコピーすればよいでしょう。 |
156 |
</p> |
157 |
|
158 |
</body> |
159 |
</section> |
160 |
<section> |
161 |
<title>gorgの設定</title> |
162 |
<body> |
163 |
|
164 |
<p> |
165 |
サンプル設定ファイル<path>/etc/gorg/gorg.conf.sample</path>を<path>/etc/gorg/gorg.conf</path>という名前でコピーし、<b>編集</b>します。 |
166 |
コメントを参考にして、パラメータを決定しましょう。 |
167 |
少なくてもウェブサーバのドキュメントルートを定義することが必要です。 |
168 |
</p> |
169 |
|
170 |
<p> |
171 |
もしデフォルトの<path>/etc/gorg/gorg.conf</path>設定ファイルを利用したくなかったら、環境変数<c>GORG_CONF</c>に設定ファイルのパスを定義する必要があります。 |
172 |
</p> |
173 |
|
174 |
<impo> |
175 |
キャッシュを利用するなら、設定ファイルで定義したキャッシュディレクトリに適切なアクセス権があるか確認することをおすすめします。 |
176 |
もしapacheを利用しているなら、apacheユーザがディレクトリにフルアクセスできる必要があるでしょう。 |
177 |
</impo> |
178 |
|
179 |
</body> |
180 |
</section> |
181 |
<section> |
182 |
<title>不足ファイルの取得</title> |
183 |
<body> |
184 |
|
185 |
<p> |
186 |
CSVのローカルコピーや、そのコピー、またはシンボリックリンクを提供する場合、<path>dyn</path>ディレクトリからファイルをダウンロードする必要があります。 |
187 |
</p> |
188 |
|
189 |
<pre caption="不足ファイルの取得"> |
190 |
<comment>(ドキュメントルートディレクトリに移動)</comment> |
191 |
$ <i>cd /path/to/your/document/root</i> |
192 |
/htdocs $ <i>cd dyn</i> |
193 |
/htdocs $ <i>wget -O news-index.xml http://www.gentoo.org/dyn/news-index.xml?passthru=1</i> |
194 |
/htdocs $ <i>cd ..</i> |
195 |
<comment>(同じようにして/必要なファイルをdynディレクトリから取得する必要があるでしょう)</comment> |
196 |
</pre> |
197 |
|
198 |
<p> |
199 |
ブラウザで画像を表示できるようにする必要があるかもしれません。 |
200 |
<path>images</path>ディレクトリは<path>htdocs</path>の1つ上にあります。 |
201 |
シンボリックリンクをそこに設定するだけで、設定ができます。 |
202 |
</p> |
203 |
|
204 |
<pre caption="画像フォルダへのシンボリックリンクの作成"> |
205 |
/htdocs $ <i>ln -si ../images images</i> |
206 |
|
207 |
<comment>(このような感じになるでしょう)</comment> |
208 |
/htdocs $ <i>ls -l</i> |
209 |
drwxr-xr-x 3 neysx users 128 Sep 14 17:45 css |
210 |
drwxr-xr-x 31 neysx users 744 Oct 26 00:03 doc |
211 |
drwxr-xr-x 3 neysx users 544 Nov 2 16:53 dtd |
212 |
drwxr-xr-x 3 neysx users 168 Nov 3 16:24 dyn |
213 |
-rw-r--r-- 1 neysx users 1406 Jun 7 2003 favicon.ico |
214 |
lrwxrwxrwx 1 neysx users 10 Oct 21 22:29 images -> ../images/ |
215 |
-rw-r--r-- 1 neysx users 190 Nov 9 2002 index.xml |
216 |
drwxr-xr-x 16 neysx users 384 Apr 1 2004 main |
217 |
drwxr-xr-x 17 neysx users 6960 Nov 3 15:34 news |
218 |
drwxr-xr-x 8 neysx users 192 Oct 23 14:52 proj |
219 |
drwxr-xr-x 4 neysx users 96 Sep 17 14:05 security |
220 |
drwxr-xr-x 3 neysx users 736 Nov 2 16:40 xsl |
221 |
</pre> |
222 |
|
223 |
<p> |
224 |
ローカルのCVSにはいくつかのエントリがあるでしょう。 |
225 |
しかし、少なくてもそれらは最新な状態を保つ必要があります。 |
226 |
また、<path>images</path>ディレクトリも最新の状態を保つ必要があります。 |
227 |
</p> |
228 |
|
229 |
</body> |
230 |
</section> |
231 |
</chapter> |
232 |
|
233 |
<chapter> |
234 |
<title>Gorgの起動</title> |
235 |
<section> |
236 |
<title>単体のウェブサーバとして起動</title> |
237 |
<body> |
238 |
|
239 |
<p> |
240 |
gorgを起動する最も簡単な方法は<c>gorg</c>を実行することです。 |
241 |
実行すると以下のようなメッセージが出力されるでしょう。 |
242 |
</p> |
243 |
|
244 |
<pre caption="gorgの実行"> |
245 |
$ <i>gorg</i> |
246 |
|
247 |
Starting the Gorg web server on port 8008 |
248 |
|
249 |
Hit Ctrl-C or type "kill 31479" to stop it |
250 |
</pre> |
251 |
|
252 |
<p> |
253 |
<uri>http://localhost:8008</uri>をブラウザで指定すれば、目的のサイトが見れるはずです。 |
254 |
</p> |
255 |
|
256 |
</body> |
257 |
</section> |
258 |
<section> |
259 |
<title>apacheと連携して起動</title> |
260 |
<body> |
261 |
|
262 |
<p> |
263 |
あなたのワークステーションにインストールしているならば、 |
264 |
apacheを再起動(<c>/etc/init.d/apache2 restart</c>)し、<uri>http://localhost</uri>を表示します。 |
265 |
</p> |
266 |
|
267 |
<p> |
268 |
もしfastcgiサーバを利用している場合、<c>top -u apache</c>でそれらを参照してください。 |
269 |
</p> |
270 |
|
271 |
<p> |
272 |
起動しない場合は単体のウェブサーバとして起動(<c>gorg</c>を実行)してみてください。 |
273 |
もしそれでも起動しない場合は、/etc/gorg/gorg.confを確認して下さい。 |
274 |
単体では起動した場合、apacheの設定とログを確認して下さい。 |
275 |
</p> |
276 |
|
277 |
</body> |
278 |
</section> |
279 |
</chapter> |
280 |
</guide> |