写作语法



块元素

  • 一个块元素可以作为其他块元素的子元素。但是目录、水平线、以#为起始的块元素无法成为其他块元素的子元素
  • 空格是顶级块元素的分隔符,空格一旦出现,意味着所有块元素的终止
  • 成为块元素的插件显示为#~

段落

行内元素

接着行首直接写内容,将成为段落

~ 行内元素

行首为 ~ 也是一个段落

行内元素

引用

> 行内元素

行首为 > 的文本将显示为引用,引用可以有三级 >、>>、>>>。

行内元素
  • 只要引用中不出现块元素,那么引用将会继续
  • 只要不出现空行,那么引用将会继续
  • 只要不出现新的引用或块元素,那么引用中的段落将会继续
  • 如果要在列表结构中跳出引用,但是不跳出列表,可以在行首写 <、<<、<<<。

列表结构

- 行内元素

将创建一个无序列表

  • 行内元素
+ 行内元素

将创建一个有序列表

  1. 行内元素
: 术语 | 解释

将创建一个定义列表

术语
解释
  • 一个定义列表必须包含 |

禁止排版的文本

行首为半角空格的文本自动成为禁止排版的文本。

  • 禁止排版的文本的子元素将被视为字符串

表格

| 单元格A | 单元格B |

以 | 为行首并分隔元素可以构成表格

单元格A单元格B
  • 每个元素的有以下属性:
    LEFT:
    CENTER:
    RIGHT:
    BGCOLOR(背景色):
    COLOR(文字色):
    SIZE(文字大小):
    • 元素的显示为之和背景色、文字色、文字大小以像素(px)为单位。单元格内默认为左对齐
      表格中每个单元格的配置示例
      左对齐居中右对齐
      右对齐左对齐居中

CSV格式的表格

,A单元格,B单元格,…

以“,”起始的行内元素可以构成表格,以==连接的两个元素将合并为一个单元格

A单元格B单元格

标题

* 行内元素

位于行首的 * 将显示为标题。可以有 *、**、*** 三级标题。

目录

#contents

位于行首的 #contents 将在页面顶部显示一个目录,#contents 一般写在源文本的靠近最上方的位置

左对齐、右对齐和居中

LEFT:我是左对齐的文本
我是左对齐的文本
CENTER:我是居中文本
我是居中文本
RIGHT:我是右对齐文本
我是右对齐文本

水平线

----

从行首开始至少4个 - 将显示为水平线


#hr

从行首开始的 #hr 将显示为分割线,超过上级块元素60%以上的部分会自动截断。


增加行间距

#br

可以增加行间距,例如

第一行

第二行

清除格式

#clear

在行首的 #clear 表示清除之前的所有格式

表单

#comment

显示一个评论栏

#pcomment

评论内容记录到另一个页面的评论栏,并对回复的评论作缩进显示

No comment.

#article

一个简易留言板

#vote(选项1,选项2,选项3,...)

一个简易的投票

选项 票数 投票
选项1 0
选项2 0
选项3 0
... 0

行内元素

字符串

字符串

字符串是行内元素

换行

行末换行~

行末换行

  • 行末换行无法在表格、以 # 起始的块元素和列表中使用
&br;


  • 会强制换行
  • 可以在表格、以 # 起始的块元素和列表中使用

粗体字和斜体字

''粗体字''

以一对''包围的文字会成为粗体字

  • 粗体字可以成为其他行内元素的子元素。
  • 粗体字中可以包含其他的行内元素。
'''斜体字'''

以一对'''包围的文字会成为斜体字

  • 斜体字可以作为其他行内元素的子元素。
  • 斜体字中可以包含其他的行内元素。

文字大小

&size(文字大小){行内元素};

使用 &size 可以指定文本字体的大小。文字大小以像素(px)为单位。如果文字大小设置为20,则显示为20像素大小的文字

  • 文字大小可以作为其他行内元素的子元素。
  • 文字大小可以包含其他的行内元素。

文字颜色

&color(文字颜色,背景色){行内元素};

使用 &color 可以指定行内元素的文字颜色背景色

  • 可以使用以下格式指定颜色。
    • 颜色关键字
    • #6位16进制数
    • #3位16进制数
  • 文字颜色可以作为其他行内元素的子元素。
  • 文字颜色可以包含其他的行内元素。

删除线

%%带删除线的行内元素%%

使用%%把行内元素包围起来,可以添加一个带删除线的行内元素

  • 删除线可以作为其他行内元素的子元素。
  • 删除线可以包含其他的行内元素。

脚注

((行内元素))

使用 (( 和 )) 将行内元素包围起来,可以创建一个脚注1

  • 脚注可以作为其他行内元素的子元素。父元素会应用到脚注的链接。
  • 脚注可以包含其他的行内元素。子元素会应用到到脚注文本。

添加文件和图像

&ref(添加的文件名);
&ref(文件的链接);

可在页面中添加文件和图像,如果添加的是图像,会直接将图像显示出来。

&ref(http://wordpress.org/latest.tar.gz);

将显示为
latest.tar.gz

注音

&ruby(注音字符){行内元素};

这是一个拼音的注音(zhu4 yin1),一个假名的注音:秋庭里香(あきばりか)

  • 请尽量不要在脚注中使用注音,这样会很难分辨出注音

访问计数器

&counter;
&counter(选项);

显示访问页面的人数。

  • &counter 有以下选项,默认情况下的选项为total。
    today
    • 显示今天的访问数为1次。
      yesterday
    • 显示昨天的访问数为2次。
      total
    • 显示访问总数为2071次。
  • 访问计数器可以作为其他行内元素的子元素。
  • 访问计数器不能包含其他的行内元素。

显示在线人数

&online;

&online 可显示当前的在线人数。例如当前在线1人。

  • 在线人数显示可以作为其他行内元素的子元素。
  • 在线人数显示不能包含其他的行内元素。

显示版本信息

&version;

&version 可查看目前使用的PukiWiki的版本。当前使用的PukiWiki版本为&version;。

  • 版本显示可以作为其他行内元素的子元素。
  • 版本显示不能包含其他的行内元素。

WikiName

WikiName

按照至少1个大写字母→至少1个小写字母→至少1个大写字母→至少1个小写字母的顺序组成的字符串为WikiName

  • WikiName中不能包含全角或半角的空格、符号以及数字。
  • WikiNamePukiWiki中已经存在的页面名。如果该页面存在,则自动显示为链接,如果页面不存在,则在WikiName后显示?

页面名称

[[页面名称]]

显示为
页面名称

[[页面名称#链接名]]

显示为
[[页面名称#链接名]]

InterWiki

[[InterWikiName:页面名称]]

显示为
InterWikiName:页面名称

链接

[[链接名:网址]]

InterWikiName中的:之前写任意的链接名,:之后写网址,将显示为带链接的链接名。

http://www.example.com/

显示为
http://www.example.com/

https://www.example.com/

显示为
https://www.example.com/

ftp://ftp.example.com/

显示为
ftp://ftp.example.com/

foo@example.com

显示为
foo@example.com

  • 在行内粘贴链接,会显示为带链接的文本
  • 如果链接为图像,则会直接显示图像

页面别名

[[页面别名>页面名称]]

显示为
页面别名

  • 也可以使用:来代替>

制表符

&t;

将创建一个制表符

上一行有一个制表符。

页面名称转义字符

&page;

将显示最末端的子页面名称:写作语法

&fpage;

将显示页面的完整名称:写作语法

日期时间转义字符

&date;

显示编辑时的日期
2011-07-31

&time;

显示编辑时的时间
10:42:14

&now;

显示编辑时的日期时间
2011-07-31 (星期日) 10:42:14

&_date;

显示用于显示时的日期
&_date;

&_time;

显示用于显示时的时间
&_time;

  • &_now;显示用于显示时的日期时间&_now;
  • &lastmod;用于显示当前页面的最近修订时间 2014-11-04()10:52:42
  • &lastmod(某页面); 用于显示某页面的最近修订时间 PluginRenderer::executePluginInline(): &lastmod(某页面)

符号和表情转移字符

  • &copy; 显示为版权符号©
  • &reg; 显示为专利符号®
  • &heart;显示为心形符号 &heart;
  • &smile;显示为 ⌣
  • &bigsmile;显示为 &bigsmile;
  • &huh;显示为 &huh;
  • &oh;显示为 &oh;
  • &wink;显示为 &wink;
  • &sad;显示为 &sad;
  • &worried;显示为 &worried;

数值转义字符

&#10进制数;
&#x16进制数;
  • &#38290; 显示为Unicode的“閒”
  • &#29109; 显示为Unicode的“熵”

其他

行注释

// 注释内容

行首为 // 的行为注释行。此行不会显示任何内容。

  • 注释行可以放在任何位置,只要行首以 // 为起始
  • 注释行不会对前后的行产生任何影响