WikiCreole 1.0 proposal和訳

Jun 18, 2007 From: tsukamoto@g...

ご無沙汰しています。塚本です。
WikiCreole 1.0のproposalを和訳しました。以下においてあります。

http://okilab.jp/project/document/japanate/wikicreole/

WikiCreoleについては、江渡さんのメールや、yomoyomoさんのエントリを参照し
ていただくのが良いと思います。

http://qwik.jp/wiki-study/WikiCreole.html
http://d.hatena.ne.jp/yomoyomo/20061204/wikicreole

簡単に言ってしまえば、Wiki記法の標準化の話で、参加者の影響力の大きさなど
から、これまでの標準化の轍は踏まず、うまくいくかもと期待されているようです。
上記時点で0.2版だったものが0.3版、0.6版(この後0.7版も出て破棄されたらし
い)と版を重ねてきて、現在は1.0版が提案されています。June 19, at 22:00
UTCからIRCミーティングが行われ、Wednesday morning, June 20に1.0版が発行
されるようです。
Additionsぐらいまでは訳さないと一揃いとはいかなそうですが、IRCミーティン
グ前に読めることに意味はあると思い、ひとまず公開します。

なお、1.0版発行後には、和訳も更新するつもりでいます。
上記URLのものを置き換え、現在のものは別のURLに移動するつもりですので、上
記URLのままで変わらないと思ってもらって良いと思います。

相変わらずな英語力で「こんな内容だろう」とかいいながら訳していますので、
誤訳や、不適切な(分かりにくい)訳などについては、コメントをもらえると嬉
しく思います。
よろしくお願いします。


塚本 牧生 <tsukamoto@g...>

Jun 19, 2007 From: 2007@e...

江渡です.

WikiCreole 1.0のproposalを和訳しました。以下においてあります。 http://okilab.jp/project/document/japanate/wikicreole/

御苦労様です.大変参考になります.読んでいてよくわかならない部分があり
ましたので下記にまとめてみました.塚本さん宛にしようかと思いましたが,
どうせなので全員に送ってしまいます.


WikiCreole: Creole 1.0

クレオールマークアップをきれいにしようと書き手が望んだのであれば、 そのために任意に行頭の空白を使うことができます。

行頭に任意の空白があっても無視されるということかな.
リストの深さはどの程度まで許容するのかな.無制限に許容する?

3 つの異なるサイズのレベルの見出しだけが要求されます。

レベルは6までだが,文字サイズは3種類,レベル3までの変化でよいというこ
とか.そうするとレベル3,4,5,6は見た目に区別されなくて良いということか?

URLの末尾にある句読点(,.?!:;"')は、URLの一部とみなすべきではありません。

何をURLのデリミタとするべきかという話か.閉じ括弧はどうなんだろう?
(これはYahooのページです→http://www.yahoo.co.jp/)
という時に,「http://www.yahoo.co.jp/)」というURLに解釈するのが正しいのか?

MyBigPagecreate http://www.wikicreole.org/create

URLが先で説明が後という関係か.この順番は議論にならなかったのかな?
あと,いわゆるWikiNameによるリンクはどうなんだろう.このサポートも任意か.

推奨し手いた

→推奨していた

は知らせるか

→走らせるか

私達はこの方式でblogスタイルの改行の経験が増加することを望んでいます。 blogスタイルの改行モードでは、強制改行記法はサポートされなければいけな く、したがって人々が強制改行文字を持つWikiからテキストをコピーしたとき に改行は適切に移行されます。

このパラグラフの意味がよくわかりませんでした.

三十の

→三重の

nosuch plugin | myimage.png|this is my image

プラグイン記法とどう同居すればいいのかなぁ.

Placeholder より進んだものである時は、プレースホルダが現れるので、ユーザは一つ以上の記法を見て混乱することがなくなります(Wiki開発者にとっては任意です)。 ノート: これとAdditionsにあるplug-inの記法で混乱しないように。

これがよくわからなかった.プラグインみたいなことを意味するのかと思った
が,それはAdditionsで別に規定されているんですよね.

This is the only new markup introduced in Creole.

このへんみても,さらによくわからなくなった.もう少し考えてみます….

Jun 20, 2007 From: tsukamoto@g...

塚本です。

江渡さんからメールでいただいた修正点、zokkonさんからwalrus.vox.comのコメ
ント欄でいただいた修正点を修正しました。
ありがとうございました。

塚本さん宛にしようかと思いましたが,どうせなので全員に 送ってしまいます.

間違ったまま知られてしまうより、「ここは間違い」とか「間違いもあったらし
い/直したらしい」とか認識してもらえた方がベターです。
そうしていただけて、良かったと思います。

クレオールマークアップをきれいにしようと書き手が望んだのであれば、 そのために任意に行頭の空白を使うことができます。

行頭に任意の空白があっても無視されるということかな. リストの深さはどの程度まで許容するのかな.無制限に許容する?

行頭の空白は、その通りです。訳文を、原文にない意味を出したりしない範囲
で、改めてみました。...うーん、作文しちゃってるかな...。
リストの深さは「5段階までのネストの深さをサポートすることが推奨」です。

3 つの異なるサイズのレベルの見出しだけが要求されます。

レベルは6までだが,文字サイズは3種類,レベル3までの変化でよいというこ とか.そうするとレベル3,4,5,6は見た目に区別されなくて良いということか?

ここは、私も良く分かりませんでした。
なんで「Only three different sized levels of headings are required」と
言ってるのに、例がレベル6まであるんだろう。

URLの末尾にある句読点(,.?!:;"')は、URLの一部とみなすべきでは ありません。

何をURLのデリミタとするべきかという話か.閉じ括弧はどうなんだろう? (これはYahooのページです→http://www.yahoo.co.jp/) という時に,「http://www.yahoo.co.jp/)」というURLに解釈するのが 正しいのか?

デリミタと言ってしまうと、URLの途中にこれらが入るケースがある(よく見る
ところではCNETの記事)ので、ちょっとまずいかもですね。やはりURLを検出し
て、その上で末尾にカンマそのほかがあったら、無視しろ、だと思います。
閉じ括弧は同じく無視されるべきだと思うんだけど、無視しろとは書いてないで
すね...。

URLが先で説明が後という関係か.この順番は議論にならなかったのかな? あと,いわゆるWikiNameによるリンクはどうなんだろう.このサポートも 任意か.

URLが先、Wikipedia式ですね。個人的には馴染まないですが。
WikiName(本文中に出てくる用語だとCamelCase)のサポートは任意みたいで
す。エスケープ文字の項からは、そう思われます。

私達はこの方式でblogスタイルの改行の経験が増加することを望んで います。blogスタイルの改行モードでは、強制改行記法はサポート されなければいけなく、したがって人々が強制改行文字を持つWikiから テキストをコピーしたときに改行は適切に移行されます。

このパラグラフの意味がよくわかりませんでした.

・wikiスタイル標準としますが、みんなblogスタイルも経験してみてください。
・blogスタイルでも、強制改行記法(\\)は有効になるよう実装してください。
→wikiスタイルのページ、他のWikiからコンテンツをコピペしてもOKなように。

という二つの話をしていると思います。実にひどい訳でした。
それほど良くなったとはいえないですが、訳文を、改めてみました。

nosuch plugin | myimage.png|this is my image

プラグイン記法とどう同居すればいいのかなぁ.

Additionsによれば、プラグイン記法は、下のようになるようです。

<<CurrentTimePlugin format='yyyy.MM.dd'>>

...という話じゃなくて、「プラグイン記法を、nosuch plugin | に埋め込んでいいのか
なぁ」という話でしょうか?
そういう意味だと、埋め込むことはあまり考えてなさげに感じる...。

Placeholder より進んだものである時は、プレースホルダが現れるので、ユーザは一つ以上の記法を見て混乱することがなくなります(Wiki開発者にとっては任意です)。 ノート: これとAdditionsにあるplug-inの記法で混乱しないように。

これがよくわからなかった.プラグインみたいなことを意味するのかと思った が,それはAdditionsで別に規定されているんですよね.

実は私も良く分からなかった...のだけど、Wikipediaの云々といっているので、
Wikipediaのテンプレート(「このページは○○に関する書きかけです云々」を
nosuch plugin | ○○-stubと書けるやつ)かな、と思っています。
ディスカッションを読みこなせるともうチョイはっきりした答えが出せるかもし
れないのですが、ざっと眺めると「MoinMoinのマクロはTableOfContents(3)create
みたいな感じ」とか言ってたりするので、多分そうじゃないかな。

英語OKな方とか、Wikipedianな方とか、コメントやサジェストなどいただけると
助かります。


塚本 牧生 <tsukamoto@g...>

Jun 21, 2007 From: tsukamoto@g...

塚本です。
WikiCreole 1.0ですが、7月3日まで議論継続、次回IRCミーティングは26日(火)
となったようです。

Discussion will continue until 2007-Jul-03. Our next IRC meeting will be on Tuesday, 2007-Jun-26, 21:00 GMT.

「和訳の方も20日に更新予定」とアナウンスしてしまっていたので、ひとまずご
報告です。

ちょっと更新が必要になるまでに、余裕ができましたね。
できればその間に、プラグインなどの追加が議論されている記法が載っている
Additionsと、早見表であるcheet sheetを訳しておきたいのだけど...

http://wikicreole.org/wiki/CreoleAdditions
http://wikicreole.org/wiki/CheatSheet

...できるかな?


塚本 牧生 <tsukamoto@g...>

Jun 21, 2007 From: suisui@g...

Suisuiです。

07/06/20 に Makio Tsukamoto<tsukamoto@g...> さんは書きました:

クレオールマークアップをきれいにしようと書き手が望んだのであれば、 そのために任意に行頭の空白を使うことができます。

行頭に任意の空白があっても無視されるということかな. リストの深さはどの程度まで許容するのかな.無制限に許容する?

行頭の空白は、その通りです。訳文を、原文にない意味を出したりしない範囲 で、改めてみました。...うーん、作文しちゃってるかな...。 リストの深さは「5段階までのネストの深さをサポートすることが推奨」です。

要するに

項目

 ** サブ項目
    *** サブサブ項目
 ** サブ項目2

という書き方を許容したのだと思いますが

   * 項目
** サブ項目
            *** サブサブ項目
           ** サブ項目2

これも同じxhtmlを吐くのであれば許容は改悪に思えますね。
どんなに自由度を低くしても想定と違う使い方する人は現れるのにねぇ。
あと、空白文字の定義はASCIIで0x20なのでしょうか。
いわゆる\sではだめなのかな。

3 つの異なるサイズのレベルの見出しだけが要求されます。

レベルは6までだが,文字サイズは3種類,レベル3までの変化でよいというこ とか.そうするとレベル3,4,5,6は見た目に区別されなくて良いということか?

ここは、私も良く分かりませんでした。 なんで「Only three different sized levels of headings are required」と 言ってるのに、例がレベル6まであるんだろう。

xhtmlとcssの話のつもりなのではないでしょうか。
xhtmlは6段階分けとけと
あとはユーザーでcssを設定してねということだと思います。
wikiはhtmlのレンダリングエンジンではあるけれども
cssはユーザー個別に定義するもの、という考えを素直に反映したのだと思います。
それがきちんと書かれていないあたりwiki でつくってる規格だなぁと感じます。

URLが先、Wikipedia式ですね。個人的には馴染まないですが。 WikiName(本文中に出てくる用語だとCamelCase)のサポートは任意みたいで す。エスケープ文字の項からは、そう思われます。

MediaWiki式と呼んでやってください(笑)
WikiNameリンクはroman alphabetでの文字表記が
一般的でない言語も多くありますし
語尾活用のある言語では無力なうえ、
文章中に大文字で単語を始めるのは不自然な言語が多いですから
どちらかというと無い方がすっきりすると思います。

>拠: ユーザーにはWikiエンジンによって整形されないテキストの入力方法があるべきです。三重の曲括弧( nosuch plugin | {}{{br}} )は、その視認性と、"code"それ自体の中でも出現しそうにないことから選ばれました。

http://ja.wikipedia.org/w/index.php?title=Template:%E5%9F%BA%E7%A4%8E%E6%83%85%E5%A0%B1_%E5%9B%BD&action=edit
MediaWikiではテンプレートの引数がnosuch plugin | {name} です。
混ざることは多分ないと思いますがこれすごいややこしいなあ。
なさそうな記述ってほんとに調べたのかなぁ。。

見出し 3つの異なるサイズのレベルの見出しだけが要求されます。 閉じる(右側の)等号は任意で、バランスをとる必要はなくて、 発生する見出しの種類に影響を与えません。 左側の等号の前には空白は許されません。

原文もそうですが

こういう規格で左右を使って書いてはいけません。
rtlの環境もあるからです。
http://yi.wiktionary.org/ で編集ボタン(上タブ 右から三番目)
をクリックしてみてください。
文脈上左右をどうしても入れたいのであれば
ltrな言語についての記述であることを明記しないと
規格として使い物にならないんじゃないでしょうか。

Placeholder より進んだものである時は、プレースホルダが現れるので、ユーザは一つ以上の記法を見て混乱することがなくなります(Wiki開発者にとっては任意です)。 ノート: これとAdditionsにあるplug-inの記法で混乱しないように。

これがよくわからなかった.プラグインみたいなことを意味するのかと思った が,それはAdditionsで別に規定されているんですよね.

実は私も良く分からなかった...のだけど、Wikipediaの云々といっているので、 Wikipediaのテンプレート(「このページは○○に関する書きかけです云々」を nosuch plugin | ○○-stubと書けるやつ)かな、と思っています。 ディスカッションを読みこなせるともうチョイはっきりした答えが出せるかもし れないのですが、ざっと眺めると「MoinMoinのマクロはTableOfContents(3)create みたいな感じ」とか言ってたりするので、多分そうじゃないかな。

When there is something advanced, a placeholder will show up, so users
will not be confused seeing more than one syntax. (optional for wiki
developers)

何か拡張機能があるときにはかならずプレースフォルダが現れるので
そこで初心者が戸惑うことはない。開発者もね。

程度の意味だと思います。
プレースフォルダが出てきたら知らない機能だと思え
ということなのかとおもいましたが
自由度たかそうなのでかえって混乱が広がる
拡張だと私は思いますね。
あっちのウィキでは<<< calendar>>> なのに
こっちでは<<< カレンダー>>> とか<<< カレンダ>>> とか <<<C_Month>>> とか
ウィキの持ち主に自由度を与えないことでかえって混乱するんじゃないかなぁ。

あまり時間がないので雑ですがこれにて。

Suisui
suisui@g...

Last modified: 2007-06-21 Attached files total: 1MB