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で書かれています。

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;' → '@'
  

  この表記はページの名前のなかでも使えます。

FAQ(ありがちな質問とその答え)

• 新しいページのつくりかた？
• uploadしたファイルの消し方？
• Edit Conflict とは？ 対処法？
• 間違えて台なしにしたページの直し方？
• 画像が表示されないのはなぜ？
• 文字に色をつけるには？
• 中央寄せのやり方？

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

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

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

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

Edit Conflict とは？ 対処法？

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

間違えて台なしにしたページの直し方?

過去のすべてのバージョンが保存されています。壊れてしまったページを 出して history ボタンをクリックします。壊れる直前のバージョンを探し出 してその内容を別ウィンドウを使ってそのページの編集画面にコピーして保存 して下さい。

画像が表示されないのはなぜ？

いくつかの可能性が考えられます。まず画像はGIF, JPEG, PNG のいずれか のフォーマットでなければいけません。他のBMP, PDF, pict などを扱えな いブラウザはかなりあります。次にファイルには正しい拡張子(.gif, .jpeg, .jpg, .png)が必要です。そうしないとサーバはこれらを画像データとは扱っ てくれません。拡張子を付け替えるだけでは画像フォーマットを変換すること はできません。

文字に色をつけるには？

HTML タグが使えます。文字に色をつけるには普通 FONT タグを使います。 例えば文字を緑色にしたい時は <font color="green">緑の文字</font> と書きます。

中央寄せのやり方？

中央に寄せたいものを <p align=center> と　</p> で囲っ て下さい。