《MoinMoin维基语法大全》由会员分享,可在线阅读,更多相关《MoinMoin维基语法大全(13页珍藏版)》请在金锄头文库上搜索。
1、转载自北京群英汇信息技术有限公司 http:/MoinMoin 维基语法大全MoinMoin 维基语法采用了较为通用的 Wiki 语法规范,您在其它维基学习到的语法,基本可以用在这里,尤其是和 Trac 的 Wiki 语法更为相近。在这个帮助页面中汇总了 MoinMoin 的维基语法,采用表格形式,同时显示了代码和实际的输出,便于掌握和参考。根据页面名称,有四类特殊页面:分类页,模板页,词典页,用户组页。有的页面中的特定语法被提取出来(词典页,用户组页),处理后为其它语法所引用。模板页提供其它页面创建的模板和基础。分类页,提供一个显示页面分类(归类)信息的场所四类页面之间以及和其它页面的区分,
2、完全依靠的是文件名。在配置文件中缺省定义了正则表达式,决定了什么样的页面是哪一种特殊页面:分类页: 以 Category 开头或者以 类 结尾的页面是分类页面。分类页面的任何子页面也都是分类页面。CategoryTemplate 不是分类页面而是模板页面。CategoryCategory 默认应该是所有分类页面的祖宗,即所有分类页面都应该加入到该分类中。模板页: 以 Template 或者以 模板 结尾的页面是模板页面。词典页: 以 Dict 结尾的页面是词典页面。用户组页: 以 Group 结尾的页面是用户组页面。 Contents6.1. 分类页分类页以 Category 开头或者以 类
3、结尾的页面是分类页面。分类页面的任何子页面也都是分类页面。CategoryTemplate 不是分类页面而是模板页面。CategoryCategory 默认应该是所有分类页面的祖宗,即所有分类页面都应该加入到该分类中。如何将一个页面添加到一个分类? 分类的名称必须和分类页面的命名规则相同,即: CategoryHomepage, 会议纪要类, 群英汇帮助类 等都是合法的分类名称。 在一个页面的最后,添加代码:四个横线 + 换行 + 空格分开的分类名称列表, 就将该页面添加到相应的分类中。如下代码,即将该页面添加到两个分类: 人大常委会议纪要类 和 政协常委会议纪要类分类和分类页的关系: 分类的
4、存在与否和是否存在分类页面,以及分类页面 的内容为何,没有关系。如: 分类 群英汇帮助类 的存在并非是因为页面 群英汇帮助类 的存在与否,也和页面 群英汇帮助类 的内容无关。 只要页面的最后包含特定语法:四个横线 + 换行 + 空格分开的分类名称列表,相应的分类自然而然就形成了。 分类页面中也可以使用特定语法: 四个横线 + 换行 + 空格分开的分类名称列表,形成分类的层级关系,以及将所有分类都纳入到约定俗成的分类祖宗 CategoryCategory 中。 群英汇扩展的语法简化了分类页面的创建,例如: 群英汇帮助类 的主要内容如下:参见: ShowCategory 宏6.2. 模板页模板页以
5、 Template 或者以 模板 结尾的页面是模板页面。如: HomepageTemplate, CategoryTemplate, 博客条目模板, 工作周报条目模板 等。模板中的变量: 模板经常和变量伴生。即模板的内容中经常使用变量指代一些要替换的内容,如:时间,登录用户名等 写在一般页面中的变量在预览和保存时会被替换,而保存在模板中的变量不会被替换。只有由模板派生新页面时,在新页面(非模板页面)中相应变量才被替换 参见: 关于变量的帮助何时会使用模板? 创建新页面:在 URL 中输入新页面地址,或者点击不存在页面的链接 在创建新页面时,模板列表提供给用户,用户可以选择以某个模板文件为原型创
6、建新页面,这样达到了简化页面创建和减少重复输入的效果 NewPage 宏, MonthCalendar 宏中使用模板 NewPage 宏, MonthCalendar 宏提供了模板参数,用户可以传递模板页面名称到这些宏中,让这些宏创建的新页面更加规范和专业。参见: NewPage 宏的帮助 MonthCalendar 宏的帮助6.3. 词典页词典页以 Dict 结尾的页面是词典页面。一般词典页面只出现名词解释语法。每一行是一个名词解释,即定义了一个词条,多个词条形成了一个词典。例如 GlobalDict 词典中可能有如下内容:于是词典 GlobalDict 就定义了关于 CompanyName
7、, WikiSiteUrl, 行政部接口 等词条。可以通过下列方法在其它页面中引用。1.GetVal 宏 可以使用 GetVal 宏获取变量值: 显示为(如果没有显示,检查 GlobalDict 文件是否存在,以及是否定义上述变量):北京群英汇信息技术有限公司http:/ (xingzheng)2.特殊的词典页面: GlobalDict, 用户主页的子页面 MyDict 中定义的词条,可以通过 变量 直接引用,并在页面预览或者保存时完成替换。如 输入 CompanyName 替换为 北京群英汇信息技术有限公司 输入 WikiSiteUrl 替换为 http:/ 参见: 输入 行政部接口 替换为
8、 邢政 (xingzheng) 变量的帮助 GetVal 宏的相关帮助6.4. 用户组页用户组页以 Group 结尾的页面是用户组页面。用户组页中的一级列表被提取出来作为该用户组包含的用户名。用户组主要用于 授权。如何创建一个用户组?创建一个新页面,页面名称要以 Group 结尾,于是就创建了一个新的用户组。用户组的名称即为新创建的页面名。如何将一个用户添加到一个用户组?编辑相应的用户组页面将用户的 登录 ID 以一级列表的形式添加。也可以用 登录 ID|用户真名 的可点击的格式添加。例如用户组 acl/MeetingsGroup 内容如下:则用户 JiangXin, wangqiang, a
9、cl/ManagerGroup 组的用户都属于用户组 acl/MeetingsGroup。用户组中的特殊用户 用户组可以嵌套,即可以在一个用户组中包含其它用户组。只要在用户组的用户名单中,将以 Group 结尾的用户组加到列表中即可Known: 代表全体注册用户All: 所有用户包含匿名用户参见:关于授权的帮助帮助-访问权限控制表#GroupsMoinMoin 维基的数据处理指令在页面的头部定义的,由一些连续的以 # 字符开头的关键字加上一些可选的参数组成的行。PI 处理指令的特征PI 处理指令的关键字是大小写敏感的由两个井字符号开头的行是注释行,将被忽略。注释语句可以出现在文档的任何地方任何
10、其它行包括空行都终止对 PI 处理指令的解析。即只有文件头的特殊语句才被当做 PI 处理HelpOnParsers#redirect#REDIRECT PageName页面重定向,直接跳转到某页面#redirect Main#refresh#REFRESH 延迟 目标在指定的延迟时间到达时重定向到其他页面或外部 URL 链接。需要在设置中激活,请看帮助-系统设置#refresh 0 FrontPage#refresh 5 http:/ section-numbers 1|on #PRAGMA section-numbers 0|off #PRAGMA section-numbers 2-6转换
11、标题行自动编号功能。 off(或 0)关闭标题行自动编号功能 使用 on 或者 1 来打开自动编号 2 到 6:只显示二级标题及其以上的编号(三 - 六级标题与此相同)如果误将 section-numbers 写为 number-sections 会转换为正确语法进行解析。#pragma section-numbers on #pragma section-numbers off #pragma section-numbers 3#PRAGMA page_title text.设定页面的标题。在页面显示时以该标题作为页面标题在页面包含时,作为标题#pragma page_title PI 处理
12、指令缺省使用页面名称page-title 是 page_title的同义词#PRAGMA notify on|off允许或禁止变更的邮件通知缺省允许变更邮件通知。off(或 0)关闭该页面的变更邮件通知功能#pragma notify off#PRAGMA keywords kw1, kw2, .在 标签中增加关键字, 用于搜索引擎优化#pragma keywords Cars, Vehicles, Foo#PRAGMA description text.在 标签中增加对当前页面的描述。#pragma description Something about cars.#pragma suppl
13、ementation-page on|off启用或者禁用讨论页#pragma supplementation-page on#DEPRECATED将该页标记为不推荐使用的。 添加 #DEPRECATED 后,对该页的后续更改将不创建任何备份版本,并且在显示该页时将同时显示最新版本内容和最后一个备份版本的内容(未添加 #DEPRECATED 前的版本)。在确定一个页面过时后,#DEPRECATED在 PI 区定义一个#DEPRECATED,内容全部删除后,添加一条为何页面过时的原因删除该 PI,则新内容成为最新版本,之前的包含#DEPRECATED 的版本被彻底移除和 #REDIRECT 相比,该PI 可以提供用户一个为什么页面过时不予维护的原因。#REDIRECT 则直接跳转到新页面而没有任何解释 不删除页面内容而直接添加 #deprecated,将会使同样内容输出两次,因为要附加上之前的内容#language#language language-name指定网页语言。语言名应符合iso-639-1 规范。如果MoinMoin/i18n/中没有该语言的翻译文件,MoinMoin 会忽略这个指令。#language zh