		Sambaドキュメントの日本語訳版について

						2017/07/16
						日本Sambaユーザー会


1. はじめに
======================================================================

1.1 概要
----------------------------------------------------------------------

ここにあるファイルは、Sambaのドキュメントを日本語訳したファイルです。
訳していないものについては、英語版をそのまま取り込んでいます。
Samba-JP MLとsugj-tech MLのメンバーのご協力のもとに、多くの修正を行ない
ましたが、訳についてはまだまだ不十分なところが多数あります。そのことを
ご理解の上、ご利用ください。

1.2 リリース形式
----------------------------------------------------------------------

3.5系列からは、man形式、HTML形式およびSamba3-HOWTO、Samba3-Developers-Guideを
1つのアーカイブとして提供するほか、man形式のみのファイルも提供します。
man形式のみのアーカイブでは、再構築は出来ません。

2. バク
======================================================================

 かなり見直しましたが、まだまだ潜んでいるはずです。細かな検証を行なって
おりません。また、一部の部分はオリジナルと併記してある箇所があります。
誤訳等がありましたら、日本Sambaユーザー会のメーリングリスト(samba-jp@
samba.gr.jp)かスタッフまでご連絡ください。

3. 利用にあたって
======================================================================

3.1 配布について
----------------------------------------------------------------------

配布については、Sambaの配布条件と同じです(GPLv3)。同梱している
COPYINGファイルを参照してください。

3.2 更新条件
----------------------------------------------------------------------

原則として、オリジナルSambaが更新対象となっているものについて
翻訳を行います。

・4.3.x系列以前:	翻訳終了
・4.4.x系列:		翻訳中
・4.5.x系列:		翻訳中
・4.6.x系列:		翻訳中


Sambaのバージョンが変更になってもドキュメントの修正がない場合には、
日本語訳は変更しません。その場合にはSambaの旧バージョンに対応した
日本語マニュアルをそのままお使いください。更新状況については、
日本Sambaユーザー会のWebページか、Samba-JPメーリングリストを参照
してください。

また、新しいバージョンから古いバージョンへのバックポートを行う場合が
あります。ただし、バックポートをしてもリリースされない場合があります。
各系列の最新版が必要な場合はプロジェクトページからダウンロードしてく
ださい。

3.3 文字コード
----------------------------------------------------------------------

HTML形式、およびman形式のファイル両方ともUTF-8でエンコードしています。
必要に応じて他の文字コードに変換してください。

4. ビルド方法
======================================================================
4.1 準備

4.1.1 プロキシの設定

XMLファイルをコンパイルするときには、xsltprocが xslファイルをインター
ネット上のサイトからダウンロードします。そのため、処理にかなり時間が
かかります。xsl ファイルは静的コンテンツですので、キャッシュサーバを
使って、ダウンロード時間を減らすようにしてください。キャッシュサーバ
を使う/使わないでかなり差が付きます。

4.1.2 カタログファイルの準備

docs-xml/build配下にあるREADMEファイルに記載のように、catalog.xmlファイルを
作成します。具体的には、 docs-xml ディレクトリで、

% export XML_CATALOG_FILES="file:///etc/xml/catalog file://$(pwd)/build/catalog.xml"

と、

% cat $(pwd)/build/catalog.xml.in | sed -e "s|@abs_top_srcdir@|$(pwd)|g" |sed -e
"s|@abs_top_builddir@|$(pwd)|g"> $(pwd)/build/catalog.xml

を実行します。README中の上記行は間違っていますので、上記のように指定してください。

4.2 コンパイル方法

(1) Samba ソースアーカイブファイルを 任意のディレクトリに展開

  $ cd /srv/build
  $ tar xzf /srv/source/samba-4.X.Y.tar.gz

(2) Samba 翻訳文書アーカイブファイルを任意の場所に展開

  $ cd /srv/build
  $ mkdir samba-ja-docs-4.X.Y-Z
  $ cd /srv/source/samba-ja-docs-4.X.Y-Z
  $ tar xzf samba-ja-docs-4.X.Y-Z.tar.gz

(3) Samba ソースツリー内の docs-xml ディレクトリへのシンボリック
    リンクを翻訳文書ディレクトリ内に作成

  $ cd /srv/source/samba-ja-docs-4.X.Y-Z/docs-xml
  $ ln -s /srv/build/samba-4.X.Y-Z/docs-xml samba-docs-xml

(4) Makefileの修正
    4.6.6 までの、オリジナルのdocs-xml/Makefile には不具合があり、
    生成されるマニュアルページがアルファベット順になりません。
    以下のように修正をしてください。

----------------------------------------------------------------------------------

--- Makefile.orig       2017-01-11 16:55:14.000000000 +0900
+++ Makefile    2017-06-20 20:29:21.123498429 +0900
@@ -8,7 +8,7 @@

 # Docs to build
 MAIN_DOCS = $(patsubst %/index.xml,%,$(wildcard */index.xml))
-MANPAGES = $(wildcard $(MANPAGEDIR)/*.?.xml)
+MANPAGES = $(sort $(wildcard $(MANPAGEDIR)/*.?.xml))

 # Lists of files to process
 MANPAGES_PLUCKER = $(patsubst $(MANPAGEDIR)/%.xml,$(PLUCKERDIR)/%.pdb,$(MANPAGES))

-----------------------------------------------------------------------------------

(4) ビルドを実行

  $ make clean
  $ make manpages (manpagesの作成)
  $ make htmlman  (html化したmanpagesの作成)
  $ make html     (Samba3-HOWTO等のhtml文書の作成)


5. 変更履歴
======================================================================

4.3系列以前については README.43X として変更履歴を分離しました。
4.4系列、4.5系列については README.45X としてREADME(および変更履歴)を分離しました。

2017/07/16 Ver 4.6.6-1 4.6.6対応
	   マニュアルページ全面的な見直し、コンパイル方法変更。
	   cifsdd.8.xml,idmap_ad.8.xml,idmap_hash.8.xml,net.8.xml,
	   nmbd.8.xml,samba.7.xml,samba-regedit.8.xml,
	   smb.conf.5.xml,smbcontrol.1.xml,smbcquotas.1.xml,smbd.8.xml,
	   vfs_fruit.8.xml,vfs_glusterfs.8.xml,wbinfo.1.xml,
	   logon/logonscript.xml,misc/allowinsecurewidelinks.xml,
	   misc/cachedirectory.xml,misc/fssprunestale.xml,
	   misc/fsssequencetimeout.xml,misc/lockdirectory.xml,
	   misc/resetonzerovc.xml,misc/rpcdaemon.xml,misc/statedirectory.xml,
	   security/dedicatedkeytabfile.xml,security/inheritowner.xml,
	   security/security.xml,
	   Samba3-HOWTO/TOSHARG-BDC.xml,Samba3-HOWTO/TOSHARG-Bugs.xml,
	   Samba3-HOWTO/TOSHARG-Compiling.xml,
	   Samba3-HOWTO/TOSHARG-Further-Resources.xml,
	   Samba3-HOWTO/TOSHARG-Install.xml,Samba3-HOWTO/TOSHARG-Problems.xml,
	   Samba3-HOWTO/TOSHARG-Winbind.xml,Samba3-HOWTO/index.html,
	   Samba3-Developers-Guide/index.xml
	   makefile 変更
	   mvxattr.1.xml,
	   protocol/lsaovernetlogon.xml,protocol/rpcserverport.xml,
	   security/kerberosencryptiontypes.xml,
	   xslt/local.ja.xml,xslt/sj.html-common.xsl,xslt/sj.man.xsl
	   追加
		     

======================================================================

翻訳者は、当訳文の正当性、信頼性、先進性、妥当性、可読性、その他いかなるこ
とについて責任を負いません。
 
7.ご協力いただいた方々(順不同)
======================================================================

  佐藤文優,太田俊哉,千秋広幸,山口一郎,中野武雄,細川達己,たかはしもとのぶ、
  堀田倫英,武田保真,でん,山田史朗,はせがわようすけ,ちかましゅうへい,
  しらいたかし,平田祥司、海老澤、Michio Matsuyama
  Samba-JP/sugj-tech メーリングリストのメンバー
  (有)トップスタジオ/(株)翔泳社
