Author: mumumu
Date: Thu Aug 9 01:55:18 2007
New Revision: 912
Log:
- complete wiki section.
Modified:
trunk/ja/ch03.xml
Modified: trunk/ja/ch03.xml
==============================================================================
--- trunk/ja/ch03.xml (original)
+++ trunk/ja/ch03.xml Thu Aug 9 01:55:18 2007
@@ -4475,13 +4475,13 @@
<para>
<firstterm>wiki</firstterm>とは、
訪れた人が誰でもコンテンツを編集し、
- 拡張できるWebサイトのことです。
+ 拡張できるウェブサイトのことです。
"wiki" (ハワイ語で "素早い" とか "超高速の"という意味です）という用語は、
- Webサイトの編集ができるソフトウェアを指すものとしても使われています。
+ ウェブサイトの編集ができるソフトウェアを指すものとしても使われています。
Wikiは1995年に発明されましたが、
2000年か2001年に人気が出て、
wikiベースな無料の百科事典である Wikipedia(<ulink
url="http://www.wikipedia.org/"/>)の成功がそれを後押ししました。
- wikiは、IRCとWebサイトの中間的なものと考えればよいでしょう。
+ wikiは、IRCとウェブサイトの中間的なものと考えればよいでしょう。
wikiは即時性がないので、
自分が更新する内容について推敲することができます。
それでいて更新も非常に簡単なので、通常のwebサイトを編集するのに比べて、
@@ -4526,7 +4526,7 @@
<para>
wikiを使おうと決めたら、
見通しの良いサイト構成にすることと、
- 魅力的な見た目になるように特に努力するようにしましょう。
+ 魅力的な見た目になるように特に力を注ぎましょう。
これは訪問者（i.e. 編集する可能性がある人でもあります）が無意識にどのように編集したらよいかがわかるようにするためです。
同じく重要なのは、
人々を誘導できるように、
@@ -4534,16 +4534,15 @@
よくあるのは、
wikiの管理者が、
「多くの訪問者が高い品質のコンテンツを個別に追加してくれているんだから、
- こうした更新が集まったWebサイト全体も高い品質であるに違いない」という幻想に堕ちてしまうことです。
+ こうした更新が集まったウェブサイト全体も高い品質であるに違いない」という幻想に堕ちてしまうことです。
多く更新されているからといって、
- Webサイトがうまく機能するわけではありません。
+ ウェブサイトがうまく機能するわけではありません。
個々のページや段落は、
それ自体素晴らしいものかもしれませんが、
全体が混乱したり、
- まとまっていないウェブサイトに紛れ込んでしまうと、
- 素晴らしいものではなくなるでしょう。
+ まとまっていないウェブサイトに紛れ込んでしまうと、そうではなくなるでしょう。
wikiを使うと、
- 次のような事態に頻繁に悩まされます。
+ 次のような事態によく悩まされます。
</para>
<!--
@@ -4581,7 +4580,7 @@
<listitem>
<para>
<emphasis role="bold">読者を誘導するルールが欠けている</emphasis>
- うまく構成されたWebサイトは、
+ うまく構成されたウェブサイトは、
訪問者がいつでもサイト内のどこにいるかをわかるようにしています。
例えば、ページがうまく設計されていると、
訪問者は"目次"の部分と、"内容"の部分を直感的に区別できます。
@@ -4601,16 +4600,17 @@
</listitem>
<listitem>
<para>
- <emphasis role="bold">対象とする読者が決まっていない</emphasis>
+ <emphasis role="bold">対象読者が決まっていない</emphasis>
これは、更新を行なう人が多くいる場合にはある程度避けられない問題です。
しかし、コンテンツを追加する方法の指針があれば、
- この問題で苦労することは少なくなるかもしれません。
+ この問題で苦しむ可能性は少なくなる可能性があります。
また、更新に関する指針が根付くように、
はじめから例としてコンテンツをたくさん追加しておくのもよいでしょう。
</para>
</listitem>
</itemizedlist>
+<!--
<para>The common solution to all these problems is the same: have
editorial standards, and demonstrate them not only by posting them,
but by editing pages to adhere to them. In general, wikis will
@@ -4619,7 +4619,20 @@
set up the wiki and hope everything falls into place. You must also
prime it with well-written content, so people have a template to
follow.</para>
+-->
+
+<para>
+ こうした問題に対する共通の解は同じです。: 編集に関する指針を作り、
+ その指針をwikiに投稿するだけではなく、
+ それに従ってページを編集することです。
+ 一般にwikiは、更新する人が自分が見るページのあらゆる傾向を真似てしまうため、
+ もともと存在するページにあらゆる不備が全体に伝染していきがちです。
+ wikiをただセットアップするだけで、全てうまくいくと期待しないでください。
+ まずは、人々を誘導するテンプレートとなるように、
+ よく練られたコンテンツを置いておかなければならないのです。
+</para>
+<!--
<para>The shining example of a well-run wiki is Wikipedia, though this
may be partly
because the content (encyclopedia entries) is naturally well-suited to
@@ -4638,7 +4651,27 @@
common vision. While you may not need the same level of preparedness
to run a wiki for a free software project, the spirit is worth
emulating.</para>
+-->
+
+<para>
+ うまくいっているwikiの良い例はWikipediaですが、これは、
+ （百科事典の項目という）内容が本来wikiのフォーマットとよく合っているからというのが理由のひとつです。
+ しかし、Wikipediaをよく調べてみると、
+ 管理者達が <emphasis>とても</emphasis> 周到な協力の基盤を築いていることがわかるでしょう。
+ 新しい項目を追加する方法、適切な観点で編集する方法、どのような編集を行なうべきか、避けるべきか、
+ 編集合戦にまつわる論争を解決するプロセス（ある段階では、最終的な調停も含みます）、
+ などにまつわる外部文書が存在します。
+ 管理者達は、繰り返し不適切に編集されたページがあった場合に、
+ 問題が解決されるまでそれをロックできるようアクセス制御も行なっています。
+ 言い換えれば、彼らはウェブサイトにページの雛形を書き込むだけで、
+ うまくいくと思っていたわけではないということです。
+ Wikipediaは、創始者達が、どうしたら何千ものどこの馬の骨ともわからない人たちに、
+ 中立的な観点で記事を書かせることができるかを注意深く考えたからこそうまくいっているのです。
+ フリーソフトウェアのプロジェクトでwikiを使うのに、これと同じくらい周到になる必要はないかもしれませんが、
+ その精神は真似る価値があります。
+</para>
+<!--
<para>For more information about wikis, see
<ulink url="http://en.wikipedia.org/wiki/Wiki"/>. Also, the first
wiki remains alive and well, and contains a lot of discussion about
@@ -4647,12 +4680,35 @@
<ulink url="http://www.c2.com/cgi/wiki?WhyWikiWorks"/>, and
<ulink url="http://www.c2.com/cgi/wiki?WhyWikiWorksNot"/> for
various points of view.</para>
+-->
+
+<para>
+ wikiに関するさらに詳しい情報は、<ulink url="http://en.wikipedia.org/wiki/Wiki"/>
を参照して下さい。
+ また、世界で最初のwikiはまだ健在で、wikiの運用に関する多くの議論が含まれています。
+ : 様々な観点から、<ulink url="http://www.c2.com/cgi/wiki?WelcomeVisitors"/>,
+ <ulink url="http://www.c2.com/cgi/wiki?WhyWikiWorks"/>, そして
+ <ulink url="http://www.c2.com/cgi/wiki?WhyWikiWorksNot"/> を参照してみて下さい。
+</para>
</sect1>
<!-- ======================== SECTION ============================== -->
<sect1 id="web-site">
-<title>Web Site</title>
+<title>ウェブサイト</title>
+
+<!--
+<para>There is not much to say about setting up the project web site
+from a technical point of view: setting up a web server and writing
+web pages are fairly simple tasks, and most of the important things to
+say about layout and arrangement were covered in the previous chapter.
+The web site's main function is to present a clear and welcoming
+overview of the project, and to bind together the other tools (the
+version control system, bug tracker, etc.). If you don't have the
+expertise to set up a web server yourself, it's usually not hard to
+find someone who does and is willing to help out. Nonetheless, to
+save time and effort, people often prefer to use one of the canned
+hosting sites.</para>
+-->
<para>There is not much to say about setting up the project web site
from a technical point of view: setting up a web server and writing
@@ -4666,7 +4722,10 @@
save time and effort, people often prefer to use one of the canned
hosting sites.</para>
+
<sect2 id="canned-hosting">
+
+<!--
<title>Canned Hosting</title>
<para>There are two main advantages to using a canned site. The first
@@ -4680,6 +4739,21 @@
stored in the tools. You don't need to make many decisions. All you
have to do is fill in a form, press a button, and suddenly you've got
a project web site.</para>
+-->
+
+<title>ホスティングサイト</title>
+
+<para>There are two main advantages to using a canned site. The first
+is server capacity and bandwidth: their servers are beefy boxes sitting
+on really fat pipes. No matter how successful your project gets,
+you're not going to run out of disk space or swamp the network
+connection. The second advantage is simplicity. They have already
+chosen a bug tracker, a version control system, a mailing list manager,
+an archiver, and everything else you need to run a site. They've
+configured the tools, and are taking care of backups for all the data
+stored in the tools. You don't need to make many decisions. All you
+have to do is fill in a form, press a button, and suddenly you've got
+a project web site.</para>
<para>These are pretty significant benefits. The disadvantage, of
course, is that you must accept <emphasis>their</emphasis> choices and
@@ -4741,6 +4815,8 @@
change.</para>
<sect3 id="canned-hosting-choosing">
+
+<!--
<title>Choosing a canned hosting site</title>
<para>The largest and most well-known hosting site is <ulink
@@ -4756,6 +4832,23 @@
Tigris.org, and I use Tigris regularly.</para></footnote>, give free
hosting to open source projects that fit well with their missions and
their community of existing projects.</para>
+-->
+
+<title>ホスティングサイトを選ぶ</title>
+
+<para>The largest and most well-known hosting site is <ulink
+url="http://www.sourceforge.net/";>SourceForge</ulink>. Two other
+sites providing the same or similar services are <ulink
+url="http://savannah.gnu.org/";>savannah.gnu.org</ulink> and <ulink
+url="http://www.berlios.de/";>BerliOS.de</ulink>. A few organizations,
+such as the <ulink url="http://www.apache.org/";>Apache Software
+Foundation</ulink> and <ulink
+url="http://www.tigris.org/";>Tigris.org</ulink><footnote><para>Disclaimer:
+I am employed by <ulink
+url="http://www.collab.net/";>CollabNet</ulink>, which sponsors
+Tigris.org, and I use Tigris regularly.</para></footnote>, give free
+hosting to open source projects that fit well with their missions and
+their community of existing projects.</para>
<para>Haggen So did a thorough evaluation of various canned hosting
sites, as part of the research for his Ph.D. thesis,
@@ -4768,6 +4861,8 @@
</sect3>
<sect3 id="anonymity">
+
+<!--
<title>Anonymity and involvement</title>
<para>A problem that is not strictly limited to the canned sites, but
@@ -4777,6 +4872,17 @@
then on it keeps a profile for that user, and project administrators
can assign the user certain permissions, for example, the right to
commit to the repository.</para>
+-->
+
+<title>匿名性とプロジェクト参加</title>
+
+<para>A problem that is not strictly limited to the canned sites, but
+is most often found there, is the abuse of user login functionality.
+The functionality itself is simple enough: the site allows each
+visitor to register herself with a username and password. From
+then on it keeps a profile for that user, and project administrators
+can assign the user certain permissions, for example, the right to
+commit to the repository.</para>
<para>This can be extremely useful, and in fact it's one of the prime
advantages of canned hosting. The problem is that sometimes user
_______________________________________________
Producingoss-translators mailing list
[email protected]
http://www.red-bean.com/mailman/listinfo/producingoss-translators
