Missing Alternate TagMissing Alternate TagMissing Alternate TagMissing Alternate TagMissing Alternate TagMissing Alternate TagMissing Alternate TagMissing Alternate Tag

Swiki ヘルプガイド

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

Powered by Comanche
Comanche 5.0 / Swiki 1.3

Swikiの歩き方

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

Missing Alternate Tag View: 'View' ボタンを押すと(訳注:編集画面などから)内容表示画面に戻ります。
Missing Alternate Tag Edit: このボタンでページの内容とタイトルを変更するテキストボックスが開きます。 '保存' ボタンを押すと変更が保存されます。また、ユーザーはパスワードを設定して他人の変更を禁止(ロック)することもできます。 passwordを忘れないように。 administrator(管理者)(少なくともそのpassword)だけが ページのロックを解除できます。 また、 あなたの e-mail address を登録しておけばページが変更される度に message(アラートメール) が届きます。 下の ('記述法Text Formatting Rules')をよく読んでどんな内容を作れるか覚えて下さい。
Missing Alternate Tag Edit (locked): ロックされたページです。このページを変更するにはページのパスワードかadministrator のパスワードが必要です。ロックされたページを変更した後は再びロックされます。administrator のパスワードでは編集/保存できますがページ毎のpasswordはそのまま保持されます。
Missing Alternate Tag Attachments: この機能を使うとユーザはデータをサーバにupload できます。アップロード先は、そのページかそのSwikiかになります。ページへのアップロードの場合には、そのページからのみアップロードファイルを参照することができます。アップロードファイルへのLinkを張るには*+myattachment+* を文章中に記入するか uploadの際に add a reference オプションを選択しておけば自動的にページの最後に link が作成されます。画像ファイル(末尾が gif, jpg, jpeg, か png)の場合は画像が埋め込まれます。(注:通常のアップロードファイルは、クリックするとダウンロードされる形式でリンクが生成されます。但し、よく使われる形式の画像ファイルでは、IMGタグに展開されて、その場で表示されるようになります)
Missing Alternate Tag History: このページの過去のバージョンを表示します。ページは変更されるため以前の内容を確かめたり、どこが修正されたかを見ることはしばしば役に立ちます。
Missing Alternate Tag Top: 'Top' ボタンを押すとこのSwiki のtop (最初のページ) に戻ります。
Missing Alternate Tag Recent Changes: この機能は最終変更時間順のページ一覧を新しいものから表示します。どのページが更新されたかを知りたい時に大変便利です。
Missing Alternate Tag Search: 'Search' で指定した語句を含むページを検索します。指定された語句にピッタリ一致するすべてのページが検索されます。
Missing Alternate Tag 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>' になります。'!' は3個まで使えます。
  • '_' (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では &, <, > の3文字は特別に扱われます。Swikiでは さらに *, @ の2文字も特別に扱われます。これらの文字をそのまま表示さ せるには次のようにします。
    表記  →  表示
    '&amp;' → '&'、 '&lt;' → '<' 、 '&gt;' → '>'
    、'&star;' → '*' 、'&at;' → '@'
    
    この表記はページの名前のなかでも使えます。

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

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

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

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

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

Edit Conflict とは? 対処法?

edit conflictとは別の人が同じページをあたなより先に保存したとサーバ が思った時に発生します。そのような時にあなたが保存処理を続けた場合には 他の人の書き込みに上書きしてしまう恐れがあります。あなたには自分の編集 結果と最終保存内容の両方が提示されるのでその2つをまとめ上げて下さい。 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> で囲っ て下さい。


Powered by Comanche
Comanche 5.0 / Swiki 1.3