ログイン
編集不可のページディスカッション情報添付ファイル
"HowToWriteWiki"の差分

MMA
4と22のリビジョン間の差分 (その間の編集: 18回)
2010-12-17 16:39:00時点のリビジョン4
サイズ: 2395
編集者: chmod
コメント:
2011-06-11 19:30:14時点のリビジョン22
サイズ: 4356
編集者: chmod'
コメント:
削除された箇所はこのように表示されます。 追加された箇所はこのように表示されます。
行 1: 行 1:
## page was renamed from chmod/HowToWriteWiki
## page was renamed from chmod/HowToWirteWiki
行 4: 行 2:
こちらでは,ドキュメンテーションにあたって,特に Wiki 特有の事情に関わることを記します. こちらでは,ドキュメンテーションにあたって,特に Wiki 特有の事情に関わることを記します.<<BR>>
編集については,[[HowToWriteWiki2]]に分割されました.
行 8: 行 7:
== 文章へのアクセス制御 == = ページの作成 =
== 新しいページをつくる ==
[[HelpOnPageCreation]] によれば,
 * まず,''リンクの元となるページ''を作成
 * そこから,新しいページへの''リンクを張る''
 * リンク先で「新しいページを作成」をクリック
こうすることで,新しいページがどこからもリンクされていない事態を防げます.


= ページの管理 =
ページの管理について記します。少々長いですが、自分で新しいページを作る際は、以下のことは大体把握してくれると助かります。

== 古い版をみる ==
''情報''(ページ上部、検索ボックスの下)から見られます。

== ページを移動・削除する ==
''その他のアクション''から''ページの移動''・''ページの削除''を選択してください。

例:
{{{
chmod/ThisIsATestPage から ThisIsANewPlace
}}}
階層構造をかえるときも、このように特に意識しなくてかまいません。

また、'''すべての /サブページ の名前も変更しますか?''' にチェックをいれると、サブページの名前もすべて変えることができます。

== アクセス制御 ==
行 10: 行 35:
以下は、ACLの例です。これは、部員は誰でも''編集可能''・部室内からは''閲覧可能''、外部からは''読めない''ページを示します。 以下は、ACLの例です。これは、部員は誰でも''編集可能''、外部からは''読めない''ページを示します。
行 12: 行 37:
#acl Known:admin,read,write,delete,revert Room:read All: #acl Known:admin,read,write,delete,revert All:
行 17: 行 42:
ユーザー名は,登録されたユーザー名が使えます.ユーザー名の一覧は【】を参照してください. ユーザー名は,登録されたユーザー名が使えます.ユーザー名の一覧は [[CategoryHomepage]] などを参照してください.
行 22: 行 47:
 * Chief -- 部長・副部長
 * Cashier -- 会計
 * ChiefGroup -- 部長・副部長
 * CashierGroup -- 会計
 * All -- すべて
行 29: 行 55:
権限は,以下の物が使えます. 権限は,以下の物が使えます.
行 43: 行 69:
<control> ::= <users> ":" <rights> <control> ::= <users> ":" <rights-or-none>
行 46: 行 72:
<user> ::= ユーザー名 | グループ名 <user> ::= <ユーザー名> | <グループ名>
行 48: 行 74:
<rights-or-none> ::= "" | <rights>
行 52: 行 79:
簡単に上の意味を説明しましょう.まず,ACLは,以下のような構造をしています. 簡単に上の意味を説明しましょう.ACLは,以下のような構造をしています.
行 56: 行 83:
ユーザは、ユーザー名やグループ名などをまとめて記述することができます。ユーザーやグループの一覧は上の節を参照してください。
行 57: 行 85:

ユーザー名


== WIkiの記法 ==
= Wiki の設定について =
...
権限は、おおよそ以下のようになるでしょう。
 * admin,write,read,revert,delete
    全ての権限
 * write,read,revert,delete
    アクセス制御以外の全ての権限
  * ''誤って外部に公開''されては困るページは、こうしておくとよいかもしれません。
 * read
    読み込みのみ。デフォルトで、''学外''の''ログインしていない''ユーザーに対しては、こうなります。
 * (なし)
    たとえば "All:" とすると、学外から読めなくできます。
----
CategoryDocument CategoryDocument

ドキュメンテーションの方針

こちらでは,ドキュメンテーションにあたって,特に Wiki 特有の事情に関わることを記します.
編集については,HowToWriteWiki2に分割されました.

ページの作成

新しいページをつくる

HelpOnPageCreation によれば,

  • まず,リンクの元となるページを作成

  • そこから,新しいページへのリンクを張る

  • リンク先で「新しいページを作成」をクリック

こうすることで,新しいページがどこからもリンクされていない事態を防げます.

ページの管理

ページの管理について記します。少々長いですが、自分で新しいページを作る際は、以下のことは大体把握してくれると助かります。

古い版をみる

情報(ページ上部、検索ボックスの下)から見られます。

ページを移動・削除する

その他のアクションからページの移動ページの削除を選択してください。

例:

chmod/ThisIsATestPage から ThisIsANewPlace

階層構造をかえるときも、このように特に意識しなくてかまいません。

また、すべての /サブページ の名前も変更しますか? にチェックをいれると、サブページの名前もすべて変えることができます。

アクセス制御

文章へのアクセス制御は、 ACL (Access Control List) というものにより行われます。
以下は、ACLの例です。これは、部員は誰でも編集可能、外部からは読めないページを示します。

#acl Known:admin,read,write,delete,revert All:

ACLは,文章の先頭に記してください。

ユーザー名

ユーザー名は,登録されたユーザー名が使えます.ユーザー名の一覧は CategoryHomepage などを参照してください.

グループ名は,次の物が使えます.

  • Known -- 登録ユーザー(=部員)全員
  • Room -- (ログインしない場合の)部室内からのアクセス
  • ChiefGroup -- 部長・副部長

  • CashierGroup -- 会計

  • All -- すべて

基本的には,会計資料など重要な書類をのぞいて,誰でも編集可能にしてください.

権限

権限を適切に付与することは重要です.

権限には,以下の物が使えます.

  • admin -- acl の制御ができます.これが適切に付与されていないと,誰もACLを変更できなくなります.

  • read, write -- 読み書きができます.
  • delete -- 削除ができます.
  • revert -- 古い版に戻せます.

文法

ACLは,以下のような文法に基づいています。

<ACL> ::= "#acl" " " <controls>

<controls> ::= <control> | <control> " " <controls>
<control> ::= <users> ":" <rights-or-none>

<users> ::= <user> | <user> "," <users>
<user> ::= <ユーザー名> | <グループ名>

<rights-or-none> ::= "" | <rights>
<rights> ::= <right> | <right> "," <rights>
<right> ::= "admin" | "read" | "write" | "delete" | "revert"

簡単に上の意味を説明しましょう.ACLは,以下のような構造をしています.

#acl ユーザー[,ユーザー,...]:権限[,権限,...] [ユーザー[,ユーザー,...]:権限[,権限,...] ...]

ユーザは、ユーザー名やグループ名などをまとめて記述することができます。ユーザーやグループの一覧は上の節を参照してください。

権限は、おおよそ以下のようになるでしょう。

  • admin,write,read,revert,delete
    • 全ての権限
  • write,read,revert,delete
    • アクセス制御以外の全ての権限
    • 誤って外部に公開されては困るページは、こうしておくとよいかもしれません。

  • read
    • 読み込みのみ。デフォルトで、学外ログインしていないユーザーに対しては、こうなります。

  • (なし)
    • たとえば "All:" とすると、学外から読めなくできます。


CategoryDocument CategoryDocument

HowToWriteWiki (最終更新日時 2011-08-09 23:44:09 更新者 chmod)