[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
developers/htdocs.xml: 1.25 -> 1.27
以下のページの更新をしました。ツッコミをお願いします。
developers/htdocs.xml: 1.25 -> 1.27
水曜日までに異議がなければ、 commit します。
マークアップの変更のみで内容は変わっていません。
以下、訳と原文の差分です。
--- developers/htdocs.xml.orig 2006-03-21 18:56:39.000000000 +0900
+++ developers/htdocs.xml 2006-03-21 18:56:39.000000000 +0900
@@ -3,12 +3,12 @@
PUBLIC "-//NetBSD//DTD Website-based NetBSD Extension//EN"
"http://www.NetBSD.org/XML/htdocs/lang/share/xml/website-netbsd.dtd">
-<webpage id="ja-htdocs">
+<webpage id="ja-developers-htdocs">
<config param="desc" value="htdocsを編集する"/>
-<config param="cvstag" value="$NetBSD: htdocs.xml,v 1.25 2005/06/28 11:47:59 darcy Exp $"/>
+<config param="cvstag" value="$NetBSD: htdocs.xml,v 1.27 2005/07/19 12:50:56 rpaulo Exp $"/>
<!-- Based on english version: -->
-<!-- NetBSD: htdocs.xml,v 1.25 2005/06/28 11:47:59 darcy Exp -->
-<config param="rcsdate" value="$Date: 2005/06/28 11:47:59 $"/>
+<!-- NetBSD: htdocs.xml,v 1.27 2005/07/19 12:50:56 rpaulo Exp -->
+<config param="rcsdate" value="$Date: 2005/07/19 12:50:56 $"/>
<head>
<title>htdocsを編集する</title>
</head>
@@ -43,10 +43,14 @@
<listitem><ulink url="cvs-repos/cvs_intro.html">CVS
の導入</ulink>を読んでください。
</listitem>
- <listitem><pkg>meta-pkgs/netbsd-www</pkg> をインストールします。これにより、
+ <listitem><filename role="pkg">meta-pkgs/netbsd-www</filename>
+ をインストールします。これにより、
web サイトの構築に必要な道具がインストールされます。最低限、
- <pkg>textproc/docbook-xsl</pkg> >= 1.68.1 および
- <pkg>textproc/docbook-website</pkg> >= 2.5.0 が必要です (<pkg>meta-pkgs/netbsd-www</pkg> 1.3
+ <filename role="pkg">textproc/docbook-xsl</filename>
+ >= 1.68.1 および
+ <filename role="pkg">textproc/docbook-website</filename>
+ >= 2.5.0 が必要です
+ (<filename role="pkg">meta-pkgs/netbsd-www</filename> 1.3
が依存していますが、これより前のバージョンではもっと古いバージョンの
docbook-xsl も許容していました)。
</listitem>
@@ -70,7 +74,7 @@
<title>HTMLを有効にする</title>
<para>
変更した後には、
- <pkg>www/weblint</pkg>
+ <filename role="pkg">www/weblint</filename>
や、それよりも良いのは
<ulink url="http://validator.w3.org/">http://validator.w3.org/</ulink>
のようなHTMLチェッカーで一通りチェックすべきです。
@@ -125,7 +129,8 @@
</para>
<para>
ある HTML タグを、等価な XML に変換する方法がわからない場合は、
- システムにインストールされている <pkg>textproc/docbook-website</pkg>
+ システムにインストールされている
+ <filename role="pkg">textproc/docbook-website</filename>
のなかに便利な例があるかもしれません。そしてもちろん、
www@ メーリングリストに遠慮なく助けを求めていただいて結構です。
</para>
@@ -156,9 +161,13 @@
<title>.xml (docbook-website) ファイルの取扱手順</title>
<para>
.xml ファイルから .html ファイルを構築するためには、少なくとも
- <pkg>textproc/libxslt</pkg> と <pkg>textproc/docbook-website</pkg>
- をインストールしておく必要があります。これらは <pkg>meta-pkgs/netbsd-www</pkg> に含まれています。
- <pkg>meta-pkgs/netbsd-www</pkg> のバージョンが 1.3 であることを確認してください。
+ <filename role="pkg">textproc/libxslt</filename> と
+ <filename role="pkg">textproc/docbook-website</filename>
+ をインストールしておく必要があります。これらは <filename
+ role="pkg">meta-pkgs/netbsd-www</filename>
+ に含まれています。
+ <filename role="pkg">meta-pkgs/netbsd-www</filename> のバージョンが 1.3
+ であることを確認してください。
</para>
<para>
.html ファイルを生成するには、対象のディレクトリーで
@@ -303,7 +312,8 @@
<sect4 id="before-anything">
<title>htdocsに変更を加える前に:</title>
<orderedlist>
- <listitem><pkg>meta-pkgs/netbsd-www</pkg> がインストールされていることを確認します。
+ <listitem><filename
+ role="pkg">meta-pkgs/netbsd-www</filename> がインストールされていることを確認します。
<ulink url="#what-is-required">前の項目</ulink>もご覧ください。</listitem>
<listitem>CVSリポジトリーから<code>htdocs</code>をチェックアウトします。</listitem>
<listitem>htdocs ツリーのコピーがすでにある場合は、定期的に更新するように
Index: developers/htdocs.xml
===================================================================
RCS file: /cvsroot/htdocs/developers/htdocs.xml,v
retrieving revision 1.25
retrieving revision 1.27
diff -u -r1.25 -r1.27
--- developers/htdocs.xml 28 Jun 2005 11:47:59 -0000 1.25
+++ developers/htdocs.xml 19 Jul 2005 12:50:56 -0000 1.27
@@ -3,10 +3,10 @@
PUBLIC "-//NetBSD//DTD Website-based NetBSD Extension//EN"
"http://www.NetBSD.org/XML/htdocs/lang/share/xml/website-netbsd.dtd">
-<webpage id="htdocs">
+<webpage id="developers-htdocs">
<config param="desc" value="Editing htdocs"/>
-<config param="cvstag" value="$NetBSD: htdocs.xml,v 1.25 2005/06/28 11:47:59 darcy Exp $"/>
-<config param="rcsdate" value="$Date: 2005/06/28 11:47:59 $"/>
+<config param="cvstag" value="$NetBSD: htdocs.xml,v 1.27 2005/07/19 12:50:56 rpaulo Exp $"/>
+<config param="rcsdate" value="$Date: 2005/07/19 12:50:56 $"/>
<head>
<title>Editing htdocs</title>
</head>
@@ -39,11 +39,15 @@
<listitem>Read <ulink url="cvs-repos/cvs_intro.html">the CVS
introduction</ulink>.
</listitem>
- <listitem>Install <pkg>meta-pkgs/netbsd-www</pkg>, which provides the tools
+ <listitem>Install <filename role="pkg">meta-pkgs/netbsd-www</filename>,
+ which provides the tools
required to build the web site. Please make sure that you have at
- least <pkg>textproc/docbook-xsl</pkg> >= 1.68.1 and
- <pkg>textproc/docbook-website</pkg> >= 2.5.0 (automatically
- required by <pkg>meta-pkgs/netbsd-www</pkg> 1.3, but earlier
+ least <filename role="pkg">textproc/docbook-xsl</filename>
+ >= 1.68.1 and
+ <filename role="pkg">textproc/docbook-website</filename>
+ >= 2.5.0 (automatically
+ required by <filename role="pkg">meta-pkgs/netbsd-www</filename>
+ 1.3, but earlier
versions also accepted earlier versions of docbook-xsl).
</listitem>
<listitem>Set your CVSROOT as indicated and run
@@ -66,7 +70,8 @@
<title>Validate your HTML</title>
<para>
After making any changes you should run your html through an HTML
- verifier such as <pkg>www/weblint</pkg>, or better still <ulink
+ verifier such as <filename role="pkg">www/weblint</filename>,
+ or better still <ulink
url="http://validator.w3.org/">http://validator.w3.org/</ulink>.
The URL for a link to an index.html file should not include the
trailing index.html.
@@ -121,7 +126,8 @@
<para>
If you are unsure how to convert a given HTML tag to the XML equivalent,
you may find some useful examples installed as part of the
- <pkg>textproc/docbook-website</pkg> on your system. And of course you can
+ <filename role="pkg">textproc/docbook-website</filename> on your system.
+ And of course you can
feel free to ask on the www@ list for help.
</para>
<para>
@@ -152,9 +158,12 @@
<title>Processing .xml (docbook-website) files</title>
<para>
In order to build .html files from .xml files, you will need at
- least <pkg>textproc/libxslt</pkg> and <pkg>textproc/docbook-website</pkg>
- installed. These are installed as part of <pkg>meta-pkgs/netbsd-www</pkg>.
- Please make sure that you have <pkg>meta-pkgs/netbsd-www</pkg> version
+ least <filename role="pkg">textproc/libxslt</filename> and
+ <filename role="pkg">textproc/docbook-website</filename>
+ installed. These are installed as part of <filename
+ role="pkg">meta-pkgs/netbsd-www</filename>.
+ Please make sure that you have <filename
+ role="pkg">meta-pkgs/netbsd-www</filename> version
1.3.
</para>
<para>
@@ -299,7 +308,8 @@
<sect4 id="before-anything">
<title>Before you do anything with htdocs:</title>
<orderedlist>
- <listitem>Ensure you have <pkg>meta-pkgs/netbsd-www</pkg> installed.
+ <listitem>Ensure you have <filename
+ role="pkg">meta-pkgs/netbsd-www</filename> installed.
Also, see <ulink url="#what-is-required">above</ulink>.</listitem>
<listitem>Check out <code>htdocs</code> from the CVS repository.</listitem>
<listitem>If you already have a copy of htdocs in your tree, make sure you