## wiki 进阶语法篇 以下内容是进阶语法，平时用到的概率不高，但若掌握了，会让文档增色不少。继续加油！ ### 1.列表 Dokuwiki 支持带编号或不带编号的列表。要使用列表，在输入的符号前加两个空格，然后使用`*`符号代表不带编号的列表；用`-`或`1.`符号代带编号的列表，添加符号后再增加一个空格。请看以下示例中空行和空格，否则可能不会生效。 ``` 不带编号的列表： * 列表 * 第二项 * 下一层 * 第三项 带编号的列表： 1. 第一项 1. 第二项 1. 用缩进表示更深的层 1. 第三项 ``` 不带编号的列表： * 列表 * 第二项 * 下一层 * 第三项 带编号的列表： 1. 第一项 1. 第二项 1. 用缩进表示更深的层 1. 第三项 ### 2.表格 表格分成两部分，第一行是说明用`^`来分割。以后的行是内容，用`|`分割。下面是一个最简单的表格： ``` ^名称^开营日期^内容^ |看见村|2024.6|看见村要开营了| |听见村|2024.7| 听见村也要开营了| ``` ^名称^开营日期^内容^ |看见村|2024.6|看见村要开营了| |听见村|2024.7| 听见村也要开营了| **每行必须是以^或|开头或结尾，^或|之前不能有空格** 更详细的表格可以查看这里：[[target=blank|https://www.dokuwiki.org/zh:wiki:syntax#%E8%A1%A8%E6%A0%BC|表格语法详细解释]] ___ ### 3.水平线 使用四个或者更多短横可以划出一条水平线来(短横之前需要加上一个空行)示例： ``` 天下之大，无奇不有。 ------ 地广人稀，物产丰富 ``` 显示效果为： 天下之大，无奇不有。 ------ 地广人稀，物产丰富 ------ ### 4.命名空间(此题可以加深对基础语法中的内部链接和新建页面的理解，不需要做） 这部分内容很重要，如果设置不好，会造成文件存放结构混乱。 命名空间的原理，类似文件目录。 当你写一个链接`[[newpage]]`就是链接当前目录下的`newpage`页面。 `[[csz:newpage]]`表示链接 `csz`目录下的`newpage`的页面。 `[[jsb:testpage]]`表示链接`jsb`目录下的`testpage`的页面。 其实，也不用管目录，只需要理解，同一类型的页面，尽量放到同一个命名空间下（目录下）。 更详细的命名空间解释可以查看这里：[[target=blank|https://www.dokuwiki.org/zh:namespaces|命名空间详细解释]] ------ ### 5.新窗口打开链接 我们之前学过[[wiki:jcyufa#新建页面|如何增加链接]]，默认都会在当前页面下打开新页面。但有时我们需要在新窗口打开页面，则需要做一些调整。在前面添加`target=blank`。 外部链接：``[[target=blank|https://baidu.com|百度]]``效果是：[[target=blank|https://baidu.com|百度]] 内部链接：``[[target=blank|wiki:jcyufa|基础语法]]`` 效果是：[[target=blank|wiki:jcyufa|基础语法]] 是不是很方便?😎 ------- ### 6. 脚注 用两个英文括号，会显示数字标注，其内容会放到页面底部。 ``` 《觉察之道》((作者蓝狮子))是一本不错的书。必经之路((成立于 2016 年))是个有意思的公益组织 ``` 显示效果为： 《觉察之道》((此书作者是蓝狮子))是一本不错的书。必经之路((成立于 2016 年))是个有意思的公益组织 嗯，查看这个页面的底部，是不是有了这个内容：\\ {{:wiki:pasted:20240701-215924.png?200}} 这个功能也不是那么常用，写出来凑个数。 ------ ### 7.上传文件。 有时文档，需要添加文件，除了图片，还可以上传类似音频文件，pdf 文件等。具体步骤如下： a)点击编辑页面上部的按钮：\\ {{:wiki:pasted:20240701-215814.png?400}} b)出现上传的界面：\\ {{:wiki:pasted:20240701-220120.png?300}} c)点击`选择文件`就可以上传了。 d)上传后，文件名会出现在列表中，点击文件就可以获得链接了。例如： ``` 这个是桔子觉察的链接{{ :tky:juzijuecha.mp3 }} ``` 效果如下： 这个是桔子觉察的链接:{{ :tky:juzijuecha.mp3 }} ****** ### 8.表情符号 如果我们想使用表情来更直接的表达，可以打开下方链接选择需要的表情，点击后会出现对话框，再点击copy后复制在文档内。 [[target=_blank|https://emojicopy.com|表情符号]]💃😇🌹🌊 ****** ### 9.符号不格式化 遇到需要引用符号不想格式化时，有以下两种方式来完成。 👉**第一种**:用内容的格式： **我是红狮子** 显示为： **我是红狮子** 👉**第二种**:用`内容`的格式： `**我是红狮子**` 显示为： `**我是红狮子**` **我是红狮子** 🤗又学了一招了 ***** ### 10.恢复旧版本 如果我们想恢复以前的文件，可以通过以下方式去完成。 **第一步：**点击页面右侧一个带箭头的半圈小闹钟形状的图标，进入“过去修订”页面。 {{:pasted:20240627-151046.png?300}} **第二步：**点击页面右侧一个小闹钟形状的图标，进入“过去修订”页面。 **第三步：**找出想要恢复的文档，这里： 👉可以先点击小眼镜进行对比。 👉也可以直接点击右侧的页面形状的图标，进入页面看看是否是需要恢复的文档内容。 {{:pasted:20240627-152106.png?300}} **第四步：** 再点击右边带箭头的半圈，恢复以前的文档即可。 {{:pasted:20240627-152615.png?300}} ***** ### 11.页面重命名 (参加内测的同学不用做） 如果想重新给页面命名的话，可以通过以下两种方式来完成👇： **第一种**:点击页面右侧刷子形状的图标，进入页面重命名界面。然后按指示操作。 {{:pasted:20240627-153928.png?200}} **第二种**:也可以直接进入页面进行编辑更改名称 🌟🌺**注意: **不管哪种方式更改命名，文件内容被重命名后位置会发生转移，原来位置的文件会变成空白需要重新编辑。所以操作此项功能时要谨慎，不然找不到文件内容不要😭。 ----- ### 12.引用（选做题） 本题作为**选做题**，供有兴趣的同学参考和使用，引用的语法用起来有一定的要求，尤其是**两个以上**的引用语法连续使用的时候，语法用错了，右边的编辑菜单的四个按钮就会丢失，因此不建议连续使用两个以上的引用语法，除非你通过反复练习熟悉后，并参考最后使用的例子，不排除将来出现问题再次下架。 引用的语法就是在英语状态下输入大写字母``>``作为引用符号后再输入文字内容，当第一个引用符号输入后， >项目1 会产生如下的效果： >项目1 要使用第二个引用，就需要隔开一行，并且在隔开的空行中的最前面要空一格，第二个引用才能生效。 >项目1 >项目2 这时候如果要使用第三个引用开始，就要特别注意了，除了需要隔开一个空行，并且在这空行中的最前面也要空一格，第三个引用才能生效，**需要重视的是，在第三个引用前面的空行，必须要在空行中的最前面产生一个空格，如果不产生这个空格，除了不能显示语法的效果，还会导致右边的编辑菜单上的四个按钮丢失，如此类推。** >项目一 >>项目二 >>>项目三 正确语法输入后显示效果如下 >项目一 >>项目二 >>>项目三 当错误的语法输入后，预览时如下图你将看不到右边的编辑菜单，丢失菜单时如果你保存了页面再进去编辑时，必须要在地址栏加上?do=edit才能重新进入页面的编辑状态。 {{:csz:fqa:pasted:20240819-190758.png}} 正确应用“引用”语法，举两个例子供参考 [[target=_blank|csz:考试页面|一页书]] 和 [[target=blank|dslm:gjq:jczd|觉察之道]]，可点击显示源码看看。 ****** 更多问题解答请移步👉[[target=_blank|wiki:wengdangxuexi|如何在DOKUWIKI里创建、编写文档，及常见问题]] ----- [[target=blank|csz:home|返回主页]]