History: AdminRepository - Linux JM (Japanese Man-page) Project - Linux JM (Japanese Man-page)...

JM Repository の構成

JM Project では、git によって文書の管理をしています。 このページでは、 リポジトリ内部の配置について説明します。

各 man ページの作業情報などは、テキストデータベース transalation_list で管理しています。 このファイルの書式は translation_list を参照してください。

ディレクトリ構成

JM Project の用いている git リポジトリのディレクトリ構成は 以下のようになっています。

/ +- www
  |
  +- admin
  |
  +- manual -+- 0unclassified -
             |
             +- GNU_bash -
             |
             +- GNU_binutils -
                    :

このうちの manual/ 以下が、本サイトの manual ディレクトリ 以下にミラーされています。 このディレクトリには、 マニュアルの一次ソースとなるアーカイブパッケージ (例えば util-linux-2.9v.tar.gz など) の basename と同名のサブディレクトリ (util-linux) を設けます。 ただし GNU のパッケージと LDP のパッケージだけには、 便宜上 GNU_, LDP_ という prefix をつけています。 このサブディレクトリを、以下では 「パッケージディレクトリ」と呼びます。

各パッケージディレクトリのサブ構造は以下のようになっています。

- pkg -+- ChangeLog
       +- translation_list
       +- original -+- man1
       |            +- man5
       |            +- man8
       |
       +- draft    -+- man1
       |            +- man5
       |            +- man8
       |
       +- release  -+- man1
       |            +- man5
       |            +- man8
       |
       +- contrib  -+- man1
                    +- man5
                    +- man8

• ChangeLog ファイルは変更履歴を記述したファイルです。 CVS システムで標準的に用いられれる形式です。
• translation_list は各マニュアルページのバージョンや作業情報、 著作権情報等を含むテキストデータベースファイルです。 このファイルの書式については translation_list の書式で説明します。
• ディレクトリ original/ には、 パッケージに含まれている原文が置かれます。
• ディレクトリ draft/ には、 「原文のコメントつき」の翻訳版が置かれます。 ここに置かれるページは、ドラフト版・リリース版を問わず、 常に翻訳作業の最新版になります。
• ディレクトリ release/ には、 「原文を取り去ったリリース版」が置かれます。
• ディレクトリ contrib/ には、 JM 以外で翻訳されたページの寄贈を受けた場合に、 そのファイルが置かれます。

実作業との対応は翻訳作業の流れを参考にしてください。