nishis Swiki: ヘルプガイド

Swiki ヘルプガイド

Swikiについて
Swikiの歩き方
編集の仕方
FAQ(ありがちな質問とその答え)

Swikiについて

Swikiへようこそ! Swikiは皆んなで作る(collaborative) websiteです。誰もが内容を変えたり新しいページを作れます。これは、一見危険なように思えるかも知れませんが驚く程パワフルです。互いに書いたり会話することについては、目からウロコものでしょう。他の人のページを汚したり、無駄な書き込みはやめて、みんなのためになるように心掛けましょう。（紳士協定での運営なのだ）

Swiki は Squeak　(オープンな Smalltalk-80のリメイク版) の上で動作しています。

Swikiは、Ward Cunninghamによる WikiWikiWeb にヒントを得ています。 Wiki はMark Guzdial's Collaborative Software Laboratory at the Georgia Institute of Technology によってSqueakに移植されました(Squeak + Wiki = Swiki) 。

（原文にはない追記）なおSwikiは、ComancheというプラグダブルなWeb Serverの上で動作しています。Comancheも当然Smalltalkで書かれています。

Comanche 5.0 / Swiki 1.3

Swikiの歩き方

ウェブブラウジングをしたことがあれば、Swikiの操作はとても簡単です。拡張機能が唯一の違いです。

	View: 'View' ボタンを押すと（訳注:編集画面などから）内容表示画面に戻ります。
	Edit: このボタンでページの内容とタイトルを変更するテキストボックスが開きます。 '保存' ボタンを押すと変更が保存されます。また、ユーザーはパスワードを設定して他人の変更を禁止(ロック)することもできます。 passwordを忘れないように。 administrator（管理者）(少なくともそのpassword)だけがページのロックを解除できます。また、あなたの e-mail address を登録しておけばページが変更される度に message(アラートメール）が届きます。下の ('記述法Text Formatting Rules')をよく読んでどんな内容を作れるか覚えて下さい。
	Edit (locked): ロックされたページです。このページを変更するにはページのパスワードかadministrator のパスワードが必要です。ロックされたページを変更した後は再びロックされます。administrator のパスワードでは編集／保存できますがページ毎のpasswordはそのまま保持されます。
	Attachments: この機能を使うとユーザはデータをサーバにupload できます。アップロード先は、そのページかそのSwikiかになります。ページへのアップロードの場合には、そのページからのみアップロードファイルを参照することができます。アップロードファイルへのLinkを張るには+myattachment+ を文章中に記入するか uploadの際に add　a reference オプションを選択しておけば自動的にページの最後に link　が作成されます。画像ファイル（末尾が gif, jpg, jpeg, か png）の場合は画像が埋め込まれます。（注：通常のアップロードファイルは、クリックするとダウンロードされる形式でリンクが生成されます。但し、よく使われる形式の画像ファイルでは、IMGタグに展開されて、その場で表示されるようになります）
	History: このページの過去のバージョンを表示します。ページは変更されるため以前の内容を確かめたり、どこが修正されたかを見ることはしばしば役に立ちます。
	Top: 'Top' ボタンを押すとこのSwiki のtop (最初のページ) に戻ります。
	Recent Changes: この機能は最終変更時間順のページ一覧を新しいものから表示します。どのページが更新されたかを知りたい時に大変便利です。
	Search: 'Search' で指定した語句を含むページを検索します。指定された語句にピッタリ一致するすべてのページが検索されます。
	Help: 今見ているこのHELP画面に戻ります。
...	URLの推測: ページの名前は憶えていても（うろ憶え？）ページ番号がわからないことがよくあります(訳註；linkはページ番号で管理されます)。検索をかけたり、あちこちをブラウズしなくても大丈夫です。ページの名前の一部をブラウザのURL欄の Swikiアドレスの後ろに入力して下さい。語句の区切りにスペースは使えないので語句の先頭を大文字にします（例えばSmalltalk)。 Swiki は最初に一致したページを表示します。例えば、'myswiki/iWantCandy' と入力すると　'The candy I want for Halloween'　の名前のページが表示されることになります。もちろんいつもうまくいくとは限りません。別のページが表示されることもあるし、見つからない時は振出しに戻ります。(注：多分、日本語の場合はエスケープしないとだめでしょう。）
...	レンダリング:administratorは Swikiの内容を通常の web siteの形式に変換することができます。これは信頼性(reliability)や汎用性(portability)が重視される時に利用できます。通常のユーザにはこの機能は解放されていませんが、ここで見ることはできます。注意：変換(rendering)には時間とリソースが必要なので traffic が少ない時に行ったほうがいいでしょう。

Swikiには単純な記述法があります。ページへのリンクを作るにはページの名前を *で囲みます（例えば　*My Page*）; この名前のページがまだ無い時は create がページ名の後ろに表示されます。この 'create' をクリックすると新しいページができます。以下に詳しい記述法(complete editing features)を示します。　これらの機能を使いこなして下さい(these features are meant to enhance your use)。でも、知っていなくても支障なく使い始められます。

改行は反映されます。Carriage returns are preserved.
'!'で始めた行は見出し行になります。'!' を重ねるほど大きくなります。例えば　'!!subject'　はHTMLの '<h2>subject</h2>' になります。'!' は３個まで使えます。
'_' (an underscore)で始めた行は横線になります。話題を区切るのによく使われます。
'#' や '-' で始まる行はリスト（箇条書き）になります。
- '-' で始まる一連の行は丸付きのリスト（箇条書き）になります。
- '#' で始まる一連の行は連番付きのリスト（箇条書き）になります。
- リストは入れ子にできます。'#-' で始まる行は連番付きリストに含まれた黒丸付きリストになります。
table (表)を作るには '|' で行を始め、項目を '|' で区切ります。改行すると表の次の行になります。
整形済み (preformatted) の行は '=' でそれぞれの行を開始します。整形済み行は等幅フォントで表示されます。
'+' で始まる行は「ここにご記入下さい ('add to this page')」になります。こうすると文章中にテキスト入力ウィンドウが表示され、ユーザが文章を入力できるようになります。この機能はページ内容を削除できなくしたい時にも使えます。'+' 行を作っておき、ページをロックしておけば追記はできますが削除はできなくなります(訳註；passwordでロックを解除すれば削除も可)。
リンクを作るには '* で囲みます。
- Swiki内にすでに存在するページの場合は（保存後に)そのページへのリンクになります (例 *A Valid Page Name*)。
- ページがまだない場合は 'create' リンクができます。ここをクリックすると実際に新しいページができて内容の編集に進みます。
- 外部へのリンク(例えば *http://minnow.cc.gatech.edu/swiki*) ならそこへのリンクになります。
- もし画像へのリンク( 'gif', 'jpeg', 'jpg', 'png' で終わる)ならそこに画像が表示されます。
- メールアドレスなら(例えば. *self@mail.me.com*) そこに送るメール作成になります。
- anchors (ページ内ジャンプ先)は '@' を行頭につけ '@My Section' のよう指定します。そうしておけば '*' と '@' でリンクを作れます。'*My Valid Page@My Section*' は My Valid Page 内の 'My Section' へのリンクになります。同じページの中でのジャンプならページ名は省略して *@My Section* で大丈夫です。
- '>' を使ってリンクに別名 (alias)を付けることもできます。*My Alias>A Valid Page Name* とすると表示は 'My Alias' になりますが 'My Valid Page Name' へのリンクになります。画像に題名などを付けるのにも使えます。
HTML も使えます。便利な HTML tags を紹介します。
- 太字 (bold)にするには, '<b>' と '</b>' で囲みます。
- 斜体 (italics)にするには、 '<i>' と '</i>' で囲みます。
- 下線を引く (underlined)には、 '<u>' と '</u>' で囲みます。
他のプログラムからHTMLファイルを読み込み(import)たい場合は、' <html>' と '</html>' で HTMLデータを囲めば Swikiの独自formatting rule は適用されません。
uploadしたファイルへリンクするには '*+' と '+*' で囲みます。'*+myupload.html+*' は uploadした 'myupload.html' ファイルへのリンクになります。もしファイル名が 'gif', 'jpeg', 'jpg' で終わっていれば画像として埋め込まれます。
HTMLでは　&, <, >　の３文字は特別に扱われます。Swikiではさらに　*, @　の２文字も特別に扱われます。これらの文字をそのまま表示させるには次のようにします。
```
表記  →  表示
'&amp;' → '&'、　'&lt;' → '<' 、 '&gt;' → '>'
、'&star;' → '*' 、'&at;' → '@'
```
この表記はページの名前のなかでも使えます。

新しいページのつくりかた？

まず、入り口とするページを表示し、そのページを表示します。その中に「*新しいページ名*」と入力し保存します。「新しいページ名」のすぐ後に create のリンクが表示されます。それをクリックすると新しいページが出来上がります。こうするのは、ただ単に新しいページを作るだけではなくそこへのリンクも同時に作れば他の人が新しいページを見つけ易くなるからです。

uploadしたファイルの消し方？

結論から言えば削除はできません。同じ名前で別のファイルを uploadすれば新しいファイルが参照されるようになります。uploadしたファイルの削除がどうしても必要なら管理者(system administrator)に相談して下さい。

Edit Conflict とは？対処法？

edit conflictとは別の人が同じページをあたなより先に保存したとサーバが思った時に発生します。そのような時にあなたが保存処理を続けた場合には他の人の書き込みに上書きしてしまう恐れがあります。あなたには自分の編集結果と最終保存内容の両方が提示されるのでその２つをまとめ上げて下さい。 edit conflictが実際に発生することはほとんどありません。しかし、特定のブラウザ（主にMSIE）では [戻る] ボタンをクリックした時のキャッシュの管理がうまく出来ません。この場合はただ単にsave をクリックして下さい。このようなトラブルを未然に防ぐには編集画面に戻るのに [戻る] ボタンを使わないようにして下さい。