diff --git a/ja/FAQ/Makefile b/ja/FAQ/Makefile
index be8f49370c..55df64bf73 100644
--- a/ja/FAQ/Makefile
+++ b/ja/FAQ/Makefile
@@ -1,12 +1,27 @@
#
-# $FreeBSD: www/ja/FAQ/Makefile,v 1.5 1999/09/15 20:37:11 wosch Exp $
-# Original revision: 1.4
+# $FreeBSD: www/ja/FAQ/Makefile,v 1.6 1999/12/07 14:03:29 kuriyama Exp $
+# Original revision: 1.7
#
# Build the FreeBSD FAQ *outside* of the www tree, and install it
# in to the right place as necessary.
-all install clean:
- (cd ../../../doc/ja_JP.eucJP/books/faq && ${MAKE} 'FORMATS=html-split html' DESTDIR=${DESTDIR}/data/ja/FAQ ${.TARGET})
-.if make(install)
- (cd ${DESTDIR}/data/ja/FAQ; ln -sf index.html FAQ.html)
+.if exists(../Makefile.conf)
+.include "../Makefile.conf"
.endif
+.if exists(../Makefile.inc)
+.include "../Makefile.inc"
+.endif
+
+# At build time, we have to link to the doc/ directory at the same level
+# as the www/ tree.
+all:
+ ${LN} -fs ${.OBJDIR}/../../../doc/ja_JP.eucJP/books/faq/* .
+
+# At install time the www/en/doc/ directory has been populated, so we can
+# link in to there instead.
+install:
+ [ -d ${DOCINSTALLDIR} ] || ${MKDIR} ${DOCINSTALLDIR}
+ cd ${DOCINSTALLDIR}; \
+ ${LN} -fs ../doc/ja_JP.eucJP/books/faq/* ${DOCINSTALLDIR}
+
+.include "${WEB_PREFIX}/share/mk/web.site.mk"
diff --git a/ja/Makefile b/ja/Makefile
index 54e30ca8fe..cd2896a686 100644
--- a/ja/Makefile
+++ b/ja/Makefile
@@ -1,93 +1,98 @@
-# $FreeBSD: www/ja/Makefile,v 1.57 2002/01/04 04:59:20 kuriyama Exp $
+# $FreeBSD: www/ja/Makefile,v 1.58 2002/02/11 09:53:56 kuriyama Exp $
# The FreeBSD Japanese Documentation Project
-# Original revision: 1.77
+# Original revision: 1.83
.if exists(../Makefile.conf)
.include "../Makefile.conf"
.endif
.if exists(../Makefile.inc)
.include "../Makefile.inc"
.endif
# These are turned into validated, normalized HTML files.
DOCS= applications.sgml
DOCS+= auditors.sgml
DOCS+= availability.sgml
DOCS+= docs.sgml
DOCS+= features.sgml
DOCS+= register.sgml
DOCS+= internet.sgml
DOCS+= mailto.sgml
DOCS+= publish.sgml
DOCS+= relnotes.sgml
DOCS+= send-pr.sgml
DOCS+= support.sgml
DOCS+= where.sgml
DOCS+= y2kbug.sgml
# Japanese-only file
DOCS+= jabout.sgml
# These will be directly installed.
#DATA= favicon.ico
#DATA+= robots.txt
+#DATA+= freebsd.css
# Subdirectories
# SGML
SUBDIR= security
SUBDIR+= commercial
SUBDIR+= docproj
SUBDIR+= news
+#SUBDIR+= advocacy
SUBDIR+= internal
SUBDIR+= java
SUBDIR+= copyright
SUBDIR+= search
SUBDIR+= gallery
SUBDIR+= projects
-#SUBDIR+= prstats
+SUBDIR+= prstats
SUBDIR+= platforms
SUBDIR+= releases
+#SUBDIR+= releng
SUBDIR+= smp
SUBDIR+= conspectus
+#SUBDIR+= gnome
+#SUBDIR+= donations
.if !defined(WEB_ONLY) || empty(WEB_ONLY)
SUBDIR+= ports
SUBDIR+= doc
# .endif
# .if defined(BUILD_RELNOTES)
# SUBDIR+= relnotes
-# .endif
-#
-# # These *must* be listed after the "doc" subdir, as they create symlinks
-# # in to it.
-# .if !defined(WEB_ONLY) || empty(WEB_ONLY)
+.endif
+
+# These *must* be listed after the "doc" subdir, as they create symlinks
+# in to it.
+.if !defined(WEB_ONLY) || empty(WEB_ONLY)
SUBDIR+= tutorials
-DOCSUBDIR= FAQ handbook
+#DOCSUBDIR= FAQ handbook
.endif
# Non-SGML
#SUBDIR+= gifs
#SUBDIR+= cgi
SGMLFLAGS= -links -hdr ${.CURDIR}/doc.hdr -ftr ${.CURDIR}/doc.ftr -e EUC-JP
WEBDIR= data/ja
# index.html is special, and generated from index.xsl and news/news.xml
DATA+= index.html
CLEANFILES+= index.html
index.html: index.xsl news/news.xml news/press.xml includes.xsl news/includes.xsl
${XSLTPROC} ${XSLTPROCOPTS} -o index.html \
${.CURDIR}/index.xsl ${.CURDIR}/news/news.xml
.if !defined(NO_TIDY)
-${TIDY} ${TIDYOPTS} ${.TARGET}
.endif
### Revision checking
REVCHECK= yes
.include "${WEB_PREFIX}/share/mk/web.site.mk"
diff --git a/ja/docproj/submitting.sgml b/ja/docproj/submitting.sgml
index 38533cf1df..bb8b026b81 100644
--- a/ja/docproj/submitting.sgml
+++ b/ja/docproj/submitting.sgml
@@ -1,148 +1,148 @@
-
+
%includes;
]>
-
+
&header;
ドキュメンテーションを書きました. どうやって寄稿すれば良いの?
はじめに、
ドキュメンテーションを書く作業に時間を割いてくださったことを感謝します。
レビューのために、ドキュメンテーションを公開する必要があります。
もし可能なら、ドキュメンテーションを FTP や Web のサイトに置いてください。
それから、 -doc メーリングリストへドキュメンテーションの概要と公開場所、
コメントの送り先を記したメッセージを投稿してください。
理由があってドキュメントをFTPやウェブサイトにおけないときは、
-doc メーリングリストに直接おくってもいいです。
その時はプレインテキストでだけお願いします。
そのメッセージを他の適切なメーリングリストに cc:
した方がよい場合も多いでしょう。
例えば、そのドキュメンテーションが、
ソースツリーを最新の状態に保つための CVSup
の使用法について言及しているなら、
その内容は FreeBSD-current や FreeBSD-stable
メーリングリストの講読者にとっても興味あるものでしょう。
ドキュメンテーションに目が通され、
読者からの提案を組み入れる機会を得たなら、
ドキュメンテーションを寄稿する準備ができたと言えます。
ドキュメンテーションを寄稿する場合、
ファイルを tar 形式にまとめてください。
ドキュメンテーションが
% tar cf doc.tar one two three
と入力してください。それから tar 形式のファイルを圧縮します。
% gzip -9 doc.tar
doc.tar.gz というファイルが生成されます。
最後にこのファイルがメールプログラムに壊されないようにエンコードします。
% uuencode doc.tar.gz doc.tar.gz > doc.uue
それから、
そのことをドキュメンテーションプロジェクトに知らせる必要があります。
御使用のマシンにもインストールされているはずの
send-pr というコマンドを使うのが正しい方法です。
このコマンドを使うのは、
あなたが寄稿したことを後から確認することができるからです。
PR (Problem Report) を送ると、それぞれに固有な番号が割り当てられます。
その後、Commiter の誰かがその PR を担当し、
新しいドキュメンテーションの commit
に関してあなたに連絡することになります。
send-pr 自体は非常に単純です。ちょっと特殊な形式の e-mail
を特定のアドレスに送るだけだからです。
send-pr を走らせると、エディタ (多分 vi か
emacs でしょう) が立ち上がり、
記入用のテンプレートと記入方の説明が表示されるはずです。
"Category" を "docs" に、"Class" を "change-request"
に設定してください。先に作っておいた .uue
ファイルをPR に含めましょう。
エディタを終了させると、PR は e-mail として正しい場所へ送られます。
いくらもしないうちに、あなたが送った PR
の番号を伝える確認のメッセージが送られてくるはずです。
この番号は進展状況を確認するのに使用することができます。
また、
http://www.FreeBSD.org/send-pr.html
の web インタフェースを使用することもできます。
既存のドキュメンテーションに変更を加えました。
どうやって寄稿すれば良いの?
繰り返しになりますが、お時間を割いてくださったことを感謝します。
まず最初に、diff
と呼ばれる特殊なファイルを生成する必要があります。
この diff は、あなたが施した変更点を正確にあらわしています。
Diff を使えば、commit を行う人は変更点を容易に知ることができ、
したがって、どこを変更したのか説明するのに時間を浪費しなくてすみます
(もちろん、
なぜその変更をした方がよいと考えるのかについては説明する必要があるのですが)。
'diff' をつくるには,
変更するファイルのコピーを作ってください。
もし
% cp foo.sgml foo.sgml.old
それから、foo.sgml を変更します。
% vi foo.sgml
... えーと、ここをこうして、こう変えて ...
... 変更点を点検して、誤字がないか確認して、むにゃむにゃむにゃ ...
diff をつくります. それ用のコマンドは以下のようになります。
- % diff -c foo.sgml.old foo.sgml > foo.diff
+ % diff -ru foo.sgml.old foo.sgml > foo.diff
二つのファイルの相違点を調べ、それらを
プロジェクトへ
FreeBSD
ドキュメンテーションプロジェクトのページ
&footer