怎样在 VS Code 创建文章

初始步骤

起步是最麻烦的, 可以找程序员帮忙, 后续就不用动这些了.

1. 安装 VS Code
2. 参考 Coding 的文档, 完成本地安装Git和设置用户信息这两步. 设置用户信息是需要用到两行命令的, 后续的操作都会在图形界面完成.
3. 在仓库页复制地址
   
4. 打开 VS Code 后点 “克隆 Git 仓库…” 然后粘贴地址
   
5. 回车后自己选一个文件夹, 然后确定, 下载完后, 按提示打开仓库

创建文章

1. 在左侧的文件视图展开 src\data\post, 应该能看到之前添加的文章. 单击或双击后将它打开
   
2. 点右上角的侧边预览可以打开侧边预览. 和 Coding 上的渲染一样, VSCode 自带的渲染效果不代表网页上的实际效果, 但可以帮你预览图片和大部分格式
   
3. 在左侧 post 文件夹右键菜单或者点 “新建文件”, 在 post 文件夹下新建一个 .md 为拓展名的文件, 比如 test2.md
4. 参考上一篇的格式写点内容, 有 title 属性就行
5. 按 Ctrl+S 保存文件

提交文章

在 Git 中，提交分为三个步骤：暂存更改、提交和推送。

• 暂存更改：暂存是将你修改过的文件添加到 Git 的暂存区，告诉 Git 你想要将这些更改包含在下一次提交中。暂存区的设计是为了让用户能选择要提交和不提交的文件, 虽然大部分情况下都是选择全部提交.
• 提交：提交是将暂存区中的更改保存到 Git 仓库的历史记录中。每次提交都相当于创建一个快照，记录了项目在某个时间点的状态。要注意的是, 提交只是在本地的 Git 新建了一个存档点, 需要在推送后, 这次修改才会出现在远程仓库.
• 推送：将本地 Git 仓库中的提交上传到远程 Git 仓库. VSCode 默认在提交后显示同步更改按钮, 同步就是拉取然后推送, 用同步可以确保在推送前获取远程仓库的其他提交.

操作流程

1. 点击侧边栏的 Git 图标，在“更改”部分找到你修改或新增的文件。点击文件旁边的加号图标（+）进行暂存。也可以点击“更改”上方的加号图标暂存所有更改。完成后可以看到文件从 “更改” 移动到 “暂存的更改”
   
2. 在消息框输入一些提交信息, 然后点 “提交”. 注意, 和 Coding 网页版不同, 在这个面板进行提交是必须要输提交信息的, 如果直接点了提交, VS Code 会打开一个编辑窗口让你填写提交信息. 一般直接在文本框里简单填点信息就行了.
   
   在提交后, 可以看到底下的源代码管理图多了一个提交记录, 而且本地仓库走在远程仓库前面
   
3. 点击 “同步更改”, 确认, 等待上传完成. 在源代码管理图可以看到远程仓库和本地仓库对齐了
4. 和之前一样, 可以在云原生构建看到新的构建事件, 以及在测试官网能看到新的文章

实际上, VSCode 还提供了一些简化的操作. 比如, 如果在提交时没有暂存, 会提示你是否提交所有未暂存的更改; “同步更改” 可以直接提交并推送. 在下一篇指南中会使用更简单的操作.