=============================================================================== HGBOOK 翻訳 =============================================================================== 本ディレクトリ配下に格納されている成果物は、以下の URL で公開されている Bryan O'Sullivan 氏による "Mercurial: The Definitive Guide" の翻訳版です。 http://hgbook.red-bean.com/ **** **** 注意 **** ** 内容に関する注意 - 翻訳ベースが 2007-06-17 時点の版なので、1.x 版以降となった現状の Mercurial にそぐわない内容が含まれています ** 翻訳内容に関する注意: - 翻訳水準を試行錯誤している頃だったので、「commit」を「確定」と訳す など、現状の Mercurial メッセージ翻訳の方針とは異なるものが含まれて います ※ 現状の Mercurial メッセージ翻訳方針の詳細に関しては、以下の日本 語翻訳プロジェクトの成果物を参照してください http://bitbucket.org/foozy/mercurial-translation-ja/wiki/ - 原著の以下の Appendix は翻訳版には含まれていません - Command reference - Mercurial Queues reference - 原著の以下の Appendix は未翻訳です - Open Publication License - 適切な訳ができなかった箇所には、"XXXX" マークと共に原文を併記してあ ります ** 翻訳成果に関する注意: - 本来は、実際にコマンドを実行した結果を文書に取り込むようになってい ますが: - 期待内容との差を検出した際に、実行結果生成が中断されてしまう - Mercurial の版を厳密に一致させないと、差分が検出されてしまう - コマンド自動実行が Win32 環境では上手く機能しない 以上のことから、実行結果出力は別途提供するものを展開して使用するこ ととしています 別途提供している実行結果出力は、比較的新しい Mercurial を使用して生 成しているため、原著者の期待するものとは異なる可能性があります - 以下の理由から、翻訳結果ファイルの文字コードには iso-2022-jp を採用 しています: - TeX の Unicode 化が実用的なのは Win32 環境(+ MacOS ?)のみ - Linux/Win32 環境の日本語化された TeX が、共に認識可能な文字コー ドは iso-2022-jp のみ - PDF 生成は Linux/Win32 の両環境で確認済み - HTML 生成は Win32 環境でのみ確認済み 以下の理由から、(パッケージベースで環境構築するのであれば)Win32 環 境でのみ HTML 生成を確認済みです。 - HTML 化に使用する tex4ht は、ASCII TeX(ptex)ではなく、 NTT-jTeX が必要(内部での処理の違いに起因) - Vine 向けの NTT-jTeX パッケージは流通していない - Debian 向けの NTT-jTeX パッケージは版が古すぎる - HTML 生成はファイル分割形式のみ 単一ファイル形式の HTML 生成は、LaTeX がヒープ領域不足で悲鳴を上げ てしまうため、現時点では未確認です **** **** 事前準備 **** 現状、LaTeX ソースからの PDF/HTML 生成は、以下の環境で確認しています。 - Vine 4.2 2.6.16-76.40vl4 (Linux) - Debian 2.6.26-13lenny2 (Linux) - Windows XP/Vista (Win32) 生成に必要なパッケージの導入方法等に関しては、それぞれ以下の URL を参 照してください。 - Vine: http://oku.edu.mie-u.ac.jp/~okumura/texwiki/?cmd=read&page=Linux%2Fvine - Debian: http://oku.edu.mie-u.ac.jp/~okumura/texwiki/?cmd=read&page=Linux%2FDebian ※ 上記ページでの説明は Sarge でのものですが、動作確認済み環 境は Lenny です - Win32: http://www.fsci.fuk.kindai.ac.jp/kakuto/win32-ptex/web2c75.html http://oku.edu.mie-u.ac.jp/~okumura/texwiki/?%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB(Windows) 動作確認済みの環境に関する情報は、ja/CONFIRMED.ja.txt を参照してくだ さい(導入後の手動設定に関する記述もありますので、必ず目を通してくださ い)。 Linux 環境でパッケージ導入する場合は、自動的に依存パッケージの導入が 行われますが、Win32 上で環境構築する場合は、手動で適宜導入する必要が あります。 パッケージ間の依存関係は、導入する版によって常に変動しますので、ディ スク容量事情が許すなら、試行錯誤をするよりも全パッケージを導入(「フル インストール」と呼ばれる状態)するのがお勧めです。 TeX/LaTeX とは別に、以下のツールの導入が必要です。 - Inkscape: SVG 画像からの変換処理に使用 http://www.inkscape.org/ - Graphviz: グラフ画像の生成に使用 http://www.graphviz.org/ Debian/Vine 等の Linux 環境ではパッケージ管理ツール経由で導入可能です が、Win32 環境への導入はダウンロード＆インストールを手動で行う必要が あります。 LaTeX や画像ファイルとは直接関係しませんが、以下のものも必要です。 - Perl - Python - GNU make - GNU bash ※ いわゆる B-shell でも可 **** **** PDF/HTML の生成手順 **** 1. lxo ファイルの展開 以下の URL で表示されるページの "Uploaded files" にある "hgbook_lxo.tar.gz" をダウンロードし、「HGBOOK のソースツリーのルー ト位置」で展開してください。 http://bitbucket.org/foozy/hgbook-ja/downloads/ 2. ja ディレクトリ(このファイルの格納されている位置)に移動 ※ 以下の説明は、全てこのディレクトリを起点としています 3. Makefile の選択 Linux 環境の場合は Makefile.linux を、Win32 環境の場合は Makefile.win32 を使用します。 以下の "make 実行" に関する箇所において、それぞれ "-f Makefile.linux" ないし "-f Makefile.win32" を指定するものとし ます。 4. PDF の生成は "make pdf" を実行 pdf ディレクトリ配下に hgbook.pdf が生成されます。 5. HTML の生成は "make split" を実行(※ Win32 環境でのみ生成を確認) html/split ディレクトリ配下に HTML ファイルが生成されます。 必要なファイルは *.css *.html および *.png フィルです。 ===============================================================================