索引
"维基是什么"
1. ''维基''是什么?
维基(Wiki)这个词是WikiWikiWeb的缩写。维基是一组页面的集合,可以通过网络浏览器进行合作编辑。任何人都可以按照他们的意愿开放和自由的进行编辑。系统自动创建各页面之间的交叉引用超链接。更多信息请看WikiWikiWeb。
MoinMoin是用python编写的维基程序。
2. 它有什么用途?
不论你如何使用它,它都有用处。与论坛和邮件列表相比,维基允许创建内容。维基具有更少的干扰和更多的信息。信息是结构化的,而且容易寻找。你可以在因特网上建立一个具有很多页面的维基,包括各种项目,构架,观点,等等,供人们评论。一些页面仅仅用于传递信息。其他页面则是用于讨论和评论。你也可以建立极其简单的技巧数据库类型的维基。
总之,维基是一种非常自由的工具,它的价值在于用户使用它的方法。例如,维基中的页面同样可以用于讨论。你也可以在项目中使用维集页面进行合作分工。
请看MoinMoin:MoinMoinSuccessStories, 那里有更多的成功案例。
3. 维基的主要特点是什么?
这有一些维基最重要的特点:
- 任何人都可以编辑 - 任何人都可以通过网络浏览器编辑维基页面
- 可以查看最新的改动
- 可以搜索页面 (多种方式)
- 可以很容易的增加新的页面
- 可以看到一个文档的更改历史
- 可以增加新的信息,或者修改已存在的信息
4. 维基安全性怎么样? 维基不会被捣乱分子弄得乱七八糟吗?
这是一个很重要的问题。一般来说,维基是没有安全性的。(That's right!)
对于MoinMoin,自从引入Access Control Lists机制之后,这一点已经有所变化,请看帮助-访问权限控制表。
但是,假如你没有使用ACLS,那么意外或有意的破坏当前页面修订版的可能是存在的。
使维基失去价值的方式主要有两种。 一种是删除,另一种是破坏。对于删除行为不太困难,因为每一个页面都有更改记录(和相应的备份),可以很容易的恢复。因此,当检查到页面被删除或者主要内容被删除时,页面可以很容易的从它们之前某个优良的状态恢复回来。
有意的破坏比较难以处理。有人可能在页面内输入不正确的信息,或者有意将页面中的信息更改成错误的(比如,有人改变页面,使它看起来像是另外一个人写下特别的评论,或者有人改变某一段的内容,使它的含义有了很大的不同)。任何协作系统都存在这样的问题。实际上,破坏维基的事情极少发生,而且新材料提交的同时可以向某个特定的人发出提醒,这样就可以进行处理了。
换句话说,维基的哲学是人工处理(也就是SoftSecurity)罕见的破坏事件,而不是设计并过度使用那些防止某个破坏者的破坏活动的功能。
关于MoinMoin的一般问题
1. 既然MediaWiki很有名并且是用PHP开发的,为什么要选择MoinMoin呢?
因为MoinMoin是用Python写的 (可能这个理由并不太充分,但最终还是归结到这一点)。
MoinMoin支持访问选择控制列表
MoinMoin容易扩展
"MediaWiki主要用于Wikipedia和Wikimedia的其他项目 (以及由个人在他们自己的服务器上运行的其他类似的大规模站点), 其次人们运行当地的实例用于处理来自我们站点的数据, 及其其他一些附带的使用." Brion Vibber, Media`Wiki开发者
2. 使用MediaWiki或者MoinMoin的优点和缺点?
本维基的使用问题
1. 在维基中查找和获取信息
1.1. 如何搜索维基?
现在有几种方法来搜索和/或浏览维基:
使用搜索框或者查找网页 FindPage,在那里你可以通过标题中的关键词,全文,一般文字或者通配符(正则表达式)来搜索。
点击标题索引。它会按照字母排序显示所有页面的标题类标。
点击词汇索引。它会按照字母排序显示每一个标题中的每一个单词的列表 (比如,页面BlueTooth列出来的结果是 B / Blue 以及 T / Tooth)。
使用 LikePages 操作。它会显示那些标题单词与当前页面标题单词类似的页面。
- 点击页面最顶端的页面标题。它会显示有哪些页面也当前页面相链接 (这可以帮你找到相关页面)。
1.2. 如何才能看到维基中最近发生的事情?
点击任何页面上方的最新改动链接。
1.3. 任何看到更久之前的改动,而不仅仅是默认的改动日期之内?
登录之后,选择90天之前。这够不够?
1.4. 到处都能看到的这些颜色奇怪的链接是什么?
所有混合大小写的名字,如果没有相应的页面,就会显示为不同颜色的链接。
2. 在维基中编辑
2.1. 如何在维基中增加内容, 或者更改错误的内容?
如果你看到一些内容后,想对它评论,增加,或者更改,只需要点击 EditText 链接, 或者点击页面顶部的 图标。页面会被带入浏览器的文字编辑框中,你只需进行更改就可以。维基格式器会对你输入的文字进行处理。如果想要漂亮的结果,你可以完成HTML可以完成的大部分排版。请到帮助-排版页面察看一些提示和例子。
2.2. 增加信息是否要遵守某些约定?
没有多少约定。它有助于保证特定类型的信息按照一致的方式进行格式化。一个可以帮助保持一致性的重要约定是使用“模板”页面。
本维基有一个称为“模板”的功能,当你创建新页面时会显示出来。如果你点击其中一个,那么这个页面将具有于其他相同类型页面类似的结构。例如,创建自己的维基主页时,你应该使用HomepageTemplate页面(当创建新页面时你能看到它)。
2.3. 如何在维基中增加非文字信息?
如果内容已经存在于某个网站上,那么那需在维基页面上增加一个链接。按照下面的步骤来做:
- 获得文档的URL,
编辑维基页面 (前往维基页面,点击编辑链接),
- 在适当的地方输入URL,
- 保存。
维基会从你输入的文字自动生成超链接。
你可以在方括号中为链接增加修饰文字,这样可以使链接看起来更漂亮。 修饰文字会显示在页面上,但是链接指向输入的URL。这有一个例子:
[http://your.domain.example/foo.html This will be the link text]
生成:
2.4. 如何避免使用<<BR>>,而使用正常的新行字符?
使用 { { { 和 } } } 包住你的预格式化的文字,形成与格式化的段落。
2.5. 如何在页面上增加图像?
你可以在页面上增加图像的链接。例子:
http://c2.com/sig/inter/wikibase.gif
生成:
2.6. 如何创建新的模板页面?
当你创建空白页面时,所有模板会自动以列表形式显示出来。任何标题以"Template"结尾的页面(请看page_template_regex)都会自动在列表中显示。因此,如果你希望某一类网页具有类似的格式(类似的标题,组织等),你可以定义一个名字以Template结尾的页面(这就是模板了),当创建那一个类型的页面时,选择这个模板,再编辑就可以。维基会把自动填充初始的内容。模板和其他页面一样都是可以编辑的维基页面。
要创建一个模板,只需创建名字为 <something>Template 的页面即可。
2.7. 添加局域网上的文档
如果MoinMoin运行在局域网上,那么给局域网内的共享文档添加一个链接有时会就很有必要,例如:
[file://///servername/sharename/full/path/to/file/filename.txt Click here to read filename.txt]
你也可以链接到文件名带有空格的文件,需要手工增加空格的URL编码 (%20):
[file://///servername/sharename/full/path/to/file/filename%20with%20spaces.txt Click here to read filename with spaces.txt]
更多相关的重要信息请看MoinMoin:FileLinks.
另一个可能更好的方法是使用 AttachFile 操作。
2.8. 我是否应该为我所做的更改签名?
如果这些更改很重要,或者你希望别人知道是你作的这些更改,那么就签下自己的名字。只需要在你的评论之后加上 @SIG@ 。通常应该把你的评论写在被评论对象的后面,并加上缩进。还有,把你的评论标记成斜体有助于把评论内容与被评论对象分隔开。
但是,有时候悄悄的进行更改才是比较合适的。比如,纠正拼写和格式的错误或者做一些细微的更改,这些都不需要签名。
2.9. 如果我删除了页面中所有的内容, 会怎么样? 你需要它们吗? 它是不是已经被完全抹掉了?
有必要的话,你可以恢复改动的内容。请看WhyWikiWorks.
3. 添加其他类型文档
3.1. 可以添加HTML吗?
只有安装了 不安全的 HTML扩展 (HTML宏和分析插件) 以后,下面的内容才能起作用。
如果你想增加一行HTML,可以使用HTML宏。把你的HTML文字作为参数传给HTML宏, 就象这样:
[[HTML(<font size=+12>This is large font</font>)]]
在页面上会显示: HTML(<font size=+12>This is large font</font>)
也可以将HTML文档放在一个页面内,只需在这页的第一行加入 #format html 。如果有了这一行,那么整个页面就会被解释成HTML (这样的话,链接到其他页面会变得比较困难!) 确认你增加的内容仅仅包括body部分 (不是 HTML headers 或者其他任何超出body的部分,包括 <BODY> tag本身)。
4. 维基中的链接
4.1. 如何链接到维基之外的地址?
http://moin.sourceforge.net/ 会解释成 http://moin.sourceforge.net
moin sourceforge page 会解释成 moin sourceforge page
安装 & 配置
请在帮助-系统管理察看更详细信息。
1. 如何使用 "DeletePage" / "RenamePage" 功能?
只有登录之后(通过用户设置),才能删除或者重命名页面。
2. 如何更改起始页面?
在wikiconfig.py中设置 page_front_page = u'OtherFrontPage'。请看帮助-语言。
帮助-系统设置包含更多可调整的变量。
管理维基
1. 如何管理维基?
在系统信息页面上有很多管理信息,包括网页的数目,以及安装的宏和操作方法。
I usually set up an "AdminPage", where I put macros for these, as well as information about the real physical location of the pages, and macros for orphan pages or other things an adminstrator for the wiki might want to look at.
2. 如何删除用户?
最好的方式是 (1.5.2版以上支持) 作为MoinMoin:SuperUser,to switch to the user that should be deleted from UserPreferences, 选择 "Disable this account forever" 然后点击"Save"。
3. 可以从页面的旧版恢复内容吗?
点击 信息 (或者 "i"图标)。
点击你希望恢复版本上的 revert 链接。
你必须登录才能恢复网页。
开发者帮助
1. 从哪里开始进行开发?
如想帮助开发,你可以这样做:
如果你不了解Python,那么开始学习它吧 BeginnersGuide
2. 从那里开始进行设计或者翻译?
如果你不是编程人员,但还是想做点什么,你可以这样做:
MoinDev/ThemeDevelopment - 开发 CSS 主题和相应的 (X)HTML 结构。
MoinDev/Translation - 把界面和帮助页面翻译成自己的语言。
3. MoinMoin诊断
如果你认为自己已经发现了一个错误或者遇到问题,你可以做一些测试。真正的bugs一般会显示出一个错误页面。你可以保存这个页面,到MoinMoin:MoinMoinBugs 搜索一下是否有看起来类似的页面,如果没有的话,创建一个新的bug页面,将错误信息附加在上面。
你可以在标准的URL后面附加 ?action=test 进行测试。这样可以得到一个称为"MoinMoin Diagnosis"的页面,它给出了很多信息。大部分信息只对开发者有用处,但是如果你就是其中一员或者是Python geek 你会发现这些信息很有用处。
如果本页上没有你的问题的答案,请看MoinMoin:MoinMoinQuestions.