{{page>:tabs#syntaxtabs}}
====== 基础语法 ======
本站采用dokuwiki生成,但是dokuwiki的语法与真正的维基百科语法还是有许多区别的,因此需要您学习基于dokuwiki的维基语法,才能进行创作和修改。
维基语法初看起来十分深奥,其实并不难学,我会在这篇文章内向你介绍基本的维基语法。
你可以在 [[:playground:]] 中随意创建和修改页面,用来学习下面的语法。建议使用预览功能,无需频繁在页面与源码之间进行切换。
===== 链接就是一切 =====
维基语法最核心、最重要的功能就是链接,整个维基系统都是围绕着链接而形成的。
在维基中使用链接非常简单,使用两个方括号即可生成一个指向目标的链接。
[[start]]
[[start]]
如果你想更改链接的名称,只需要使用一个分隔符即可指定链接的名称。
[[start|开始页面]]
[[start|开始页面]]
另外,dokuwiki拥有[[:wiki:namespace|命名空间]]的概念,需要使用冒号 '':'' 或者反斜杠 ''/'' 来区分页面的位置,不过一般只建议使用冒号。
[[:wiki:start|帮助页面]]
[[/game/start|游戏百科页面]]
[[:wiki:start|帮助页面]]
[[/game/start|游戏百科页面]]
如果你需要链接到一个外站,格式与普通的链接方式相同。
[[ https://clso.fun/ | 我的主页 ]]
[[ https://clso.fun/ | 我的主页 ]]
你也可以直接将URL链接放在文章内 https://clso.fun www.clso.fun,后台会自动解析出地址。
你也可以直接将URL链接放在文章内 https://clso.fun www.clso.fun,后台会自动解析出地址。
----
另外,如果你指向一个[[not_exist|不存在的链接]],它与一个[[start|存在的页面]],所展现的链接样式是不同的!
另外,如果你指向一个[[not_exist|不存在的链接]],它与一个[[start|存在的页面]],所展现的链接样式是不同的!
链接一个空页面,是提醒其他用户可以帮忙完成该页面,这也正是维基系统的精髓。
===== 格式化字符 =====
DokuWiki支持 **粗体**,//斜体//,__下划线__ 以及 ''等宽体'' 等格式。
当然,您可以 **__//''混合使用''//__** 这些格式。
DokuWiki支持 **粗体**,//斜体//,__下划线__ 以及 ''等宽体'' 等格式。
当然,您可以 **__//''混合使用''//__** 这些格式。
您也可以使用下标和上标。
您也可以使用下标和上标。
同时也可以使用删除线标记某些信息。
同时也可以使用删除线标记某些信息。
----
**注意:本站已使用插件解决换行问题,只需要使用回车,并不需要%%\\%%进行短换行。**
**段落**是由空行所建立的。如果您想**强制换行**而不建立段落,您可以使用两个连续的反斜杠接空格或回车作为标记。请看样例:
这是一些有着换行标记的文字。\\ 请注意
双反斜杠只在回车符之前\\
或者接在\\ 一个空格之前的时候才有效。\\而这样就并不起作用。
这是一些有着换行标记的文字。\\ 请注意
双反斜杠只在回车符之前
或者接在\\ 一个空格之前的时候才有效。\\而这样就并不起作用。
===== 图像 =====
**觉得维基图像代码太繁琐?欢迎使用 [[img| 和 ]] 标签来创建图像!**
维基使用两个花括号来定义图像,比如引用一个位于 '':playground:pasted:'' 空间下的媒体文件,可以用下面的语法:
{{:playground:pasted:20191005-063104.png|图像标题}}
{{:playground:pasted:20191005-063104.png|图像标题}}
你也可以直接引用网络图片:
{{https://clso.fun/wiki/_media/playground/pasted/20191005-063104.png|图像标题}}
{{https://clso.fun/wiki/_media/playground/pasted/20191005-063104.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|默认图片}}
{{wiki:dokuwiki-128.png?direct|直接跳转图片地址}}
{{wiki:dokuwiki-128.png?nolink|禁止点击图片}}
{{wiki:dokuwiki-128.png|默认图片}}
{{wiki:dokuwiki-128.png?direct|直接跳转图片地址}}
{{wiki:dokuwiki-128.png?nolink|禁止点击图片}}
----
图片链接也非常简单,只需要结合链接语法即可:
[[:wiki:start|{{wiki:dokuwiki-128.png|图片链接}}]]
[[:wiki:start|{{wiki:dokuwiki-128.png|图片链接}}]]
===== 标题与分节 =====
您可以使用多达5层的标题来组织您的内容。
如果您使用了三个以上的标题,将自动生成目录。
可以通过在页面加入''%%~~NOTOC~~%%''字样来禁用目录。
====== h1标题 ======
===== h2标题 =====
==== h3标题 ====
=== h4标题 ===
== h5标题 ==
===== 列表 =====
DokuWiki支持带编号或不带编号的列表。要创建列表,在文字前加入两个空格,然后使用*标记不带编号的列表,用-标记带编号的列表。
* 这是一个列表
* 第二项
* 您可以有不同的层次
* 另一项
- 带编号的列表
- 另一项
- 用缩进表示更深的层
- 就这样
* 这是一个列表
* 第二项
* 您可以有不同的层次
* 另一项
- 带编号的列表
- 另一项
- 用缩进表示更深的层
- 就这样
===== 文本转换 =====
本站维基系统支持表情与预定义字符的替换。
其中的表情系统,可以直接使用编辑器内的表情图标来插入。
''%%:huaji:%%'' = :huaji:
而预定义字符的替换,请参阅下面这些页面:
[[game:icon|游戏百科用图标]]
''%%:STEAM:%%'' = :STEAM:
===== 脚注 =====
您可以使用两个连续小括号来添加脚注((这是一个脚注))。
您可以使用两个连续小括号来添加脚注((这是一个脚注))。
脚注会在页面底部生成链接及信息。
===== 更多教程 =====
[[syntax-more|高级语法]]
[[插件语法]]