PK Y)Mx 1## Please edit system and help pages ONLY in the master wiki!
## For more information, please see MoinMoin:MoinDev/Translation.
##master-page:HelpOnFormatting
##master-date:2005-01-06 14:55:00
#acl -All:write Default
#format wiki
#language zh-tw
== 一般法則 ==
* 用一個以上的空白行來分開不同段落
* 用 `<
>` 可在段落中強迫斷行
== 字體 ==
## Note that in some places we've used backticks here to "escape" the Wiki markup.
|| '''字體變化''' || '''語法標記''' || '''說明''' ||
|| ''italic'' || `''italic''` || 斜體字 ||
|| '''bold''' || `'''bold'''` || 粗體字 ||
|| `monospace` || {{{`monospace`}}} || 打字機字體。Wiki 語法標記無效 ||
|| {{{code}}} || `{{{code}}}` || 用在程式範例。Wiki 語法標記無效 ||
|| __underline__ || `__underline__` || 加底線 ||
|| ^super^script || `^superscript^` || 上標字 ||
|| ,,sub,,script || `,,subscript,,` || 下標字 ||
|| ~-smaller-~ || `~-smaller-~` || 縮小字體 ||
|| ~+larger+~ || `~+larger+~` || 放大字體 ||
|| --(stroke)-- || `--(stroke)--` || 刪除線 ||
== 程式語法加強顯示 ==
程式語法加強顯示是針對不同的程式語言做特別的處理。程式語言的保留字、常數等經過解析器的處理,會以不同的顏色顯示,以方便閱讀。啟用解析器的方法有下列幾種:
1. 在以 `{{{` 和 `}}}` 包起來的區塊中,指定解析器種類。如:`{{{#!parsername`
1. 使用 `inline:` 嵌入有支援副檔名的附件。如:附件副檔名是 `".py"`
1. 用 #format 指示定義頁面內容的格式。如:`#format parsername`
關於目前支援的解析器,請參考 HelpOnParsers。
----
== 範例 ==
=== 混合 ''斜體字'' 與 '''粗體字''' ===
<>
## Note that in some places we've used backticks here to "escape" the Wiki markup.
|| '''語法標記''' || '''呈現結果''' ||
|| `'''''Mix''' at the beginning''` || '''''Mix''' at the beginning'' ||
|| `'''''Mix'' at the beginning'''` || '''''Mix'' at the beginning''' ||
|| `'''Mix at the ''end'''''` || '''Mix at the ''end''''' ||
|| `''Mix at the '''end'''''` || ''Mix at the '''end''''' ||
=== 程式顯示 ===
<>
## Note that we've used backticks here to "escape" the Wiki markup, and line-breaks to split up the paragraph.
`{{{` <
>
`10 PRINT "Hello, world!"` <
>
`20 GOTO 10` <
>
`}}}` <
>
結果:
{{{
10 PRINT "Hello, world!"
20 GOTO 10
}}}
=== 上標字與下標字 ===
`You might recall ''a''^2^ `+` ''b''^2^ `=` ''c''^2^ from your math lessons, unless your head is filled with H,,2,,O.`
結果:
You might recall ''a''^2^ `+` ''b''^2^ `=` ''c''^2^ from your math lessons, unless your head is filled with H,,2,,O.
<>
=== 程式語法加強顯示 ===
## Note that we've used backticks here to "escape" the Wiki markup, and line-breaks to split up the paragraph.
`{{{#!python` <
>
`from colors import palette` <
>
`palette.colorize('python')` <
>
`}}}` <
>
結果:
{{{#!python
from colors import palette
palette.colorize('python')
}}}
PK Y)M< 2## Please edit system and help pages ONLY in the master wiki!
## For more information, please see MoinMoin:MoinDev/Translation.
##master-page:HelpOnSmileys
##master-date:2006-01-04 18:10:00
#acl -All:write Default
#format wiki
#language zh-tw
== 笑臉符號 ==
要在頁面中安插笑臉之類的符號,只要輸入下表的標記,就會有對應的顯示:
/!\ 注意!笑臉標記的前後都應該留白。
<>
PK Y)Mm m 3## Please edit system and help pages ONLY in the master wiki!
## For more information, please see MoinMoin:MoinDev/Translation.
##master-page:HelpOnSlideShows/900 Last but not least: Running your presentation
##master-date:[[DateTime(2006-10-24T03:24:39Z)]]
#acl -All:write Default
#format wiki
#language zh-tw
#pragma section-numbers off
= 播放您的簡報 =
嗯,步驟很簡單。回到簡報主頁(例如[[說明/簡報]])並按下'''<>'''即可。
於主頁上,您可選擇'''<>'''或'''<>'''以切換播放模式:
* Wiki模式(小字型),以及
* 簡報模式(Dia``Show)(適合投影機的大字型,使用不同的CSS。)
|| ''' >> ''' || 下頁 ||
|| ''' >>| ''' || 末頁 ||
|| ''' << ''' || 上頁 ||
|| ''' |<< ''' || 始頁 ||
|| ''' ^ ''' || 回主頁 ||
<>
PK Y)MqP= = 4## Please edit system and help pages ONLY in the master wiki!
## For more information, please see MoinMoin:MoinDev/Translation.
##master-page:HelpForBeginners
##master-date:2006-02-08 11:00:00
#acl -All:write Default
#format wiki
#language zh-tw
~-譯者註:譯者以使用中文且剛接觸 wiki 的經驗來改寫這個頁面,希望能很快地為你建立
wiki 的觀念。原版的英文頁面請參考 [[HelpForBeginners|這裡]]。-~
----
== Wiki 的基本觀念 ==
我們瀏覽網頁時,通常只能看,而不能對網頁進行修改。但 wiki 顛覆這種觀念,
你不但能看也能修改網頁。因為 wiki 強調群力合作及集體創作,每個人都可以分享及貢獻。
當你看到別人分享的資訊有錯或可以改的更好時,你就可以貢獻自己的心力去修正或改寫。
例如,在這個 wiki 站上,你只要按頂端或底部的 '''編輯''',就可以開始編輯頁面^(1)^。
最佳的例子就是你正在看的 [[中文/MoinMoin|MoinMoin]] 說明文件,
這些文件都是集眾人之力在 wiki 上完成的^(2)^。
若想知道更多 [[中文/WikiWikiWeb|WikiWikiWeb]] 的相關知識,你可以看看 MoinMoin:WhyWikiWorks
以及 MoinMoin:WikiNature 。另外 MoinMoin:WikiWikiWebFaq 及 Wiki:OneMinuteWiki
也是不錯的參考資料。
== Wiki 名稱 ==
[[Wiki名稱]] 在 wiki 中是個很重要的概念。簡單說,[[Wiki名稱]] 是由大小寫混合組成的字串。
因此以下這些範例都是 [[Wiki名稱]]:
1. WikiWikiWeb
1. FrontPage
1. SyntaxReference
在 wiki 系統中,每個 [[Wiki名稱]] 代表一個頁面。而且使用這個 [[Wiki名稱]]
就可以直接連結到該頁面。前面所舉的例子看起來是不是都是連結?
當要連結的頁面還不存在時,wiki 系統會問你是否要建立新頁面。這讓使用者在 wiki
網站很容易就可以建立新的頁面,而且很容易就可以連結在一起。
當然,中文沒有大小寫,我們不能享受到這個好處。變通方法是用 {{{[" 及 "]}}}
來指定任意字串為頁面名稱。如:{{{["Wiki名稱"]}}}。
== Wiki 的語法 ==
一般撰寫網頁的人需要學會 HTML 等複雜的標記語言,這可能會讓人望而卻步。Wiki
採用一種非常簡單、直覺的語法,讓一般人也可以輕易編寫網頁。例如,你可以點
'''更多功能''' 選單底下的 '''檢視原始形''',來看看這一頁是怎麼編寫的。(
/!\ 請忽略原始碼當中,一開始以 # 開頭的幾行)
以下簡單介紹幾個本頁有用到的語法:
* 字體:用幾個簡單的符號就可以來控制字體
{{{
''斜體''
'''粗體'''
^上標字^
~-縮小字-~
}}}
* 標題:前後加上相同數目的等號代表標題,等號的數目代表標題的等級
{{{
= 這是第一層的標題 =
== 這是第二層的標題 ==
}}}
* 條列:若每行的開頭為空白再加上 *、1.、A. 等,就會以條列的方式顯示
{{{
* 項目1
* 項目2
}}}
* 連結:建立連結最簡單的方法就是直接寫下 URL。如前所述,用大小寫混合字串或者用方刮號加雙引號也可產生連結
{{{http://this.is.a.link
WikiNameLink
["任意字串也可以當連結"]
}}}
* 分隔:連續四個以上的減號在一行的開頭,就是水平分隔線。減號愈多代表分隔線愈粗
{{{----
-----
}}}
是不是很簡單呢? :) 若這樣你也覺得很難的話,本站還提供 GUI 的編輯模式。你可以到
[[Wiki沙盤]] 去練習塗塗改改,相信很快就會熟悉這種語法。
詳細的 Wiki 語法,請參看 [[說明/編輯頁面]] 及 [[語法參考]]。
== MoinMoin 引擎 ==
本站是由 [[中文/MoinMoin|MoinMoin]] 引擎所推動。
以下列出這個引擎的一些好用的功能:
* 可對頁面標題或內容進行搜尋,在 [[尋找頁面]] 有更多的搜尋方法
* 記錄每個頁面的修改歷史,並保留每個版本。按每個頁面的 '''關於''' 就可以列出修訂記錄
* 在 [[最新更動]] 列出最近的修改,讓你很容易掌握網站的動態
* 提供回復舊版的功能,不用擔心頁面會被惡意破壞
* 提供頁面修訂通知服務。只要在你有興趣的頁面按 '''訂閱''',就可以在你的信箱收到修訂通知
* 具超強擴充能力,可以外掛巨集、解析器以及佈景主題等
* 支援 [[Wiki站際]] 連結,可以快速引用其他 wiki 網站
最後建議你參考 [[本站導覽]],這個頁面提供許多資訊讓你更容易瞭解本站。
----
1. 若你的 Wiki 站有設存取權限,你可能需要先登入才可以修改頁面
1. 請參考 http://moinmaster.wikiwikiweb.de
PK Y)MSز 5## Please edit system and help pages ONLY in the master wiki!
## For more information, please see MoinMoin:MoinDev/Translation.
##master-page:HelpOnHeadlines
##master-date:2006-01-04 10:28:00
#acl -All:write Default
#format wiki
#language zh-tw
#pragma section-numbers on
== 段落標題 ==
你可以用一至五個等號包夾一段文字來建立標題。標題文字與等號之間需有空白隔開。
系統可以自動為標題編號。這項功能可以只針對頁面來設定 (詳見 [[HelpOnProcessingInstructions|說明/處理指令]]
中的 #pragma section-numbers);也可以針對整個 Wiki 網站設定 (詳見 [[HelpOnConfiguration|說明/系統設置]] 中的 show_section_numbers)。
/!\ 標題中不能使用 Wiki 語法標記
/!\ 標題無法縮排
=== 文件實例 ===
{{{
= 大標題 =
== 標題 ==
=== 次標題 ===
==== 次次標題 ====
===== 次次次標題 =====
}}}
=== 呈現方式 ===
= 大標題 =
== 標題 ==
=== 次標題 ===
==== 次次標題 ====
===== 次次次標題 =====
注意!你必須正確地使用不同等級的標題來建構文件,如此才能看到正確的標題編號。本頁面只是為了示範,所以標題編號並不恰當。
PK Y)M-w w 6## Please edit system and help pages ONLY in the master wiki!
## For more information, please see MoinMoin:MoinDev/Translation.
##master-page:HelpOnSlideShows/100 Creating the slides
##master-date:[[DateTime(2006-10-23T09:25:46Z)]]
#acl -All:write Default
#format wiki
#language zh-tw
#pragma section-numbers off
= 製作投影片 =
請將標題寫在頁面內容最上方(如上所示)。因為在<>模式中,頁面名稱不會顯示出來(除了頁面內容外,整個wiki框架都不顯示)。
若您不想讓標題冠上編號,請在頁面內容之上加入`#pragma section-numbers off`。
(!) 別忘了填入一些內容
系統提供了[[投影片模板]],讓您更快速的製作投影片。
在頁面內容底下加入`<>` (upper) or `<>` (lower)︰
<>
<>
PK Y)MT 7## Please edit system and help pages ONLY in the master wiki!
## For more information, please see MoinMoin:MoinDev/Translation.
##master-page:HelpContents
##master-date:2006-01-23 09:34:00
#acl -All:write Default
#format wiki
#language zh-tw
以下列出幾個最重要的說明文件頁面:
* [[說明/新手入門]] -- 如果你剛剛接觸 wiki,請先到這裡建立概念
* [[說明/瀏覽本站]] -- 介紹本站提供的瀏覽方法及操作工具
* [[說明/搜尋本站]] -- 介紹如何在本站搜尋你要的頁面
* [[說明/建立新頁]] -- 介紹如何建立新頁面
* [[HelpOnTemplates|說明/使用模板]] -- 介紹如何使用模板
* [[說明/使用者設定]] -- 介紹如何設定使用者個人資料及偏好的操作方法
* [[說明/編輯頁面]] -- 介紹如何編輯一個頁面
* [[說明/操作]] -- 介紹能作用在頁面或整個網站的操作 ~-(進階使用者才需要)-~
* [[HelpMiscellaneous|說明/其他]] -- 其他說明文件及 FAQ
(!) 如果你需要簡報資料,請參考 WikiCourse (英文版)。
以下這些說明文件是給 wiki 站的管理員或開發者看的:
* [[HelpOnAdministration|說明/站務管理]] -- 如何管理 [[中文/MoinMoin|MoinMoin]] wiki 網站
* [[HelpOnInstalling|說明/系統安裝]] -- 如何安裝 [[中文/MoinMoin|MoinMoin]] wiki 網站
* [[HelpForDevelopers|說明/開發者專區]] -- 介紹如何加入自己設計的功能,以及如何修改原始程式
如果以上的說明文件沒有你要的資料,請試試下連結:
* [[說明/索引]] -- 所有說明文件的清單
* [[HelpMiscellaneous/FrequentlyAskedQuestions|說明/問答集]] -- FAQ
如果以上這些說明文件有任何錯誤,請幫忙登錄在 MoinMoin:HelpErrata 。我們會盡快修改及更正。
PK Y)MI 8## Please edit system and help pages ONLY in the master wiki!
## For more information, please see MoinMoin:MoinDev/Translation.
##master-page:HelpOnSlideShows/000 Introduction
##master-date:[[DateTime(2006-10-23T09:02:33Z)]]
#acl -All:write Default
#format wiki
#language zh-tw
#pragma section-numbers off
= 前言 =
在投影片中,您可以使用所有的wiki標記-但要注意下列事項︰
* 以「簡報模式」播放時會使用較大的字型,所以投影片裡頭別放太多文字,否則就得捲動畫面。
* 使用彩色時,請注意對比度的調整-特別是您打算要印出紙本。
* 簡報呈現於螢幕、投影機與紙本的樣子不太一樣。
* 圖形請使用較粗的線來呈現,否則將難以辨視。
<>
PK Y)M~2 2 9## Please edit system and help pages ONLY in the master wiki!
## For more information, please see MoinMoin:MoinDev/Translation.
##master-page:HelpOnMacros
##master-date:[[DateTime(2006-10-26T23:51:39Z)]]
#acl -All:write Default
#format wiki
#language zh-tw
<> <>
== 巨集 ==
在wiki頁面嵌入巨集,以引入系統功能。試著編輯[[最新更動]]或[[系統資訊]],就知道是怎麼回事了。
更多的標記資訊請參照[[說明/編輯頁面]]。
=== 搜尋巨集 ===
目前MoinMoin使用的新搜尋引擎,提供支援複雜型態的互動式搜尋,以及嵌入頁面的搜尋巨集。詳細說明請參照[[說明/搜尋本站]]。
||'''巨集''' ||'''功能''' ||'''範例''' ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 於頁面中嵌入「進階搜尋」對話框 || 請見[[尋找頁面]] ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 於頁面中嵌入「搜尋頁面標題」對話框 || 請見[[尋找頁面]] ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 於頁面中嵌入「全文檢索」對話框 || 請見[[尋找頁面]] ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 列出內容包含此頁面標題(頁面名稱)的所有頁面,其作用與點選頁面標題連結相同。 || 請見CategoryCategory ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 列出內容包含檢索詞的所有頁面 || Search for {{{powered}}}:<> ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 功能同{{{FullSearch}}}巨集,並將搜尋結果放入快取,下次執行時直接讀入快取資料。當您覺得速度比即時性(up-to-date)重要,就用它吧! || Search for {{{powered}}}:<> ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 於頁面中嵌入「跳至此頁」對話框 || 請見[[尋找頁面]] ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 列出標題(名稱)包含檢索詞的所有頁面 || 請見[[說明/索引]] ||
=== 導覽 ===
||'''巨集''' ||'''功能''' ||'''範例''' ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 列出最近更動過的頁面 || 請見[[最新更動]] ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 列出所有頁面標題 || 請見[[標題索引]] ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 列出所有頁面標題中詞彙(如 WikiName 包含兩個詞彙 Wiki 和 Name) || 請見[[詞彙索引]] ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 列出被連結但還不存在的頁面 || 請見[[未定義頁]] ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 列出沒有被其它頁面連結的頁面 || 請見[[孤立頁面]] ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 列出很久沒有變動的頁面 || 請見[[遺棄頁面]] ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 隨機嵌入一個頁面連結 || <> ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 隨機嵌入指定數量的頁面連結 || 兩個隨機頁面:<> ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 顯示內容目錄,可限制顯示的層數。 || 見本頁頁首 ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 在指定位置插入錨點 || <>#here ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 列出所有子頁面 || 請見本頁頁首 ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 列出同屬於父頁面的頁面 || See HelpOnMacros/MailTo ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 嵌入簡報功能表 || 請見[[說明/簡報]] ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 嵌入首頁/上頁/下頁/末頁連結 || 請見[[說明/簡報]] ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> displays number of attachments for current page || See HelpOnActions/AttachFile ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> displays number of attachments for page || See HelpOnActions/AttachFile ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 列出本頁附件 || See HelpOnActions/AttachFile ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 列出指定頁面的附件 || See HelpOnActions/AttachFile ||
=== 系統資訊 ===
||'''巨集''' ||'''功能''' ||'''範例''' ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 列出所有已知Wiki站際的站名(InterWiki names) || [[Wiki站際]] ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 關於wiki系統、python直譯器及主機系統的資訊。 || [[系統資訊]] ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 顯示本站頁面數量。若加上參數{{{exists}}},將只計算存在的面頁數量。 || 共<>頁 ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 列出所有頁面的容量 || 請見[[頁面大小]] ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 顯示統計圖表 (目前項目有︰點擊次數、頁面大小及瀏覽器) || 請見[[事件統計]]與其子頁面 ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 給系統管理員的資訊 || 必須有管理權限<
> <> ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 列出修改過的系統頁面 || <> ||
=== 其它 ===
||'''巨集''' ||'''功能''' ||'''範例''' ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 本巨集用來製作圖形連結。圖形參數可以用附件或URL;連結參數可為URL或wiki頁面;額外參數則用來調整圖形大小。若無連結參數,則連結將指向圖形本身。 || See HelpOnMacros/ImageLink ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 顯示系統圖示 || 請見[[說明/瀏覽本站]] ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 嵌入「使用者設定」對話框 || 請見[[說明/使用者設定]] ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 嵌入「使用者註冊」對話框 || ||
||||||`<
>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 插入換行符號 || 1st line<
>2nd line ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> Select a random quote from the given page, or from {{{FortuneCookies}}} if ommitted || <> ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 引入另一頁面內容 || 詳情請見[[HelpOnMacros/Include]] ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 加入腳注<>。無巨集參數時,將於書寫處嵌入腳注列表。 || 請見底下範例 ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 依系統設定格式顯示日期。 || <> ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 依系統設定格式顯示日期時間<>。 || <> ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 讀取I18N文字(主要用於說明頁面) || "Edit``Text"被翻譯為「<>」 ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> loads I18N texts (mainly intended for use on Help pages or in generated output on wiki pages) and replaces `%s` in the message by the arguments. The first character of the argument is used as the separator (in this example: a comma). You can escape the separator by using a backslash. || "`<>`" yields "<>" ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> useful for intranet developer wikis, a means to view pydoc documentation, formatted via a XSLT stylesheet || See http://twistedmatrix.com/wiki/python/TeudProject ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> 防止垃圾郵件的Email表示法 || 詳情請見 HelpOnMacros/MailTo ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> Allow the user to create (sub-) pages easily, using the page {{{PageTemplate}}}as the template for the new page and the string {{{NameTemplate}}} as a template for the name.<> `@ME` is used if you want the page created below the users homepage. `@SELF` is used to create a subpage below the page where it is called from. || <> ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> Retrieve dictionary entries from dict pages. || If you have a page called GermanDict which contains the entry ''Test'', you should see the translation here: <> ||
||||||`<>` ||
||<5%><
>||<75% style="margin: 10px; vertical-align: top;"> Displays a Calendar and creates link for entries to each day on subpages || See HelpOnMacros/MonthCalendar ||
<>
=== 動手寫巨集 ===
Create a python file called {{{MacroName.py}}} located in your {{{data/plugin/macro}}} directory. Ensure it has a single method called {{{execute(macro, arguments)}}}, which is the entry-point.
* ''macro'' is an instance of class Macro, and also evaluates to a string of the macroname.
* ''arguments'' is an arbitrary argument string you can pass in with parameters to your macro.
All {{{Macro}}} instances have a {{{request}}} member through which you can access the form parameters and other information related to user interaction.
{{{execute()}}} should use the formatter to construct valid markup for the current target format. In most cases this is HTML, so writing a macro which returns HTML will work in most cases but fail when formats like XML or {{{text/plain}}} are requested.
For example, your wiki page has the following line on it:
{{{
<>
}}}
You could write a !MacroName.py file like this:
{{{
#!python
Dependencies = []
def execute(macro, args):
return macro.formatter.text("I got these args from a macro %s: %s" %
(str(macro), args))
}}}
. /!\ Add an entry into {{{Dependencies}}} if the output from your macro should not be cached. This is important if the macro output could change from one moment to another, for example if your macro searches in wiki pages which may be being edited by other users, or loads information from an external database whose contents may change. Currently the value of any entry does not matter and may be considered a short description for 'why results from this macro should not be cached', but please look at the entries used in other macros for values which may be suitable.
<>
PK Y)MXb=; ; 10## Please edit system and help pages ONLY in the master wiki!
## For more information, please see MoinMoin:MoinDev/Translation.
##master-page:HelpOnAccessControlLists
##master-date:[[DateTime(2006-10-31T01:52:10Z)]]
#acl -All:write Default
#format wiki
#language zh-tw
#pragma section-numbers 2
= 存取控制清單 =
Wiki管理者以'''存取控制清單(Access Control Lists,ACLs)'''設定使用者(或群組)對頁面的讀、寫、刪等權限。這樣一來您就能夠:
* 隱藏某些頁面(於公開網站)
* 公開某些頁面(於私人網站)
* 只允許特定人士(群組)編輯指定的頁面
* 設定面頁是否允許刪除
* 控制可修改admin規則的名單
== 目錄 ==
<>
== 基本知識(Basics) ==
常用的控制命令有以下幾項:
* read - 允許讀取頁面
* write - 允許編輯頁面
* delete - 允許刪除頁面
* revert - 允許回復頁面至某版本
* admin - 允許變更頁面的 #acl 設定
使用存取控制清單非常容易,在頁首加入控制列如下︰
{{{
#acl SomeUser:read,write All:read
}}}
/!\ 您必須擁有頁面 admin 權力才能變更控制列。
以上的設定允許`SomeUser`讀取和編輯頁面,其它人則只能讀取而無法編輯(除非您在站台設定檔另外指定權限)。
若由wiki引擊處理附件操作,則附件亦受到存取控制清單的保護。
/!\ 當站台設定為直接存取附件時(不經由wiki引擊),附件就不受到保護。例如在wikiconfig.py使用{{{attachments}}}選項。
<>
== 配置(Configuration) ==
站台設定中關於ACLs的配置項目有︰
||'''項目(Entry)'''||'''預設值'''||'''說明(Description)'''||
||acl_rights_before||{{{u""}}}||'''優先于'''頁面及預設之ACLs設定值||
||acl_rights_after||{{{u""}}}||在頁面及預設'''之後套用'''的ACLs設定值||
||acl_rights_default||{{{u"Trusted:read,write,delete,revert \}}}<
>{{{Known:read,write,delete,revert \}}}<
>{{{All:read,write"}}}||預設的ACLs。'''只'''在頁面'''不使用其它'''ACLs時生效。||
||acl_rights_valid||`["read", ` `"write", ` `"delete", ` `"revert", ` `"admin"]`||ACLs接受的權限項目。可視需求於此增加項目。||
現在您應該明白這些項目的''作用'',但對於實際''意義''呢?
* 「優先於」表示「強迫套用」規則於所有頁面的管理與編輯(因為這是首先比對的規則)。
* 「預設」表示「頁面未使用ACLs時該遵循的規則」,與頁面中加入相同規則ACLs的效果一樣。若頁面的ACLs有'''Default'''一字,則此規則將併入ACLs中。
* 「之後套用」指「別忘記套用」,即前兩項規則皆末含括的部份(例如給所有人讀取權限)。
It helps if you think of them as before, during, and after processing of page based ACLs.
(!) That u"" notation used for the configuration strings means unicode and ''must be there'' - see HelpOnConfiguration for details.
== Syntax ==
The syntax for each line is as follows:
{{{
#acl [+-]User[,SomeGroup,...]:[right[,right,...]] [[+-]OtherUser:...] [[+-]Trusted:...] [[+-]Known:...] [[+-]All:...] [Default]
}}}
Where:
* '''User''' is a user name and triggers only if the user matches.
* '''Some``Group''' is a page name matching {{{page_group_regex}}} with some lines in the form " * Member" (see [[#Groups]]).
* '''Trusted''' is a special group containing all authenticated users who used HTTP-Basic-authentication.
* '''Known''' is a special group containing all valid users (like when using the cookie).
* '''All''' is a special group containing all users (known and anonymous users).
* '''Default''' is a special entry which inserts at the given place the entries from {{{acl_rights_default}}} (see [[#Default]]).
* '''right''' may be an arbitrary word like read, write, delete, revert, admin.
Only words in {{{acl_rights_valid}}} are accepted, others are ignored. It is allowed to specify no rights, which means that no rights are given.
/!\ Do not put whitespace between the name and the rights - `All: write,read` is '''not''' a valid ACL string.
== Available rights ==
These are the available rights you can use in an ACL entry. Be aware that Delete''''''Page and Rename''''''Page are not allowed if the user is not `Known`, even if a `delete` right is granted.
read::
Given users will be able to read text of this page.
write::
Given users will be able to write (edit) text of this page.
delete::
Given users will be able to delete this page and its attachments.
revert::
Given users will be able to revert this page to an older version.
admin::
Given users will have admin rights for this page. It means users will be able to change ACL settings, including granting "admin" to others and revoking "admin" from others.
/!\ There is no separate '''rename''' right: renaming a page requires that a given user has the read, write and delete rights.
== Processing logic ==
When some user is trying to access some ACL-protected resource, the ACLs will be processed in the order they're found. The '''first ACL matching the user''' will tell if the user has access to that resource or not and processing will stop once the user matched an ACL entry.
(!) Due to that ''first match'' algorithm, you should sort your ACLs: first single usernames, then special groups, then more general groups, then `Known` and at last `All`.
For example, the following ACL tells that `SomeUser` is able to read and write the resources protected by that ACL, while any member of `SomeGroup` (besides `SomeUser`, if part of that group) may also admin that, and every other user is able to read it.
{{{
#acl SomeUser:read,write SomeGroup:read,write,admin All:read
}}}
To make the system more flexible, there are also two modifiers: the prefixes '+' and '-'. When they are used, processing will only stop when requested right for some specific user matches the user and right(s) in the given ACL entry, but will continue if you are looking for another right (or another user).
In case of '+' the right will be given, in case of '-' the right will be denied (for the stopping case).
As an example, assuming that `SomeUser` is a member of `SomeGroup`, the above ACL could also be written as:
{{{
#acl -SomeUser:admin SomeGroup:read,write,admin All:read
}}}
This example is only special for `SomeUser`, because when admin right is queried for `SomeUser`, it will be denied and processing stops. In any other case, processing continues.
Or even:
{{{
#acl +All:read -SomeUser:admin SomeGroup:read,write,admin
}}}
`+All:read` means that when any user is requesting read right, it will be given and processing stops. In any other case, processing will continue. If admin right is queried for `SomeUser`, it will be denied and processing stops. In any other case, processing will continue. Finally if a member of `SomeGroup` is requesting some right it will be given if specified there and denied, if not. All other users have no rights, except when given by configuration.
Notice that you probably won't want to use the second and third examples in ACL entries of some page. They're very useful on the site configuration entries though.
<>
== Inheriting from defaults ==
Sometimes it might be useful to give rights to someone without affecting the default rights too much. For example, let's suppose you have the following entries in your configuration:
{{{
acl_rights_default = u"TrustedGroup:read,write,delete,revert All:read"
acl_rights_before = u"AdminGroup:admin,read,write,delete,revert +TrustedGroup:admin"
}}}
Now, you have some page where you want to give the "write" permission for `SomeUser`, but also want to keep the default behavior for All and `TrustedGroup`. You can easily do that using the '''Default''' entry:
{{{
#acl SomeUser:read,write Default
}}}
This will insert the entries from {{{acl_rights_default}}} in the exact place where the Default word is placed. In other words, the entry above, with the given configuration, is equivalent to the following entry:
{{{
#acl SomeUser:read,write TrustedGroup:read,write,delete,revert All:read
}}}
Lets look at the first example in this section:
{{{acl_rights_before = u"AdminGroup:admin,read,write,delete,revert +TrustedGroup:admin"}}}
ACLs are processed in the order of "before" then "page/default" and then "after", "left to right".
So it begins at the left of "before" with `AdminGroup:...` - this matches if
you are a member of admin group.
If it matches, you get those rights (arwdr) and ACL processing STOPS.
If it does not match, ACL processing continues with `+TrustedGroup:admin`
- this matches if you are a member of `TrustedGroup`.
If it matches, you get the rights (a) and - now the difference because of the modifier,
- ACL processing CONTINUES! So if there is another match for that
group or your user or `Known:` or `All:` you will get those rights, too.
If it does not match, ACL processing continues - with the page ACLs (if
there are any) or with default ACLs (if there are no pages ACLs) and
finally with the "after" ACLs.
While they represent the same thing, inheriting from the defaults has the advantage of automatically following any further change introduced in the defaults.
<>
== Groups ==
User groups make it easier to specify rights for bigger groups. Normally, the name of the group page has to end with `Group` like FriendsGroup. This lets MoinMoin recognise it as a list of usernames. This default pattern could be changed (e.g. for non-english languages etc.), see HelpOnConfiguration.
Only `SomeUser`'s friends can read and edit this page:
{{{
#acl SomeUser:read,write SomeUser/FriendsGroup:read,write
}}}
`SomeUser/FriendsGroup` would be a page with each top-level list item representing a wiki username in that group:
{{{
#acl SomeUser:read,write,admin,delete,revert
* JoeSmith
* JoeDoe
* JoeMiller
}}}
A page named `AdminGroup` could define a group of that name and could be also protected by ACLs:
{{{
#acl AdminGroup:admin,read,write All:read
* SomeUser
* OtherUser
* This is currently ignored.
Any other text not in first level list will be ignored.
}}}
/!\ A first level list is one with only one space before the asterisk (and there also has to be one space after the asterisk). The following won't work:
{{{
* some user
-- two spaces so doesn't work
}}}
You can configure which page names are considered as group definition pages (e.g. for non-english wikis):
{{{
page_group_regex = '[a-z]Group$' # this is the default
}}}
/!\ If changes to the group page do not take effect, let MoinMoin rebuild the cache by simply removing all files in the directory {{{path_to_your_wiki_instance/data/cache/wikidicts/}}}
== Usage cases ==
=== Public community Wiki on the Internet ===
The most important point here is to use ACLs only in cases where really needed. Wikis depend on openness of information and free editing. They use soft security to clean up bad stuff. So there is no general need for ACLs. If you use them too much, you might destroy the way wiki works.
This is why either ACLs should not be used at all (default) or, if used, the wikiconfig.py should look similar to that:
{{{
acl_rights_before = u'WikiEditorName:read,write,admin,delete,revert +AdminGroup:admin BadGuy:'
}}}
The default {{{acl_rights_default}}} option should be ok for you:
{{{
acl_rights_default = u'Known:read,write,delete,revert All:read,write'
}}}
A good advice is to have only a few and very trusted admins in `AdminGroup` (they should be very aware of how a wiki works or they would maybe accidently destroy the way the wiki works: by its openness, not by being closed and locked!).
If using `AdminGroup`, you should make a page called `AdminGroup` and use it to define some people who get admin rights.
Specifing `BadGuy` like shown above basically locks him out - he can't read or edit anything with that account. That makes only sense if done temporarily, otherwise you also could just delete that account. Of course, this `BadGuy` can also work anonymously, so this is no real protection (this is where soft security will apply).
=== Wiki as a simple CMS ===
If you want to use a wiki to easily create web content, but if you don't want edits by the public (but only by some webmasters), you maybe want to use that in your wikiconfig.py:
{{{
acl_rights_default = u'All:read'
acl_rights_before = u'WebMaster,OtherWebMaster:read,write,admin,delete,revert'
}}}
So everyone can read, but only the Webmasters can do anything else. As long as they still work on a new page, they can put
{{{
#acl All:
}}}
on it, so nobody else will be able to see the unready page. When being finished with it, don't forget to remove that line again, so that
{{{acl_rights_default}}} will be used.
Some page(s) could also allow public comments (like one being called `PublicComments`), so you give more rights on that page:
{{{
#acl All:read,write
}}}
=== Wiki on Intranet ===
If you want to use a wiki on your intranet and you trust your users (not doing hostile stuff like locking others out or hijacking pages) to use the admin functionality in a senseful way, you maybe want to use that:
{{{
acl_rights_default = u'Known:admin,read,write,delete,revert All:read,write'
acl_rights_before = u'WikiAdmin,BigBoss:read,write,admin,delete,revert'
}}}
So everyone can read, write and change ACL rights, `WikiAdmin` and `BigBoss` are enforced to be able to do anything, known users get admin rights by acl_rights_default (so they get it as long as no other ACL is in force for a page).
Consequences:
* on a new page, the page creator can put any ACLs he wants
* on existing pages, not having ACLs yet, any known user can set up any ACLs he wants
* all people (except `WikiAdmin` and `BigBoss`) can be locked out by anybody ("known") else on pages without ACLs
=== Wiki as a public company page ===
If you want to use a wiki as the company page, and don't want every user being able to change the company page content, you may want to
use something like this:
{{{
acl_rights_default = u"TrustedGroup:admin,read,write,delete,revert All:read"
acl_rights_before = u"AdminGroup:admin,read,write,delete,revert +TrustedGroup:admin"
}}}
This means that:
* by default known and anonymous users are only allowed to read pages
* on a new page, users in `TrustedGroup` can put any ACLs they want
* on existing pages, not having ACLs yet, any user in `TrustedGroup` user can set up any ACLs he wants
* all people, except people in `AdminGroup`, can be locked out by other admins or trusted users
* people in `TrustedGroup` get to use their admin rights on any page they're able to write, even if there are specific ACLs
=== Comments on read-only page ===
You can easily add a comments section to a read-only page by using a writable subpage, and allowing users to write on it. For example, you
can define `SomePage` like this:
{{{
#acl SomeUser:read,write All:read
'''Some read-only content'''
...
''' User comments '''
<>
}}}
And `SomePage/Comments` like this:
{{{
#acl All:read,write
Add your comments about SomePage here.
}}}
see also HelpOnAutoAdmin.
PK Y)MwJ MOIN_PACKAGEMoinMoinPackage|1
ReplaceUnderlay|1|說明/排版
ReplaceUnderlay|2|說明/笑臉
ReplaceUnderlay|3|說明/簡報/900 尾頁,但尚未結束︰播放您的簡報
ReplaceUnderlay|4|說明/新手入門
ReplaceUnderlay|5|說明/標題
ReplaceUnderlay|6|說明/簡報/100 製作投影片
ReplaceUnderlay|7|說明
ReplaceUnderlay|8|說明/簡報/000 前言
ReplaceUnderlay|9|說明/巨集
ReplaceUnderlay|10|說明/存取控制清單
Print|Installed MoinMaster page bundle Chinese_Taiwan--all_help_pages.zip.PK Y)Mx 1PK Y)M< 2PK Y)Mm m 3PK Y)MqP= = > 4PK Y)MSز $ 5PK Y)M-w w k) 6PK Y)MT - 7PK Y)MI !4 8PK Y)M~2 2 L7 9PK Y)MXb=; ; gj 10PK Y)MwJ MOIN_PACKAGEPK 6