zgbl 发表于 2009-1-31 03:11:21

Wiki翻译——http://pkuxkx.com/wiki/wiki/syntax

今晚在Wiki上贴金庸时，翻了下Wiki的格式规则，觉得这篇说明很有用，就顺便翻译了下来，翻译不好的地方还请见谅………………


====== 格式规则 ======
[] 支持一些能尽量地使资料具有较强的可读性的简单的标记语言。这个页面归纳了在你编辑页面时可能使用的所有格式。只要点击页顶或页底的 //编辑本页// 按钮，就可以查看本页的源代码。如果你想尝试编写一些东西，请到 [] 页面。这种简易的标记语言也可通过 [] 查看。
===== 文档基础格式 =====
DokuWiki 支持 **加粗**, //斜体//, __下划线__ 和 ''加宽'' 的文本。当然你也可以 **__//''综合使用''//__** 这些格式
DokuWiki 支持 **加粗**, //斜体//, __下划线__ 和 ''加宽'' 的文本。
当然你也可以 **__//''综合使用''//__** 这些格式。
你也可以使用 <sub>下标</sub> 和 <sup>上标</sup>。
你也可以使用 <sub>下标</sub> 和 <sup>上标</sup>。
你也可以用 <del>删除号</del> 进行标记。
你也可以用 <del>删除号</del> 进行标记。
**段落** 从空白行开始。如果你想不回车便 **另起一行** ，你可以在句末使用两个反斜杠，后面加上一个空格。
这是有换行的一段话\\ 请注意，两个反斜杠只是被认为是一行的结束\\
后面有\\ 一个空格 \\没有空格就会这样
这是有换行的一段话\\ 请注意，
两个反斜杠只是被认为是一行的结束\\
后面有\\ 一个空格 \\没有空格就会这样。
如果真的需要的话，你可以这样强制换行。
===== 链接 =====
DokuWiki 支持许多创建链接的方法。
==== 外部链接 ====
外部链接可以被自动识别： http://www.google.com 或者仅仅是 www.google.com —— 你也可以设置链接名： []。像这样的Email地址： <andi@splitbrain.org> 也能被识别。
DokuWiki 支持许多创建链接的方法。外部链接可以被
自动识别： http://www.google.com 或者仅仅是 www.google.com —— 你也可以
设置链接名: []。像这样的
Email地址： <andi@splitbrain.org> 也能被识别。
==== 内部链接 ====
内部链接用方括号创建。你可以使用 [] 或者使用 []。Wiki的页面名称会自动转为小写体，但不支持特殊字符。
内部链接用方括号创建。你可以使用
   [] 或者使用 []。Wiki的页面名称
会自动转为小写提，但不支持特殊字符
你可以在这个页面使用一个冒号表示 [] 。
你可以在这个页面使用一个冒号表示 [] 。
命名空间的详细说明请看 []。
也可以创建指向某一小节的链接。只需如HTML语言一样在#号后面写上小节名称。这个链接指向 []。
这个链接指向 [].
注意：
* 指向 [] 的链接与 [] 的表现方式不同。
* DokuWiki 不使用 [] 来创建链接，但是可以通过 [] 来启用这种拼写方式。注意：如果 DokuWiki 是一个链接，那么这是允许的。
* 当一个小节的标题改变时，它的书签也需要改变。所以不能太过于依赖书签。
==== 跨Wiki链接 ====
DokuWiki支持 [] 。这些链接可以迅速的连向其它的Wiki。比如，这是一个连向 Wikipedia 的关于Wiki的链接： []。
DokuWiki支持 [] 。这些链接可以迅速的连向其它的Wiki。
比如，这是一个连向 Wikipedia's 的关于Wiki的链接： []。
==== 共享 ====
像 [[\\server\share|这样]] 的共享也能被识别。请注意，这只在像公司的 [] 这样的同性质用户组里才能生效。
像 [[\\server\share|这样]] 的共享也能被识别。
注意：
* 因为安全原因，对共享的直接浏览只能通过Microsoft Internet Explorer进行（仅在“本地区域”）。
* 对于Mozilla和Firefox浏览器，可以通过 [] 的设置开启，不过不建议这样做。
* 点击 [] 查看更多信息。
==== 图片链接 ====
你也可以通过综合运用常规链接和 [[#images_and_other_files|片句法]] 规则来建立通往内部或者外部页面的图片链接（如下）：
[]
[]
请注意：图片句法是链接名中唯一允许的句法格式。
DokuWiki支持 [[#图片和其他文件|图片句法]] 和 [[#链接|链接]] 格式（包括图片大小调整，内部和外部图片，超链接以及跨Wiki链接）。
===== 脚注 =====
你可以通过双括号加入脚注 ((这是脚注)) 。
你可以通过双括号加入脚注 ((这是脚注)) 。
===== 小节 =====
你可以使用五种不同级别的标题来构建你的文章。如果你有三个以上的标题，就会自动生成列表——这可以通过在文档种加入 ''<nowiki>~~NOTOC~~</nowiki>'' 字符串来取消。
==== 三级标题 ====
=== 四级标题 ===
== 五级标题 ==
==== 三级标题 ====
=== 四级标题 ===
== 五级标题 ==
使用四个以上的破折号，你可以创建一条分割线：
----
===== 图片和其他文件 =====
你可以通过花括号显示 [] 。你还可以设定图片的尺寸。
实际尺寸：                        {{wiki:dokuwiki-128.png}}
重设宽度：                        {{wiki:dokuwiki-128.png?50}}
重设宽度和高度：                  {{wiki:dokuwiki-128.png?200x50}}
重设尺寸的外部图片：            {{http://de3.php.net/images/php.gif?200x50}}
实际尺寸：                        {{wiki:dokuwiki-128.png}}
重设宽度：                        {{wiki:dokuwiki-128.png?50}}
重设宽度和高度：                  {{wiki:dokuwiki-128.png?200x50}}
重设尺寸的外部图片：            {{http://de3.php.net/images/php.gif?200x50}}

通过左右空格，你可以设置对齐方式
{{ wiki:dokuwiki-128.png}}
{{wiki:dokuwiki-128.png }}
{{ wiki:dokuwiki-128.png }}
{{ wiki:dokuwiki-128.png}}
{{wiki:dokuwiki-128.png }}
{{ wiki:dokuwiki-128.png }}
当然，你也可以加入说明文字（作为给浏览者提供的提示）。
{{ wiki:dokuwiki-128.png |这是说明文字}}
{{ wiki:dokuwiki-128.png |这是说明文字}}
如果你使用的是非图片（''gif,jpeg,png''）的文件名（外部或者内部）那么它会被作为一个链接。
对于把图片链接向另外一个页面的运用，请见上面的 [] 。
===== 列表 =====
Dokuwiki支持有序和无序列表。为了创建一个列表条目，你需要在文本前面加入两个空格和一个''*''来表示无序列表，或者用''-''表示有序列表。
* 这是个列表
* 第二条
    * 可以设置不同的级别
* 另外一条
- 同样的列表，有序的
- 第二条
    - 使用缩进表示深层级别
- 这就是了
<code>
* 这是个列表
* 第二条
    * 可以设置不同的级别
* 另外一条
- 同样的列表，有序的
- 第二条
    - 使用缩进表示深层级别
- 这就是了
</code>
===== 表情 =====
DokuWiki包含了常用的表情（[]）。可以在''smiley''文件夹里添加更多表情并在''conf/smileys.conf''文件中进行配置。这是DokuWiki的表情综览。
* 8-) %%8-)%%
* 8-O %%8-O%%
* :-( %%:-(%%
* :-) %%:-)%%
* =)%%=)   %%
* :-/ %%:-/%%
* :-\ %%:-\%%
* :-? %%:-?%%
* :-D %%:-D%%
* :-P %%:-P%%
* :-O %%:-O%%
* :-X %%:-X%%
* :-| %%:-|%%
* ;-) %%;-)%%
* ^_^ %%^_^%%
* :?: %%:?:%%
* :!: %%:!:%%
* LOL %%LOL%%
* FIXME %%FIXME %%
* DELETEME %% DELETEME %%
===== 样式 =====
[]可以通过简单的文本符号来表示特殊符号。这是能够被识别的符号的例子。
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"他想道'这是人类的世界'..."
<code>
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"他想道'这是人类的世界'..."
</code>
请注意：这些变化可以通过 []和 []关闭。
===== 应用 =====
有时你想表明一些话是回答或者评论，你可以使用这样的格式：
I think we should do it

> No we shouldn't

>> Well, I say we should
> Really?

>> Yes!

>>> Then lets do it!
I think we should do it
> No we shouldn't
>> Well, I say we should
> Really?
>> Yes!
>>> Then lets do it!
===== 表格 =====
DokuWiki支持简易制表。
^ 标题 1      ^ 标题 2       ^ 标题 3          ^
| 1 行 1 列   | 1 行 2 列    | 1 行 3 列       |
| 2 行 1 列   | 单元格合并（注意双分隔符）    ||
| 3 行 1 列   | 3 行 2 列    | 3 行 3 列       |
表格的标题行通过''^''来做首尾，普通行通过''|'' 来做首尾。
^ 标题 1      ^ 标题 2       ^ 标题 3          ^
| 1 行 1 列   | 1 行 2 列    | 1 行 3 列       |
| 2 行 1 列   | 列合并（注意双分隔符）      ||
| 3 行 1 列   | 3 行 2 列    | 3 行 3 列       |
如果要进行行合并，只需像上面那样，让下一单元格留空。确认每一行有相同数量的单元格分隔号！
纵向表头也能设置
|          ^ 标题 1          ^ 标题 2      ^
^ 标题 3   | 1 行 2 列       | 1 行 3 列   |
^ 标题 4   | 这次不进行列合并|             |
^ 标题 5   | 3 行 2 列       | 3 行 3 列   |
正如你所见，单元格的格式由它前面的单元格分隔号决定：
|          ^ 标题 1          ^ 标题 2      ^
^ 标题 3   | 1 行 2 列       | 1 行 3 列   |
^ 标题 4   | 这次不进行列合并|             |
^ 标题 5   | 3 行 2 列       | 3 行 3 列   |
注意：不支持行合并
你也可以设置对其方式，只要在文本的两面加入两个以上的空格：左面加入两个空格进行右对齐，右面加入两个空格进行右对齐，两边至少两个空格进行居中。
^         表格对齐方式                   ^^^
|      右对齐|   居中   |左对齐      |
|左对齐      |      右对齐|   居中   |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
这是源代码的表示：
^         表格对齐方式                   ^^^
|      右对齐|   居中   |左对齐      |
|左对齐      |      右对齐|   居中   |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
===== 无编译区块 =====
你可以通过在行首加入两个以上的空格（就像上面的例子）或者使用''code''或''file''的标签来表示无编译区块。
<code>
这是所有内容都保留的代码：就像            <-这样
</code>
<file>
这个非常类似，但是你可以用它来表示你引用了一个文件
</file>
为了让解析器完全忽略一块区域（也就是说不对其进行编译），可以附上''nowiki''的标签，或者更简单的是，使用两个百分号''<nowiki>%%</nowiki>''。
<nowiki>
这是一段包含这样的地址的文字：：http://www.splitbrain.org 和 **编译**，但是它们没被编译。
</nowiki>
请查看这段内容的源代码来查看如何使用这些手段。
===== 高亮格式 =====
[]可以将一段代码高亮，使它更易阅读。这是使用 [] 通用格式高亮器——支持GeSHi的语言都支持它。这个格式和前面一小节的代码区段很像，但是这次使用的语言标志是插入到标签内，比如''<nowiki><code java></nowiki>''。
<code java>
/**
* The HelloWorldApp class implements an application that
* simply displays "Hello World!" to the standard output.
*/
class HelloWorldApp {
    public static void main(String[] args) {
      System.out.println("Hello World!"); //Display the string.
    }
}
</code>
以下字符串都能被正确识别：//actionscript, actionscript-french, ada, apache, applescript, asm, asp, autoit, bash, blitzbasic, caddcl, cadlisp, c, c_mac, cfm, cpp, csharp, css, delphi, diff, d, div, dos, eiffel, freebasic, gml, html4strict, ini, inno, java, java5, javascript, lisp, lua, matlab, mpasm, mysql, nsis, objc, ocaml, ocaml-brief, oobas, oracle8, pascal, perl, php-brief, php, python, qbasic, scheme, sdlbasic, smarty, sql, tsql, robots, ruby, vb, vbnet, vhdl, visualfoxpro, xml//
===== HTML与PHP代码嵌入 =====
你可以通过使用''html'' or ''php''标签来向文档内嵌入HTML或PHP代码：
<code>
<html>
This is some <font color="red" size="+1">HTML</font>
</html>
</code>
<html>
This is some <font color="red" size="+1">HTML</font>
</html>
<code>
<php>
echo 'A logo generated by PHP:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
</php>
</code>
<php>
echo 'A logo generated by PHP:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
</php>
**请注意**：HTML和PHP嵌入在配置里面默认关闭。如果关闭，代码会被显示而不是被编译。
===== 格式插件 =====
DokuWiki的格式可以通过 [] 扩展。使用说明里有如何使用已安装的插件的描述。以下格式插件在这个版本的DokuWiki上是可用的：
~~INFO:syntaxplugins~~

汗。。。论坛的code模式有的显示还是不太对，干脆把源代码做附件贴上来吧。。。。。

[ 本帖最后由 zgbl 于 2009-2-2 09:37 PM 编辑 ]

zgbl 发表于 2009-2-2 21:40:04

再次修订

在申请得到whuan的同意后，我把wiki里的帮助文档syntax修改成了翻译版的
因为小生英语水平其实也不咋地，这个是查着google词典才搞定的，所以为保险，原版英文的备份我保留了下来

focus 发表于 2009-2-2 22:31:13

小弟不才，专业八级，有空来翻yct11

whuan 发表于 2009-2-2 22:35:07

xbt

haha

welcome focus

ajump 发表于 2009-2-4 11:36:28

小弟不才，曾经参与汉化过著名成人游戏Discipline北美无码版。对人类肢体的专有名词稍有研究，但是有空也不会来翻……嘎嘎。ttk_01
页: [1]
查看完整版本: Wiki翻译——http://pkuxkx.com/wiki/wiki/syntax