e08a94b1c2
(new) -> 1.16 books/fdp-primer/the-website/chapter.sgml Submitted by: TAOKA Fumiyoshi <fmysh at iijmio-mail dot jp> Reference: [doc-jp-work 863]
230 lines
8 KiB
Text
230 lines
8 KiB
Text
<!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved.
|
|
|
|
Redistribution and use in source (SGML DocBook) and 'compiled' forms
|
|
(SGML HTML, PDF, PostScript, RTF and so forth) with or without
|
|
modification, are permitted provided that the following conditions
|
|
are met:
|
|
|
|
1. Redistributions of source code (SGML DocBook) must retain the above
|
|
copyright notice, this list of conditions and the following
|
|
disclaimer as the first lines of this file unmodified.
|
|
|
|
2. Redistributions in compiled form (transformed to other DTDs,
|
|
converted to PDF, PostScript, RTF and other formats) must reproduce
|
|
the above copyright notice, this list of conditions and the
|
|
following disclaimer in the documentation and/or other materials
|
|
provided with the distribution.
|
|
|
|
THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
|
|
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
|
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
|
|
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
|
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
|
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
|
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
|
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
|
|
POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
The FreeBSD Japanese Documentation Project
|
|
|
|
Original Revision: 1.16
|
|
$FreeBSD$
|
|
-->
|
|
|
|
<chapter id="the-website">
|
|
<title>ウェブサイト</title>
|
|
|
|
<sect1 id="the-website-prep">
|
|
<title>準備</title>
|
|
|
|
<para>SGML ツール、CVS ツリーのサブセット、一時的なビルドスペース、
|
|
そしてウェブページをインストールするために、
|
|
200MB の空きディスク容量を用意してください。
|
|
SGML ツールと CVS ツリーがインストール済みならば、
|
|
必要となる空きディスク容量は、およそ 100MB です。</para>
|
|
|
|
<note>
|
|
<para>ドキュメンテーション ports が最新であることを確認してください!
|
|
疑わしければ、ports をインストールする前に、古い ports を
|
|
&man.pkg.delete.1; コマンドを使って削除してください。
|
|
たとえば、<filename role="package">textproc/docproj</filename>
|
|
メタ port は現在 jade-1.2 に依存しているので、
|
|
jade-1.1 をインストールしてあれば、こうしてください</para>
|
|
|
|
<screen>&prompt.root; <userinput>pkg_delete jade-1.1</userinput></screen>
|
|
</note>
|
|
|
|
<para>次に、CVS リポジトリを設置してください。
|
|
CVS ツリーの www, doc, ports ディレクトリが必要です
|
|
(もちろん、これに加えて CVSROOT も)。
|
|
CVS ツリーや CVS ツリーの一部のミラーの仕方については
|
|
<ulink url="../handbook/synching.html#CVSUP">CVSup の紹介</ulink>
|
|
を読んでください。</para>
|
|
|
|
<para>必須の cvsup コレクションは <literal>www</literal>,
|
|
<literal>doc-all</literal>, <literal>cvs-base</literal>,
|
|
<literal>ports-base</literal> です。</para>
|
|
|
|
<para>これらのコレクションを設置するには、約 105MB
|
|
の空きディスク容量を必要とします。</para>
|
|
|
|
<para>なお、CVS ツリー全体 - <literal>src</literal>,
|
|
<literal>doc</literal>, <literal>www</literal>,
|
|
<literal>ports</literal> を含む - は現在 940MB です。</para>
|
|
</sect1>
|
|
|
|
<sect1 id="the-website-build">
|
|
<title>ウェブページを一からビルドする</title>
|
|
|
|
<procedure>
|
|
<step>
|
|
<para>少なくとも 60MB の空き容量のある
|
|
ビルドディレクトリへ行きます。</para>
|
|
|
|
<screen>&prompt.root; <userinput>mkdir /var/tmp/webbuild</userinput>
|
|
&prompt.root; <userinput>cd /var/tmp/webbuild</userinput></screen>
|
|
</step>
|
|
|
|
<step>
|
|
<para>CVS ツリーから SGML ファイルをチェックアウトします。</para>
|
|
|
|
<screen>&prompt.root; <userinput>cvs -R co www doc</userinput></screen>
|
|
</step>
|
|
|
|
<step>
|
|
<para><filename>www</filename> ディレクトリへ入り、
|
|
&man.make.1; <maketarget>links</maketarget> ターゲットを実行し、
|
|
必要なシンボリックリンクを作成します。</para>
|
|
|
|
<screen>&prompt.root; <userinput>cd www</userinput>
|
|
&prompt.root; <userinput>make links</userinput></screen>
|
|
</step>
|
|
|
|
<step>
|
|
<para><filename>en</filename> ディレクトリへ入り、
|
|
&man.make.1; <maketarget>all</maketarget> ターゲットを実行し、
|
|
ウェブページを作成します。</para>
|
|
|
|
<screen>&prompt.root; <userinput>cd en</userinput>
|
|
&prompt.root; <userinput>make all</userinput></screen>
|
|
</step>
|
|
</procedure>
|
|
</sect1>
|
|
|
|
<sect1 id="the-website-install">
|
|
<title>ウェブページをウェブサーバへインストールする</title>
|
|
|
|
<procedure>
|
|
<step>
|
|
<para><filename>en</filename> ディレクトリから出てしまっていたら、
|
|
戻ってください。</para>
|
|
|
|
<screen>&prompt.root; <userinput>cd <replaceable>path</replaceable>/www/en</userinput></screen>
|
|
</step>
|
|
|
|
<step>
|
|
<para><makevar>DESTDIR</makevar> 変数に
|
|
ファイルをインストールしたいディレクトリの名前を設定し、
|
|
&man.make.1; <maketarget>install</maketarget>
|
|
ターゲットを実行します。</para>
|
|
|
|
<screen>&prompt.root; <userinput>make DESTDIR=<replaceable>/usr/local/www</replaceable> install</userinput></screen>
|
|
</step>
|
|
|
|
<step>
|
|
<para>同じディレクトリへウェブページをすでにインストールしてあっても、
|
|
インストールプロセス自体は古かったり取り残されたページを削除しません。
|
|
サイトの新しいコピーを毎日ビルドしインストールしているなら、
|
|
次のコマンドで 3 日間更新されなかったファイルを
|
|
すべて削除できます。</para>
|
|
|
|
<screen>&prompt.root; <userinput>find <replaceable>/usr/local/www</replaceable> -ctime 3 -print0 | xargs -0 rm</userinput></screen>
|
|
</step>
|
|
</procedure>
|
|
</sect1>
|
|
|
|
<sect1 id="the-website-env">
|
|
<title>環境変数</title>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><envar>CVSROOT</envar></term>
|
|
|
|
<listitem>
|
|
<para>CVS ツリーの位置。必須です。</para>
|
|
|
|
<screen><userinput>&prompt.root; CVSROOT=/home/ncvs; export CVSROOT</userinput></screen>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><makevar>ENGLISH_ONLY</makevar></term>
|
|
|
|
<listitem>
|
|
<para>設定され、かつ、空でなければ、
|
|
英語文書だけをビルドしインストールします。
|
|
すべての翻訳は無視されます。例:</para>
|
|
|
|
<screen>&prompt.root; <userinput>make ENGLISH_ONLY=YES all install</userinput></screen>
|
|
|
|
<para><makevar>ENGLISH_ONLY</makevar> 変数を解除して、
|
|
翻訳を含むすべてのページをビルドしたければ、
|
|
変数 <makevar>ENGLISH_ONLY</makevar> に
|
|
空の値を設定してください。</para>
|
|
|
|
<screen>&prompt.root; <userinput>make ENGLISH_ONLY="" all install clean</userinput></screen>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><makevar>WEB_ONLY</makevar></term>
|
|
|
|
<listitem>
|
|
<para>設定され、かつ、値が空でなければ、
|
|
www ディレクトリの HTML
|
|
ページのみをビルドしインストールします。
|
|
doc ディレクトリのすべての文書 (ハンドブック、FAQ, チュートリアル)
|
|
は無視されます。例:</para>
|
|
|
|
<screen>&prompt.root; <userinput>make WEB_ONLY=YES all install</userinput></screen>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><makevar>NOPORTSCVS</makevar></term>
|
|
|
|
<listitem>
|
|
<para>設定されれば、ports CVS リポジトリから
|
|
ファイルをチェックアウトしません。
|
|
代りに、<filename>/usr/ports</filename>
|
|
(または変数 <envar>PORTSBASE</envar> が指す所)
|
|
からファイルをコピーします。</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
|
|
<para><envar>CVSROOT</envar> は環境変数です。
|
|
これはコマンドラインかドットファイル (~/.profile) で
|
|
設定しなければなりません。</para>
|
|
|
|
<para><makevar>WEB_ONLY</makevar>, <makevar>ENGLISH_ONLY</makevar>,
|
|
<makevar>NOPORTSCVS</makevar> はメイクファイル変数です。
|
|
この変数は <filename>/etc/make.conf</filename>
|
|
または <filename>Makefile.inc</filename> 中で、
|
|
あるいは環境変数としてコマンドラインや
|
|
ドットファイルで設定できます。</para>
|
|
</sect1>
|
|
</chapter>
|
|
|
|
<!--
|
|
Local Variables:
|
|
mode: sgml
|
|
sgml-declaration: "../chapter.decl"
|
|
sgml-indent-data: t
|
|
sgml-omittag: nil
|
|
sgml-always-quote-attributes: t
|
|
sgml-parent-document: ("../book.sgml" "part" "chapter")
|
|
End:
|
|
-->
|