From owner-svn-doc-head@freebsd.org Thu Sep 3 11:01:10 2015 Return-Path: <owner-svn-doc-head@freebsd.org> Delivered-To: svn-doc-head@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id BAF3D9C94B3; Thu, 3 Sep 2015 11:01:10 +0000 (UTC) (envelope-from ryusuke@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 9F4358A1; Thu, 3 Sep 2015 11:01:10 +0000 (UTC) (envelope-from ryusuke@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.70]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id t83B1ARn097352; Thu, 3 Sep 2015 11:01:10 GMT (envelope-from ryusuke@FreeBSD.org) Received: (from ryusuke@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id t83B1A3O097351; Thu, 3 Sep 2015 11:01:10 GMT (envelope-from ryusuke@FreeBSD.org) Message-Id: <201509031101.t83B1A3O097351@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: ryusuke set sender to ryusuke@FreeBSD.org using -f From: Ryusuke SUZUKI <ryusuke@FreeBSD.org> Date: Thu, 3 Sep 2015 11:01:10 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r47353 - head/ja_JP.eucJP/books/handbook/mirrors X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: SVN commit messages for the doc tree for head <svn-doc-head.freebsd.org> List-Unsubscribe: <https://lists.freebsd.org/mailman/options/svn-doc-head>, <mailto:svn-doc-head-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/svn-doc-head/> List-Post: <mailto:svn-doc-head@freebsd.org> List-Help: <mailto:svn-doc-head-request@freebsd.org?subject=help> List-Subscribe: <https://lists.freebsd.org/mailman/listinfo/svn-doc-head>, <mailto:svn-doc-head-request@freebsd.org?subject=subscribe> X-List-Received-Date: Thu, 03 Sep 2015 11:01:10 -0000 Author: ryusuke Date: Thu Sep 3 11:01:09 2015 New Revision: 47353 URL: https://svnweb.freebsd.org/changeset/doc/47353 Log: - Merge the following from the English version: r47312 -> r47330 head/ja_JP.eucJP/books/handbook/mirrors/chapter.xml Modified: head/ja_JP.eucJP/books/handbook/mirrors/chapter.xml Modified: head/ja_JP.eucJP/books/handbook/mirrors/chapter.xml ============================================================================== --- head/ja_JP.eucJP/books/handbook/mirrors/chapter.xml Thu Sep 3 00:10:34 2015 (r47352) +++ head/ja_JP.eucJP/books/handbook/mirrors/chapter.xml Thu Sep 3 11:01:09 2015 (r47353) @@ -3,7 +3,7 @@ The FreeBSD Documentation Project The FreeBSD Japanese Documentation Project - Original revision: r47312 + Original revision: r47330 $FreeBSD$ --> <appendix xmlns="http://docbook.org/ns/docbook" @@ -112,14 +112,14 @@ This site doesn't have any products newe これは、プロジェクトクラスタの管理者により運用されている数多くのコンピュータから構成されています。 また、GeoDNS により、近くの利用可能なミラーをユーザに提供します。</para> - <para>さらに、&os; は以下のミラーサイトから anonymous <acronym>FTP</acronym> - によって入手できます。もし &os; を anonymous <acronym>FTP</acronym> - によって手にいれる場合は、 - 近くのサイトを利用するようにしてください。 + <para>さらに、&os; は以下のミラーサイトから + anonymous <acronym>FTP</acronym> によって入手できます。 + &os; を anonymous <acronym>FTP</acronym> + から入手する場合には、近くのサイトを利用するようにしてください。 <quote>一次ミラーサイト</quote> としてあげられているサイトには、 - &os; の各アーキテクチャで利用可能なすべてのバージョンのアーカイブ一式が用意されています。 + &os; の各アーキテクチャで利用可能なすべてのバージョンのアーカイブ一式が用意されていますが、 あなたが住んでいる国や地域には、 - より高速にダウンロードできるサイトがおそらくあるでしょう。 + おそらくより高速にダウンロードできるサイトが用意されています。 各国のミラーサイトには、 人気のあるアーキテクチャの最新のバージョンが置いてありますが、 &os; のアーカイブ全体はもしかするとないかもしれません。 @@ -191,17 +191,13 @@ This site doesn't have any products newe <variablelist> <varlistentry> - <term>カリフォルニア、サンフランシスコ近辺、公式なソース</term> + <term>グローバルミラー</term> <listitem> <itemizedlist> <listitem> <para><uri xlink:href="ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CTM/">ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CTM/</uri></para> </listitem> - <listitem> - <para><uri - xlink:href="ftp://ftp.FreeBSD.org/pub/FreeBSD/CTM/">ftp://ftp.FreeBSD.org/pub/FreeBSD/CTM/</uri></para> - </listitem> </itemizedlist> </listitem> </varlistentry> @@ -476,58 +472,66 @@ Comment out for now until these can be v を使うことを好むでしょう。</para> </note> - <para>この章では、&os; システムへの - <application>Subversion</application> のインストール方法および、 - &os; リポジトリをローカルに準備する方法について説明します。 - <application>Subversion</application> + <para>この節では、&os; システムへの + <application>Subversion</application> のインストール方法、および + &os; リポジトリをローカルに作成する方法について説明します。 + さらに <application>Subversion</application> を利用するための情報についても紹介します。</para> </sect2> - <sect2 xml:id="svn-svnlite"> - <title>Svnlite</title> + <sect2 xml:id="svn-ssl-certificates"> + <title>ルート <acronym>SSL</acronym> 証明書</title> + + <para><package role="port">security/ca_root_nss</package> + をインストールすることで、 + <application>Subversion</application> は、 + <acronym>HTTPS</acronym> リポジトリサーバを検証できます。 + ルート <acronym>SSL</acronym> 証明書は、 + port からインストールできます。</para> + + <screen>&prompt.root; <userinput>cd /usr/ports/security/ca_root_nss</userinput> +&prompt.root; <userinput>make install clean</userinput></screen> + + <para>または package からインストールしてください。</para> - <para>&os; には、機能は同じですが - <application>Subversion</application> より軽い - <command>svnlite</command> がインストールされています。 - <command>svnlite</command> があなたの要求を満たしているのであれば、 - 他にインストールする必要はありません。</para> - - <para><command>svnlite</command> で - <acronym>HTTPS</acronym> サーバにアクセスしたいのであれば、 - ルート証明書バンドルをインストール必要があります。</para> - - <screen>&prompt.root; <userinput>pkg install ca_root_nss</userinput></screen> - - <para>証明書バンドルをインストールすることで、 - <command>svnlite</command> - は改ざんなくリポジトリサーバと安全に通信できます。</para> + <screen>&prompt.root; <userinput>pkg install ca_root_nss</userinput></screen> + </sect2> + + <sect2 xml:id="svn-svnlite"> + <title><application>Svnlite</application></title> - <para><command>svnlite</command> を使用する場合には、 - 以下で示される例において、コマンド名を置き換えてください。</para> + <para>&os; には、<application>Subversion</application> + より軽い <command>svnlite</command> + がインストールされています。 + <application>Subversion</application> の port または package は、 + Python もしくは Perl <acronym>API</acronym> が必要な時や、 + 最新の Subversion を使用したい時のみ必要となります。</para> + + <para>通常の <application>Subversion</application> と、 + <literal>svnlite</literal> との違いは、 + 使用する時のコマンド名が異なるだけです。</para> </sect2> <sect2 xml:id="svn-install"> <title>インストール</title> <para><command>svnlite</command> を利用できない場合や、 - <application>Subversion</application> を使いたいのであれば、 + フルバージョンの <application>Subversion</application> + を使いたいのであれば、 事前に <application>Subversion</application> をインストールしておく必要があります。</para> - <para>もし、すでに ports ツリーが用意してあれば、 - 以下のようにして <application>Subversion</application> - をインストールできます。</para> + <para><application>Subversion</application> は + Ports Collection からインストールできます。</para> <screen>&prompt.root; <userinput>cd /usr/ports/devel/subversion</userinput> -&prompt.root; <userinput>make install clean</userinput> -&prompt.root; <userinput>cd /usr/ports/security/ca_root_nss</userinput> &prompt.root; <userinput>make install clean</userinput></screen> - <para>package を使うと、簡単に - <application>Subversion</application> をインストールできます。</para> + <para>package を使って + <application>Subversion</application> + をインストールすることもできます。</para> - <screen>&prompt.root; <userinput>pkg install subversion</userinput> -&prompt.root; <userinput>pkg install ca_root_nss</userinput></screen> + <screen>&prompt.root; <userinput>pkg install subversion</userinput></screen> </sect2> <sect2 xml:id="svn-usage"> @@ -539,8 +543,8 @@ Comment out for now until these can be v <emphasis>ローカル作業コピー</emphasis> と呼びます。</para> <warning> - <para><emphasis><command>checkout</command> を使う前に、 - ローカルディレクトリを移動するか削除してください。</emphasis></para> + <para><command>checkout</command> をはじめて使う前に、 + ローカルディレクトリを移動するか削除してください。</para> <para><command>svn</command> 以外の方法で用意されたディレクトリでチェックアウトすると、 @@ -552,7 +556,6 @@ Comment out for now until these can be v <replaceable>protocol://hostname/path</replaceable> 形式の <acronym>URL</acronym> を用います。 以下に記載されているように、 - ミラーサイトは異なる複数のプロトコルに対応しています。 アクセスする &os; リポジトリは、パス (path) の最初で指定します。 リポジトリは 3 つあります。 <literal>base</literal> は &os; ベースシステムのソースコード、 @@ -565,7 +568,7 @@ Comment out for now until these can be v <para>以下のように入力して、リポジトリからチェックアウトしてください。</para> - <screen>&prompt.root; <userinput>svn checkout <replaceable>svn-mirror</replaceable>/<replaceable>repository</replaceable>/<replaceable>branch</replaceable> <replaceable>lwcdir</replaceable></userinput></screen> + <screen>&prompt.root; <userinput>svn checkout https://svn.FreeBSD.org/<replaceable>repository</replaceable>/<replaceable>branch</replaceable> <replaceable>lwcdir</replaceable></userinput></screen> <para>ここで、<replaceable>repository</replaceable>, <replaceable>branch</replaceable> および <replaceable>root</replaceable> @@ -573,15 +576,9 @@ Comment out for now until these can be v <itemizedlist> <listitem> - <para><replaceable>svn-mirror</replaceable> は、 - <link linkend="svn-mirrors">Subversion - ミラーサイト</link> のひとつの URL です。</para> - </listitem> - - <listitem> <para><replaceable>repository</replaceable> には、 - プロジェクトのリポジトリ、すなわち <literal>base</literal>, - <literal>ports</literal>, または <literal>doc</literal> + プロジェクトリポジトリの <literal>base</literal>, + <literal>ports</literal> または <literal>doc</literal> のどれかひとつを指定します。</para> </listitem> @@ -620,11 +617,12 @@ Comment out for now until these can be v それが <command>svn</command> によって生成されたものでなければ、 チェックアウトする前に、名前を変更するか削除してください。</para> - <screen>&prompt.root; <userinput>svn checkout <replaceable>https://svn.FreeBSD.org</replaceable>/ports/head /usr/ports</userinput></screen> + <screen>&prompt.root; <userinput>svn checkout https://svn.FreeBSD.org/ports/head /usr/ports</userinput></screen> <para>初めてチェックアウトする際には、 - リモートリポジトリのすべてのブランチをダウンロードするので時間がかかります。 - どうぞ我慢してください。</para> + リモートリポジトリのすべてのブランチをダウンロードする必要があるので、 + 時間がかかります。 + 我慢してください。</para> <para>初めてのチェックアウト後は、 以下を実行することでローカル作業コピーをアップデートできます。</para> @@ -662,9 +660,11 @@ Comment out for now until these can be v <secondary>ミラーサイト</secondary> </indexterm> - <para>&os; <application>Subversion</application> リポジトリである - <systemitem class="fqdomainname">svn.FreeBSD.org</systemitem> は、 - 公にアクセス可能なミラーネットワークで、 + <para>&os; <application>Subversion</application> リポジトリは、</para> + + <programlisting>svn.FreeBSD.org</programlisting> + + <para>です。これは、公にアクセス可能なミラーネットワークで、 GeoDNS を用いて適切なバックエンドサーバを選択しています。 ブラウザを用いて &os; の <application>Subversion</application> リポジトリを参照するには、<link @@ -790,8 +790,8 @@ Comment out for now until these can be v こちらの方が豊富なオプションを備え、送り側と受け側の差分だけを 転送するという rsync リモート更新プロトコルを使用するという点が異なります。 rsync を使うと、ネットワーク経由での同期を非常に高速に行なうことが可能です。 - 特に、&os; <acronym>FTP</acronym> サーバや CVS - リポジトリのミラーサイトを作成する時に便利でしょう。 + 特に、&os; <acronym>FTP</acronym> + サーバのミラーサイトを作成する時に便利でしょう。 <application>rsync</application> は、多くのオペレーティングシステムで 利用することができます。&os; 版は、<package>net/rsync</package> の port か、package を使ってください。</para>