PI：处理指令

MoinMoin 维基的数据处理指令

在页面的头部定义的，由一些连续的以 "#" 字符开头的关键字加上一些可选的参数组成的行。

PI处理指令的特征

  • PI处理指令的关键字是大小写敏感的

  • 由两个井字符号开头的行是注释行，将被忽略。注释语句可以出现在文档的任何地方

  • 任何其它行包括空行都终止对 PI处理指令的解析。即只有文件头的特殊语句才被当做 PI 处理

指令名称

格式

说明

示例

##

## comment

注释。注释语句可以出现在文本的任何地方 

## 注释
## 这里的任何文字都会被忽略

#format

#FORMAT parser options

页面使用的语法解析器。

  • wiki: 缺省模式。后面的参数作为HTML样式

  • plain: 作为纯文本解析

  • python: Python 源码显示

  • creole: 可选标准 wiki 语法 (参见: HelpOnCreoleSyntax)

  • 其它解析器: 参见 HelpOnParsers 

## 使用 zh 样式
## 即段落首行缩进两个空格
#format wiki zh

#redirect

##REDIRECT PageName

页面重定向，直接跳转到某页面

#redirect Main

#refresh

#REFRESH 延迟 目标

在指定的延迟时间到达时重定向到其他页面或外部URL链接。

需要在设置中激活，请看帮助-系统设置 

#refresh 0 FrontPage
#refresh 5 http://example.com/

#pragma 

#PRAGMA section-numbers 1|on
#PRAGMA section-numbers 0|off
#PRAGMA section-numbers 2-6

转换标题行自动编号功能。

  • 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...

设定页面的标题。

  • 在页面显示时以该标题作为页面标题

  • 在页面包含时，作为标题

  • 缺省使用页面名称

(!) page-title 是 page_title 的同义词

#pragma page_title PI 处理指令

#PRAGMA notify on|off

允许或禁止变更的邮件通知

  • 缺省允许变更邮件通知。

  • off(或0)关闭该页面的变更邮件通知功能

#pragma notify off

#PRAGMA keywords kw1, kw2, ...

在<meta> 标签中增加关键字，用于搜索引擎优化

#pragma keywords Cars, Vehicles, Foo

#PRAGMA description text...

在<meta> 标签中增加对当前页面的描述。

#pragma description Something about cars.

#pragma supplementation-page on|off

启用或者禁用讨论页

#pragma supplementation-page on

#DEPRECATED

将该页标记为不推荐使用的。 添加 #DEPRECATED 后，对该页的后续更改将不创建任何备份版本，并且在显示该页时将同时显示最新版本内容和最后一个备份版本的内容（未添加 #DEPRECATED 前的版本）。

  • 在确定一个页面过时后，在 PI 区定义一个 #DEPRECATED，内容全部删除后，添加一条为何页面过时的原因

  • 删除该 PI，则新内容成为最新版本，之前的包含 #DEPRECATED 的版本被彻底移除

  • 和 #REDIRECT 相比，该 PI 可以提供用户一个为什么页面过时不予维护的原因。#REDIRECT 则直接跳转到新页面而没有任何解释

  • 不删除页面内容而直接添加 #deprecated，将会使同样内容输出两次，因为要附加上之前的内容

#DEPRECATED

#language

#language language-name

指定网页语言。语言名应符合iso-639-1规范。如果MoinMoin/i18n/中没有该语言的翻译文件，MoinMoin会忽略这个指令。

#language zh

#acl 

#acl [+-]User[,SomeGroup,...]
        :[right[,right,...]]
    [[+-]OtherUser:...]
    [[+-]Trusted:...]
    [[+-]Known:...]
    [[+-]All:...]
    [Default]

授权指令。详见: 关于授权的帮助

#acl SomeUser:read,write All:read

参考: