{{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|高级语法]] [[插件语法]]