===== 七个基本语法命令 =====
wiki 语法很简单,掌握七个基础语法,就能写出漂亮的文档。
==== 1. 加粗 ====
用两个**包含要加粗的文字,就可以加粗。例如:
```
**觉察**是最简单且最强大的修行方法
```
其效果为:
**觉察**是最简单且最强大的修行方法
******
###2.大小标题
用多个''#''表示标题,示例如下:
^示范^效果^
|#一级标题| {{:pasted:20240627-114208.png?150}}:::|
|##二级标题|:::|
|###三级标题|:::|
|####四级标题|:::|
|#####五级标题|:::|
|######六级标题|:::|
要注意,一旦用标题的方式,会在文档的右上角,自动生成目录。
___
###3. 分段
段落默认是用空行隔开的。要注意的是:如果两段文字没有空行,则会合并成一段文字。例如,空行分段:
```
早上醒来,即可开始练习起床觉察。
看见自己想继续睡懒觉的念头,感知自己当下身体睡觉的姿势,四肢的位置,被子的温度。
```
效果为:
早上醒来,即可开始练习起床觉察。
看见自己想继续睡懒觉的念头,感知自己当下身体睡觉的姿势,四肢的位置,被子的温度。
但如果中间没有空行:
```
早上醒来,即可开始练习起床觉察。
看见自己想继续睡懒觉的念头,感知自己当下身体睡觉的姿势,四肢的位置,被子的温度。
```
则效果为:
早上醒来,即可开始练习起床觉察。
看见自己想继续睡懒觉的念头,感知自己当下身体睡觉的姿势,四肢的位置,被子的温度。
____
###4.文字颜色
用特定的语法,可以表示文字颜色:
```
你喜欢**蓝狮子**吗?
不,我喜欢红狮子!
```
其效果为:
你喜欢**蓝狮子**吗?
不,我喜欢红狮子!
上面的例子同样的颜色值,还可以是:blue, white ,black ,yellow, green, orange.....
也有更灵活一点的,可以设置背景颜色:
```
text
text
text
text
text
text
```
效果如下:\\
text
text
text
text
text
text
`看不懂?我也看不懂,写的时候模仿一下就行。嫌麻烦就用最初的几个就好。`
看不懂?我也看不懂,写的时候模仿一下就行。嫌麻烦就用最初的几个就好。
-----
### 5.增加链接
在 wiki 中的文件,都是以网页形式存在。可以任意在文本中增加链接。
wiki 会自动识别外部链接,`https://www.baidu.com`, 会自动加上链接:https://www.baidu.com
你也可以给外部链接加上链接文本:`[[https://www.baidu.com|链接到百度]]`,是这样的:[[https://www.baidu.com|链接到百度]]
对于我们wiki内部的链接,可以直接用:`[[基础入门题]]`,则会自动链接到文件[[基础入门题]]
若内部链接的名字是英文的,你可以增加链接文字:`[[jsb:home|链接到技术部首页]]`,其效果为:[[jsb:home|链接到技术部首页]]
若内部链接是无效的(没有链接指向的页面),则会指向一个不存在的页面,此时,你可以新建这个页面。这也是 wiki 中**新建文件**(新建页面)的方法。例如
``[[我并不存在]]`` 显示为:[[我并不存在]]
**建议:**
`[[我并不存在]]`只是一个例子,只是告诉同学们新起一个子页面很方便,大家不要照着做就新起一个`[[我并不存在]]`的页面并点击链接就进去这个子页面创建和编辑内容了,因为这样起名字会在同一目录下产生同一个文件,例如你在测试组,就会产生同一个文件:`csz:我并不存在`,如果大家都在上面创建了内容并修改,就会产生不同的同学在修改同一个文件的结果。
大家在理解这个语法的基础上,应该这样新起一个`[[我并不存在]]`的子页面
例如你的名字叫超越,你就应该这样起新的页面:
`[[csz:chaoyue:wbbcz|我并不存在]]`,其中:csz是测试组的首个字母,chaoyue即你的名字,这两项是固定的。
wbbcz是我并不存在的首个字母,你可以任意修改成你想要的字母,“我并不存在”这几个字也可以任意改变成你想要起的新页面的名称。
查看下一个命令:👇
-------
### 6.新建页面
按照上面的步骤,出现红色的[[我并不存在]]点击及以上的建议,会生成一个新的“该主题尚不存在”的页面,如下图:
{{:pasted:20240701-182519.png}}
点击右侧的小铅笔图案(第一个)(**不要在本页点击,你可能没有权限的**)
{{:pasted:20240701-182632.png?150*80}}
如果是手机操作,会有些不同,如下图:\\
{{:wiki:pasted:20240702-094155.png?400*400}}
就可以直接编辑,按照之前的语法编辑,
{{:pasted:20240701-182848.png?300}}
最后点击保存,新页面就生成了。
___
### 7. 添加图片
在 wiki 中添加图片非常容易,你可以复制某张图片或者用屏幕截图,然后直接粘贴就好(windows 用 ctl+v, Mac 用 cmd+v)
你在指定位置粘贴后,系统会自动把图片上传到 wiki,然后生成类似下面的文件语法:`{:pasted:20240701-182848.png}} `(第6 步生成文件的例子中,就是用这种方法)
如果你想指定图片的宽度和高度,可以用两个数字分别表示,如`{{:pasted:20240701-182848.png?300*200}} `
也可以用单个数字,如`{{:pasted:20240701-182848.png?200}} `调整这些数字可以通过预览观察实际的页面显示效果。
还可以用前后空两格来使图片放在页面中间的位置,如`{{ :pasted:20240701-182848.png?100 }} `详见点击本页最后的图像及格式。
如果是链接网络图片更加方便:
`{{https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png}}`
{{https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png?200*100}}
更详细的图片格式,可以参考这里[[target=blank|https://www.dokuwiki.org/zh:wiki:syntax#%E5%9B%BE%E5%83%8F%E5%92%8C%E5%85%B6%E5%AE%83%E6%96%87%E4%BB%B6|图像及格式]]