[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

developers/htdocs.list 1.68 -> developers/htdocs.xml 1.1

developers/htdocs.list を xml に変換しました。

  http://www.na.rim.or.jp/%7Ekano/tmp/developers/htdocs.xml
  http://www.na.rim.or.jp/%7Ekano/tmp/developers/htdocs.html

に置いてあります。

対応する原文は

  http://cvsweb.NetBSD.org/bsdweb.cgi/%7Echeckout%7E/htdocs/developers/htdocs.xml?rev=1.1&content-type=text/plain
  http://cvsweb.NetBSD.org/bsdweb.cgi/%7Echeckout%7E/htdocs/developers/htdocs.html?rev=1.69&content-type=text/html

です。

月曜日までに異議がなければ、 commit します。

なお、目次と dotlist-files (.list ファイルの説明) の本文は、
今後の更新で消えるので、原文のままにしてあります。

内容は以下の点をのぞき、以前のものと同じです。

- what-is-required で説明されている手順の
      <li>Set your CVSROOT as indicated and '<tt><b>cvs checkout htdocs</b></tt>.
  が
      <listitem>Set your CVSROOT as indicated and run
          <para><programlisting>cvs checkout htdocs</programlisting></para></listitem>
  に変わった (run が追加された)。
  訳は「〜してください」を「〜を実行してください」にした。

- dotlist-files のタイトルが
  What are .list files, and how to use them
  から
  What are .list files?
  に変わった。
  訳は「.listファイルとは何者で、どうやって使うのか？」を
  「.listファイルとは何者か?」にした。
  内容も大幅に変わったが、上述のとおり原文のままとした。

- convert-to-xml の項目が追加された。
  訳と原文は以下の通り。

訳:
<sect3 id="convert-to-xml">
<title>XML に変換する</title>
<para>
    全体的な変更が簡単にできるようにするため、現在、 NetBSD の web サイトは
    XML (docbook-website) に変換中です。 2004-11-15 以降、
    XML 以外のファイルを編集する必要があるときは、編集と同時に XML に変換することになっています。
    <code>htutils/scripts/list2xml</code> スクリプトは、通常の <code>.html</code>
    ファイルの変換のほか、旧来の <code>.list</code> の変換にも役立つでしょう。
</para>
<para>
    ファイルを XML に変換した後は、そのファイルを <code>htdocs/layout.xml</code>
    ファイルに書き加えて web サイトを再生成することを忘れないでください。
</para>
</sect3>

原文:
<sect3 id="convert-to-xml">
<title>Converting to XML</title>
<para>
    In order to facilitate global changes, we are currently converting the
    NetBSD website to XML (docbook-website).  As of 2004-11-15, any non-XML
    file that needs to be edited shall be converted to XML at the same time.
    You may find the script <code>htutils/scripts/list2xml</code> helpful to
    initiate the conversion of the old <code>.list</code> as well as plain
    <code>.html</code> files.
</para>
<para>
    After converting a file to XML, remember to add it to the
    <code>htdocs/layout.xml</code> file and regenerate the website.
</para>
</sect3>