目录
简介
主要功能
登录 / 授权
将本地 markdown 文件发布到博客园
博客园博文列表
将本地文件关联到博客园博文
拉取远程博文内容更新本地文件
图片上传
博文分类管理
导出 pdf
博文设置面板
vscode 版本要求
插件设置
简介
博客园 vscode 插件,主要功能是将本地 markdown 文件对应到博文园中博文,从而让 vscode 用户可以一键发布 markdown 博文到博客园。
主要功能
登录 / 授权
要使用本插件发布 / 修改博文,需要先进行登录或授权操作。
将本地 markdown 文件发布到博客园
若本地文件已经关联到一篇博客园博文,那么会直接更新这篇博文。
也通过 vscode 的 Command Palette
(唤起 Command Palette
快捷键,windows:ctrl+shift+p
,macos:command+shift+p
)调用 Cnblogs: 保存到博客园
命令,将当前正在编辑的 markdown 文件保存到博客园上
博客园博文列表
当点击列表中的博文时,会自动将博文内容下载到工作空间一个本地文件中(此时这个本地文件就关联到了这篇博文),完成编辑后可以再将本地的内容保存到博客园博文
将本地文件关联到博客园博文
一个本地文件可以关联到一篇博客园博文,本地文件必须在 vscode-cnb.workspace
配置的工作目录中
拉取远程博文内容更新本地文件
本地文件和博文关联后,如果通过博客后台更新了这篇博文,此时本地文件是不会自动更新的,但是可以通过 Cnblogs: 拉取远程更新
命令来更新本地博文
可以在下面这些地方可以调用 Cnblogs: 拉取远程更新
博客园随笔列表视图中的博文的上下文菜单拉取远程更新
(仅已关联本地文件的博文)
编辑器上下文菜单中的拉取远程更新
(仅针对 markdown 文件)
文件浏览器上下文菜单中的拉取远程更新
(仅针对 markdown 文件)
vscode 命令面板 Cnblogs: 拉取远程更新
,此时会尝试去寻找当前正在编辑的文件对其进行更新
在更新本地文件之前会弹出确认对话框,因为此操作会覆盖本地文件的内容,所以请谨慎使用。
图片上传
当 vscode 处于配置好的 vscode-cnb
工作空间时,可以通过快捷键,上下文菜单,编辑器工具栏等方式上传本地或剪贴板中的图片到博客园
博文分类管理
支持新建,删除(可批量操作),修改博客园博文分类
导出 pdf
支持将博文导出为 pdf 格式的文件到本地,此功能依赖于 Chromium,vscode-cnb 默认会先从本地寻找是否有已安装的 Chrome 或基于 Chromium 的 Edge 浏览器,若有的话则会直接使用本地的 Chrome 或基于 Chromium 的 Edge; 若未找到,那么会提示用户手动选择本地的 Chromium 或其他基于 Chromium 的浏览器
也可以在 vscode 的设置中手动配置 Chromium 或其他基于 Chromium 的浏览器的可执行文件路径,这个路径针对 windows 和 macos 是不同的两个配置,可以根据自己使用的系统进行配置
支持多选
博文设置面板
首次发布本地 markdown 文件到博客园时,会打开博文设置面板允许编辑博文相关的设置
同时,也可以在博客园随笔列表视图,文件列表视图和 markdown 编辑器中上下文菜单中可以通过博文设置命令打开博文设置面板
vscode 版本要求
>=1.62.0
插件设置
workspace
:vscode-cnb
需要用到的一个工作空间,vscode-cnb
只有检测到 vscode 处于此目录下才会生效,默认会使用 ~/Documents/Cnblogs
作为工作空间