## 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}}
**第二种**:也可以直接进入页面进行编辑更改名称
🌟🌺**注意: **不管哪种方式更改命名,文件内容被重命名后位置会发生转移,原来位置的文件会变成空白需要重新编辑。所以操作此项功能时要谨慎,不然找不到文件内容不要😭。要求熟悉[[bjzl:wiki:namespace|命名空间]]、目录结构、基础语法的新建页面及内、外部链接后才去操作
-----
### 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|返回主页]]