05c5f7f1
 liuqimichale
init
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
|
# 如何编辑 amWiki 轻文库
文库创建后，您就可以编辑自己的文库了
## 基本编辑
1. ##### 新建文件或文件夹，组织您自己的文库
2. ##### 每个文件夹或文件要求使用 `id-名称.md` 来命名，其中：
1. id 仅允许 **整数** 或 **浮点数** 类型，且 **不可重复**
2. 必须使用连 **接符** 或 **下划线** 将 id 与后续具体名称相连
3. 文件只能使用 **.md** 扩展名
如果未能满足以上条件，将弹出以下错误提示：
正确的命名，例如：
3. ##### 使用 Markdown 语法编辑您的文档
## 扩展编辑
1. ##### library 文件夹下 `首页.md` 文档为默认打开时的显示内容
您可以适当修改此文档内容以符合您的项目需求
5. ##### `$navigation.md` 导航文件无需人工维护，创建新文件夹或文件时将自动更新，也可以在菜单栏手动刷新：
菜单栏 -> amWiki文库 -> 手动更新当前文库导航文件
6. ##### 如果需要在 Markdown 文档中插入图片，**请先截图**，然后在文档对应位置使用快捷键：`Ctrl + Shift + V`
此时，光标位置将多出一段 Markdown 图片代码，例如：
同时，将在项目目录依次创建文件夹 assets、001 (如果不存在的话)，以及此文件夹下名称为 04-b7efbbde.png 的图片文件
7. ##### 对于较长文章，可以使用页内目录，依次进行如下操作，或使用快捷键 `Ctrl + D`，即可在光标处插入页内目录。
菜单栏 -> amWiki文库 -> 提取h2、h3标题为页内目录
注意：请按顺序使用h1、h2、h3，且h1仅使用一次。
8. ##### 如果启用了测试模块，想对一篇文档激活接口测试功能，请参照 [使用测试模块测试接口](?file=001-学习amWiki/06-使用测试模块测试接口)
## 维护与延伸
1. 本插件升级后，您想更新 `(projectName)/amWiki/` 文件夹下 web 端的工作文件，您只需重新打开 `config.json` 文件，然后在 Atom 菜单上选择 `通过“config.json”创建新文库` 即可。
这个二次创建操作不会影响您 library 与 assetes 文件夹下的内容。
2. 借助版本管理 SVN、Git、Hg，传输协议FTP/SFTP，文件同步Dropbox、百度云等等工具，便捷实现网络访问。
|
