LFSbook in Japanese Wiki

HowToLink

2009-09-12T08:08:37+09:00

FrontPage へ戻る

LFSブックへのリンクについて

1. LFSブックへのリンクについて

本プロジェクトでは LFS ブック日本語版の HTML ファイル群を、オンラインで、あるいは tarball として提供しています。
それらへの参照リンクは、自由にお作り頂いて構いません。
ただし、例えば LFSブック日本語版のオンラインWebページは、複数の階層的なページとして構成されています。そしてブックの構成内容は今後の改訂により変わる可能性があります。したがって特定ページに対して参照リンクを張ったとした場合、ページ構成変更により参照リンク先が消失するということが起こりうるかもしれません。このことを十分に留意いただいた上でのご対処をお願い致します。LFS ブック日本語版のトップページは不変としますので、参照リンクをお作り頂く場合はトップページのURLをご利用いただくことをお勧めします。

2. 具体的なリンクについて

2.1. LFSブック日本語版：オンラインHTMLページ (トップページ)

[安定版] http://lfsbookja.sourceforge.jp/6.5.ja/
[SVN版] http://lfsbookja.sourceforge.jp/svn.ja/

2.2. LFSブック日本語版：HTML tarball

[安定版] lfsbookja-6.5-html.tar.bz2
[SVN版] lfsbookja-svn-html.tar.bz2

2.3. LFSブック日本語版：開発ソース

開発ソースは特にURL提供しません。
リリースパッケージ (安定版：lfsbookja-6.5-src、SVN版：lfsbookja-svn-src) にて tarball を提供しています。これに対して、特定日付の、あるいは最新日付の tarball を指し示す URL は提供されません。

2.4. 本プロジェクト内：各種ページ

本プロジェクト内の各種ページは、それぞれをブラウザ表示させ、URLアドレス欄に表記されるものをリンクとしてご利用ください。

HowToUse

2009-09-12T08:06:23+09:00

FrontPage へ戻る

LFSブックのオンライン参照とダウンロードについて

1. オンライン参照・ダウンロード方法

LFSブック日本語版をオンライン参照する場合は、以下のリンクをクリックしてください。
- http://lfsbookja.sourceforge.jp/6.5.ja/ (安定版)：これはオリジナルの LFSブック安定版に対応した日本語版です。
- http://lfsbookja.sourceforge.jp/svn.ja/ (SVN版)：これはオリジナルの LFSブックSVN版に対応した日本語版です。
LFSブック日本語版の HTMLソース一式をダウンロードする場合は、本プロジェクト内のリリースパッケージ (安定版：lfsbookja-6.5-html、SVN版：lfsbookja-svn-html) から最新のパッケージをダウンロードしてください。これらは tarball (*.tar.bz2) 形式でまとめていますので、入手後、しかるべきツールを用いて展開解凍してください。最上位フォルダの直下にある index.html がトップページとなります。お使いの Webブラウザで開いて参照してください。

2. オンライン参照とダウンロードの使い分け

オンラインで参照するのが最も手早いものです。
ただしオンライン公開されている HTML ページは、常時参照可能であるとは限らず、またその内容が変わってしまう可能性もあります。
- 例えばサーバーダウンやネットワーク障害が発生すれば、当然オンライン参照することができなくなります。
- また特に SVN版の場合は、比較的頻繁に内容が更新されるため、仮にオンライン参照をしながら LFS 構築作業を開始していた場合、日の経過とともにブック内容が変わってしまって、LFS 構築作業に支障をきたすことになるかもしれません。
- このことは LFSブック日本語版に限った話ではなく、オリジナルの LFSブックについても同じことが言えます。
したがって LFS 構築作業を実際に開始するなら、HTML tarball をダウンロードして入手し、それに基づいて作業することをお勧めします。
このような状況をご認識いただき、作業内容に応じて適宜オンライン参照かダウンロードを選択してご利用ください。

License

2009-09-12T08:04:16+09:00

FrontPage へ戻る

本プロジェクトのライセンスについて

1. はじめに

本プロジェクトでは (1) LFS ブック日本語版の HTML ファイル群、(2) LFS ブック日本語版の HTML を生成するための開発ソース、の二種類を提供しています。
このうち (1) の HTML ファイルは、本プロジェクト上にてオンライン公開していると同時に、本プロジェクトのリリースパッケージとして tarball にまとめて提供しています。
また (2) の開発ソースは、同じく本プロジェクトのリリースパッケージとして tarball にまとめて提供しています。また本プロジェクト内の Subversion ツリーにより、主に開発者向けとして公開しています。
大きく (1) と (2) の二種類の提供物に対して、それぞれライセンスが異なります。

2. HTML ソースファイル群のライセンス

「1.はじめに」で示した (1) の HTML ソース群とは具体的には以下のものです。
- http://lfsbookja.sourceforge.jp/6.5.ja/ (安定版)、http://lfsbookja.sourceforge.jp/svn.ja/ (SVN版) としてオンライン公開している HTML ファイル群一式。
- 本プロジェクトのリリースパッケージとして提供している HTML ファイル群 (その tarball) 一式。リリースパッケージは具体的には、安定版の場合 lfsbookja-6.5-html、SVN版の場合 lfsbookja-svn-html です。
これらは「クリエイティブコモンズ」の表示(Attribution)-非営利(Noncommercial)-継承(Share Alike) 2.0 に従います。
これはオリジナルの LFS ブックのライセンスに従うものです。
詳しくは Create Commons、またはクリエイティブ・コモンズ・ジャパンを参照してください。

3. 開発ソース群のライセンス

「1.はじめに」で示した (2) の開発ソース群とは具体的には以下のものです。
- 本プロジェクトのリリースパッケージとして提供している開発ソースファイル群 (その tarball) 一式。リリースパッケージは具体的には、安定版の場合 lfsbookja-6.5-src、SVN版の場合 lfsbookja-svn-src です。
- 本プロジェクトの Subversion ツリーにより提供している開発ソースファイル群一式。
これらは GNU General Public License V3 に従うものとします。
詳しくは http://www.gnu.org/licenses/gpl.html などを参照してください。

FrontPage

2009-09-10T13:58:53+09:00

LFSブック日本語版 Wiki

LFSブック日本語版 Wikiページへようこそ。

この Wiki では、本プロジェクトについての諸々を説明します。

1. 利用者向け

2. 開発者向け

ビルド方法

HowToBuild

2009-09-09T13:15:02+09:00

ビルド方法

1. 前提環境(パッケージ)

本配布は Linux 上にて構築することを想定しています。Unix 互換環境でもビルドできると思いますが検証はしていません。
本配布ではビルドのために、標準的な開発ツールとして Cコンパイラおよび make を必要とします。
さらに以下のツールまたはパッケージが必要です。
- Docbook XML DTD 4.5 (4.5 は必須です)
- Docbook XSL stylesheets
- xmllint (libxml2)
- xsltproc (libxslt)
- tidy (HTML Tidy-cvs)
また tarball 解凍のために tar, bzip2 が必要です。
Subversion リポジトリから最新のソースを入手する場合には Subversion が必要です。
開発編集作業を行う場合は autoconf (2.64)、automake (1.11) が必要です。(単にビルドするだけなら、それらは不要です。)

例えば Debian の場合、追加でインストールすべき主要なパッケージは、docbook-xml、docbook-xsl、xsltproc、libxml2-utils、tidy となることを確認しています。他のディストリビューションの場合はこれを参考として必要パッケージを確定してください。
Cygwin をお使いの場合は、ビルド方法(Cygwin) を参照してください。
LFS が既に構築済である場合は、これも本配布をビルドする環境として利用することができます。その場合は BLFS (Beyond Linux From Scratch) ブックに説明されている、DocBook XML DTD-4.5、DocBook XSL Stylesheets、libxml2、libxslt、HTML Tidy-cvs をソース入手してビルドすることで環境構築できます。このことは他のディストリビューションでも通用する話で、他のディストリビューションにて追加インストールすべきパッケージが不明であったり、自前でソースから構築することに支障がないのであれば、BLFSの手順に従ってソースからビルドしていけば、確実にビルド環境を構築できます。

2. ソースの入手

本配布はオリジナル LFS ブックの XML ソースを必要とします。LFS サイトの以下のURLから、ソース tarball を入手します。tarball 名は、安定版の場合 LFS-BOOK-Version-XML.tar.bz2、SVN版の場合 LFS-BOOK-SVN-Date.tar.bz2 といったファイルになっています。
- http://www.linuxfromscratch.org/lfs/downloads/stable/ (安定版の場合)
- http://www.linuxfromscratch.org/lfs/downloads/development/ (SVN版の場合)

本配布のソースを入手します。安定版とSVN版があります。いずれの版も鋭意開発を続けており、その最新は本サイト内の Subversion リポジトリより入手することもできます。

なおオリジナルのSVN版は SVN-20090819 などによりバージョン表記がなされており、本配布でのSVN版もそれに追随して構築しています。SVN-20090819 などのバージョンをチェックしているため、オリジナルと本配布のバージョンが異なる場合には、ビルドができないことがあります。ビルドできないのは開発者がまだ最新バージョンへの追随を行っていないことを示しています。

3. ビルド手順

本配布のソースを適当なディレクトリに展開(解凍)します。VER はバージョンを示します。安定版の場合は 6.5、SVN版の場合は SVN となります。
```
% cd /usr/local/src
% tar -xf /path/to/download/lfsbookja-VER.tar.gz
```

安定版の場合、LFS ブック XML ソース安定版を、上記と同じディレクトリに展開(解凍)します。
```
% cd /usr/local/src
% tar -xf /path/to/download/LFS-BOOK-6.5-XML.tar.bz2
```

SVN版の場合、LFS ブック XML ソース SVN版を、上記と同じディレクトリにて Subversion によりチェックアウトします。(チェックアウト場所は /usr/local/src では不適切かもしれません。適宜選定ください。)
```
% cd /usr/local/src
% svn co svn://svn.linuxfromscratch.org/LFS/trunk/BOOK
```

本配布のソースディレクトリに入って configure, make を実行します。VER はバージョンを示します。安定版の場合は 6.5、SVN版の場合は SVN となります。
```
% cd /usr/local/src/lfsbookja-VER
% ./configure && make
```

特に開発者の場合はソースディレクトリにて configure、make するのではなく、別のビルドディレクトリを生成してそこで実施すれば、ソースファイルと混在することなく、すっきりとビルド作業およびソース管理ができますのでお勧めします。この場合はオリジナルの XML ソースディレクトリを指定する必要があるため configure のオプション --with-bookdir を指定することになります。これについては後述しています。
```
% mkdir ~/lfsbookja-build
% cd ~/lfsbookja-build
% /usr/local/src/lfsbook-ja-VER/configure --with-bookdir=/path/to/originaldir
% make
```

現時点において make install は整備できていません。上の make コマンド実行により、ソースディレクトリ配下に 6.5.ja のようなサブディレクトリが生成され、そこに HTML ソース一式が生成されます。これが成果物となります。

configure のオプションとして --with-bookdir を設けています。デフォルトでオリジナル XML ソースツリーは、本配布のソースツリーと横並びの場所に配置するものとしており、さらにディレクトリ名を固定的に決めうちしています。--with-bookdir オプションを指定すれば、そのディレクトリパスを変更することができます。

HowToPointOut

2009-09-09T12:44:35+09:00

FrontPage へ戻る

LFSブック内容への指摘など

1. はじめに

本配布は LFS ブックの日本語訳を進め、多くの皆さんへの有用な情報提供となるよう目指しています。

ただし訳者の Linux 知識の不足や訳出の至らなさから、適切な日本語訳になっていない部分が存在するかもしれません。訳者自身でもその検証を鋭意継続して進め、是正に努めます。皆さまがお気づきの点があれば、是非ご指摘を頂きたく思います。

2. 指摘する場所

LFS ブック日本語訳にて、意味不明・訳出不十分・誤訳を見つけた場合、あるいはそれが疑わしい場合、以下のいずれかの手段を通じて、本プロジェクト管理者・開発者・訳者へご連絡ください。内容を吟味・検証した上で、しかるべく対処いたします。

2.1. 本サイト：フォーラムへの投稿

本サイト内に公開フォーラムを設置しています。そちらにご指摘内容、疑問内容を投稿してください。
ログインアカウントを持たない方でも、匿名で投稿することができます。
不備であるかどうか不明であったり疑問であったりする場合には、下記のチケット起票よりも、フォーラムへの投稿を選んで頂くようお願い致します。

2.2. 本サイト：チケットの起票

本サイト内にはチケットシステムがあります。チケットは一般に、プロジェクトが解消すべき課題を登録するもので、担当者や期限を定め、それが完了するまでのステータスを管理していくものです。
ログインアカウントを持たない方でも、匿名で起票することができます。
詳しい使い方はチケットの使い方を参照してください。
チケットは本プロジェクトにて最終的に課題として認識するものを管理するものであるため、課題かどうか不明であるものは、後に管理者や訳者によって却下されることもありますのでご注意ください。
どう訳すべきかの検討を要する、意見が分かれるようなものは、フォーラムにおいて広く意見を集め議論したいと思いますので、フォーラムへの投稿をお願い致します。

2.3. 本サイト：メーリングリストへの投稿

本サイト内にメーリングリストを設けています。そちらにご指摘内容、疑問内容を投稿してください。
ただし投稿するためには事前に、メーリングリストへの登録が必要です。メーリングリストタブにて「登録 / 脱退 / プリファレンス」をクリックして開く画面から、必要事項を入力して登録操作を行ってください。

3. 指摘内容の明示

指摘にあたっては、LFS ブック日本語版のどの章や節におけるどの文章であるかが分かる形で、ご指摘をお願い致します。
不備指摘に加えて、皆さんが考える試訳を示して頂けるとありがたく思います。

4. 指摘への対処に関する注意事項

ご指摘頂いた内容については、その内容に応じて適切な対処を進めるつもりです。フォーラムやチケット、メーリングリストにて、その対処方針なり対処結果を順次示します。
なお、今のところどこにも明示できていませんが、日本語訳を進めるにあたり、ある程度の翻訳指針を暗に定め、訳出を進めています。その方針に沿わないものについては、ご指摘を受けることができない場合がありますのでご了承ください。

CygwinBuild

2009-08-28T12:44:46+09:00

ビルド方法 (Cygwin)

1. 前提パッケージのインストール

本配布をビルドするために、以下のパッケージをあらかじめセットアップしておきます。
- gcc
- make
- docbook-xsl
- libxml2
- libxslt
- tidy

Cygwin の配布に含まれる DocBook XML DTD は、本 Wiki 記述時点においてバージョンが 4.4 までです。このバージョンでは本配布をビルドすることができません。本配布のビルドに必要なバージョンは 4.5 であるため、自分でインストールする必要があります。
- 本 Wiki の執筆以降に、バージョン 4.5 が提供されているようであれば、それをセットアップしてください。
- そうでない場合は BLFS (Beyond Linux From Scratch) ブックの該当ページの手順に従って自分でインストールを行います。手順のうち chown -R root:root . を行う個所だけ実行しないようにします。(Cygwin には root ユーザーがありません。)
- なお自分でインストールした後は、自己管理を行なう必要があります。後に Cygwin よりバージョン 4.5 が配布されるようになった場合には、適宜自インストールファイル類を削除するなどの対処を行ってください。

2. ビルド手順

ビルド手順はビルド方法における「2. ソースの入手」以降に示す説明に従ってください。