[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
pkgsrc/doc/guide/files/editing.xml 1.12
以下のページの翻訳をしました。ツッコミをお願いします。
pkgsrc/doc/guide/files/editing.xml 1.12
火曜日までに異議がなければ、 commit します。
原文は
http://cvsweb.NetBSD.org/bsdweb.cgi/%7Echeckout%7E/pkgsrc/doc/guide/files/editing.xml?rev=1.12&content-type=text/plain
で、訳文は
http://www.na.rim.or.jp/%7Ekano/tmp/pkgsrc/doc/guide/files/editing.xml
に置いてあります。
以下は原文との差分です。
--- editing.xml.orig 2006-08-18 22:57:56.000000000 +0900
+++ editing.xml 2006-08-28 21:54:34.000000000 +0900
@@ -1,17 +1,19 @@
<!-- $NetBSD: editing.xml,v 1.12 2006/07/29 17:55:13 rillig Exp $ -->
+<!-- Based on english version: -->
+<!-- NetBSD: editing.xml,v 1.12 2006/07/29 17:55:13 rillig Exp -->
<appendix id="editing">
-<title>Editing guidelines for the pkgsrc guide</title>
+<title>the pkgsrc guide 編集の指針</title>
- <para>This section contains information on editing the pkgsrc
- guide itself.</para>
+ <para>本節では、この the pkgsrc guide
+ そのものの編集に関する情報を掲載します。</para>
<sect1 id="targets">
-<title>Make targets</title>
+<title>make ターゲット</title>
- <para>The pkgsrc guide's source code is stored in
- <filename>pkgsrc/doc/guide/files</filename>, and several files
- are created from it:</para>
+ <para>the pkgsrc guide のソースコードは
+ <filename>pkgsrc/doc/guide/files</filename> 以下に置かれており、
+ これをもとに、以下のような数々のファイルが生成されます。</para>
<itemizedlist>
@@ -24,60 +26,60 @@
<listitem><para><ulink
url="http://www.NetBSD.org/Documentation/pkgsrc/pkgsrc.pdf"/>:
- The PDF version of the pkgsrc guide.</para></listitem>
+ the pkgsrc guide の PDF 版。</para></listitem>
<listitem><para><ulink
url="http://www.NetBSD.org/Documentation/pkgsrc/pkgsrc.ps"/>:
- PostScript version of the pkgsrc guide.</para></listitem>
+ the pkgsrc guide の PostScript 版。</para></listitem>
</itemizedlist>
</sect1>
<sect1 id="procedure">
-<title>Procedure</title>
+<title>編集手順</title>
- <para>The procedure to edit the pkgsrc guide is:</para>
+ <para>the pkgsrc guide の編集手順は、以下のとおりです。</para>
<procedure>
- <step><para>Make sure you have the packages needed to
- regenerate the pkgsrc guide (and other XML-based NetBSD
- documentation) installed. These are <filename
- role="pkg">meta-pkgs/netbsd-doc</filename> for creating the
- ASCII and HTML versions, and <filename
- role="pkg">meta-pkgs/netbsd-doc-print</filename> for the
- PostScript and PDF versions. You will need both packages
- installed, to make sure documentation is consistent across all
- formats.</para></step>
+ <step><para>the pkgsrc guide (と、XML にもとづくその他の
+ NetBSD ドキュメンテーション)
+ の再生成に必要なパッケージがインストールされていることを確認します。
+ ASCII および HTML 版の生成に必要なのは <filename
+ role="pkg">meta-pkgs/netbsd-doc</filename>、
+ PostScript および PDF 版の生成に必要なのは <filename
+ role="pkg">meta-pkgs/netbsd-doc-print</filename> です。
+ 各形式のドキュメンテーションの一貫性を保つために、
+ いずれのパッケージもインストールする必要があります。</para></step>
- <step><para>Run <command>cd doc/guide</command> to get to the
- right directory. All further steps will take place
- here.</para></step>
+ <step><para><command>cd doc/guide</command> を実行して、
+ 適切なディレクトリーに移動します。これ以降の手順は、
+ すべてこの場所でおこないます。</para></step>
- <step><para>Edit the XML file(s) in
- <filename>files/</filename>.</para></step>
+ <step><para><filename>files/</filename> 以下にある
+ XML ファイルを編集します。</para></step>
- <step><para>Run <command>bmake</command> to check the pkgsrc
- guide for valid XML and to build the final output files. If you
- get any errors at this stage, you can just edit the files, as
- there are only symbolic links in the working directory, pointing
- to the files in <filename>files/</filename>.</para></step>
+ <step><para>Run <command>bmake</command> を実行して、the pkgsrc
+ guide が妥当な XML であることを確認し、最終的な出力ファイルを構築します。
+ 何かエラーが出た場合は、元のファイルを編集するだけで結構です。
+ 作業ディレクトリーには、<filename>files/</filename>
+ 以下のファイルを指すシンボリックリンクがあるだけだからです。</para></step>
<step><para><command>(cd files && cvs
commit)</command></para></step>
- <step><para>Run <command>bmake clean && bmake</command> to
- regenerate the output files with the proper RCS
- Ids.</para></step>
+ <step><para><command>bmake clean && bmake</command>
+ を実行して、適切な RCS
+ Id を含んだ出力ファイルを作り直します。</para></step>
- <step><para>Run <command>bmake regenerate</command> to
- regenerate the files in both <filename>pkgsrc/doc</filename> and
- <filename>htdocs</filename>.</para></step>
+ <step><para><command>bmake regenerate</command> を実行して、
+ <filename>pkgsrc/doc</filename> および
+ <filename>htdocs</filename> 以下のファイルをそれぞれ作り直します。</para></step>
- <step><para>If you have added, removed or renamed some chapters,
- you need to synchronize them using <command>cvs add</command> or
- <command>cvs delete</command> in the htdocs
- directory.</para></step>
+ <step><para>章の追加、削除、または改名をした場合は、
+ htdocs ディレクトリー以下で <command>cvs add</command> や
+ <command>cvs delete</command> を使って、
+ 元のファイルとの対応を揃える必要があります。</para></step>
</procedure>