Initial translation.

(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]
svn path=/head/; revision=24898
2005-06-16 17:49:17 +00:00 · 2005-06-16 17:49:17 +00:00 · e08a94b1c2 · 2020-12-08 03:00:23 +00:00
commit e08a94b1c2
parent 2abb69d86c
1 changed files with 230 additions and 0 deletions
--- a/ja_JP.eucJP/books/fdp-primer/the-website/chapter.sgml
+++ b/ja_JP.eucJP/books/fdp-primer/the-website/chapter.sgml
@ -0,0 +1,230 @@
+<!-- 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:
+-->