GentooJP オリジナルドキュメントプロジェクト

1.GentooJP オリジナルドキュメントプロジェクトにようこそ!!

GentooJP オリジナルドキュメントプロジェクトは、Gentoo Linux Project に は無いドキュメントを作成したり、作成の支援をするプロジェクトです。

このドキュメントにはオリジナルドキュメントを書くときの注意、投稿の流れ が書いてあります。

オリジナルドキュメントプロジェクトといっても、あまり難しいものではあり ません。Gentoo に関する（日本語の）ドキュメントをまとめていこう、 というものです。オリジナルドキュメントプロジェクトは、Gentoo Linuxを 使っていく上でのヒント、チュートリアル、みんなに自慢したい使い方、ちょっ と賢い設定方法、Gentoo Linux Projectや翻訳ドキュメントには書かれていな いこと、そんなドキュメントを募集しています。

2.プロジェクトへの参加方法

プロジェクトへの参加は簡単です。Gentoo Linux で使っている、いつもの xml 形式でドキュメントを書いて送ってくれるだけでOKです。詳しい流れは下 記のようになります。

まずはドキュメント用メーリングリストに入る 

なにはともあれ、ドキュメント用のメーリングリスト(gentoojp-docs)に入っ てください。この ML がドキュメントの受付け窓口になります。不明な点があ れば、ML に質問をしてみてください。

ドキュメントを書く 

初めに書いたように、オリジナルドキュメントの内容にはあまり制約を持 たせません。ただし、過度に商業的なもの、誹謗、中傷の類い、性的な内容、 など一般常識的に不適格なものは当然ダメです。誰かが幸せになれるドキュメ ントにしてください。また、ドキュメントは xml 形式で書いてください。xml の書き方、構成については、次の章で簡単に触れます。

ドキュメントを投稿する 

できあがったドキュメントを gentoojp-docs に投稿してください。オリジ ナルドキュメントの内容については、著者の責任とします。このため、翻訳と 違い、文章的な査読（誤字や言い回しなどのチェック）はありますが、内容に 関する査読（技術的な検証等）はありません。もし、査読希望の場合は「査読 希望」という旨のメッセージも付けてください。

ドキュメント掲載 

投稿されたドキュメントは GentooJP のオリジナルドキュメントのリストに加 えられます。

ドキュメントのメンテナンス 

内容が古くなってしまったり、変更が必要なドキュメントについては、メ ンテナンス(更新作業)が必要になります。メンテナンスするかどうかについて は、著者の判断でお願いします。また、もしかしたら、ドキュメント管理メン バーからメンテナンスのお願いがあるかもしれません。

ちょっと細かいけど大事なこと 

オリジナルドキュメントのプロジェクトに参加するのは簡単ですが、いく つか御理解いただきたい点があります。

• 著作権について -- ドキュメントの著者になります。
• でも、ページの下の方に Copyright 云々とでてますけど? -- 早くなおします。
• 匿名投稿について -- まったくの匿名はご遠慮ねがいます。ハンドルネー ムはOKです。
• メールアドレスについて -- かならず連絡がとれるメールアドレスを mail タグに指定してください。
• 管理者は内容を変更するの? -- 原則内容の変更しませんが、タグ属性を 変更するといったシステム側の変更は、著者に連絡なしに行うことがあります。

3.ドキュメントの書き方

オリジナルドキュメントも他のドキュメントや翻訳と同じように xml で記 述します。xml といっても約束事は最低限のものしかありません。次のサンプ ル書式を参考にしてください。

<xml version='1.0' encoding="UTF-8"?> //エンコードは必ず UTF-8 を使用してください。
<?xml-stylesheet href="/xsl/guide.xsl" type="text/xsl"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">

<guide link="/jpdoc/**オリジナルドキュメントのファイル名**">
//たとえば、hoge.html ならば、<guide link="/jpdoc/hoge.html"> としてください。

<title>GentooJP オリジナルドキュメントプロジェクト</title>
<author title="Author"><mail link="[email protected]">真藤直観</mail></author>
//author タグの title 属性は"著者"か"Author"を指定してください。また、メールアドレスは必ず記載してください

<abstract>
GentooJP でのオリジナルドキュメントに関する説明です。
</abstract>
<version>0.1</version>
<date>27 Oct 2003</date>
//title, author, abstract, version, date タグは必ず入れてください。

<chapter>
<title>chapter のタイトル</title>
<section>
...本文...
</section>
</chapter>

</guide>

ドキュメントの作成については、オリジナルドキュメントにある「翻 訳とオリジナルドキュメント作成環境の構築ガイドやGentoo Linux XMLガイ ドも参考にしてください。特に「翻訳とオリジナルドキュメント作成環 境ガイド」には AxKit での環境構築方法が載っており、ドキュメントを書く ときには非常に役に立ちます。

4.オリジナルドキュメントの一覧

現在のオリジナルドキュメント一覧です