vscode 插件 Cnblogs Client For VSCode

目录

• 简介
• 主要功能
  • 登录 / 授权
  • 将本地 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 作为工作空间