# note-book 介绍与规约
TIP
旧的笔记 essay-note (opens new window) 将停更,新的笔会用本项目记录。
# 项目目录结构
TIP
建设中...
# 关于排版
中文文案排版指北 https://github.com/zq99299/chinese-copywriting-guidelines
中文文案排版指北,中的示例的确可以让文章整体看起来很舒服。所以尽量遵循该排版规则
# 关于图片存储
由于 Markdown 自身的特性,大部分的编辑器对图片的添加支持都不是很好
每次添加图片都很麻烦,基本上都要经过以下步骤:
- 截图保存在本地,
- 复制图片到指定项目目录下,一般为:/assets/image
- 复制图片路径,写图片语法
对于一些插件来说,省略了复制这一步骤,但是对于图片保存的路径有很多不同处理方法。都需要自己手动或则写死一个路径,实在是很麻烦。
GitBook3 以后官网放弃了离线版本的支持,所以就丢掉了离线版的 GitBook 编辑器,而改用使用 Atom 编辑器。
偶遇一个 Atom 中的图片处理插件 markdown-img-paste ;
该插件最方便的在于只要复制图片,然后使用快捷键 ctrl + shift + v 粘贴图片, 就完成了 Markdown 的图片插入,默认保存在当前文件的 assets 中。
这个过程很方便,所以图片保存就近原则,而不是分离。这能节省很多时间;
|- chapter
|- git
|- assets # 图片和当前编辑文件在同一目录的assets中
|- imageA
|- imageB
|- github.md
1
2
3
4
5
6
2
3
4
5
6
以上目录存储结构,在使用过程中依赖插件的自动完成,方便和节省更多的写书时间
# vuepress 构建基础教程
如果你也想拥有自己的项目笔记,这个基础教程可能是一个不错的选择