Skip to content

cnblogs/vscode-cnb

Repository files navigation

Visual Studio Marketplace Version Visual Studio Marketplace Downloads Visual Studio Marketplace Rating GitHub Workflow Status (branch) GitHub GitHub issues

目录

功能概览

登录 / 授权

要使用本扩展发布 / 修改博文,需要先进行登录或授权操作。

扩展同时支持浏览器授权和个人访问令牌(PAT)授权,PAT 可通过 https://account.cnblogs.com/tokens 创建。

将本地 markdown 发布到博客园

若本地文件已经关联到一篇博客园博文,那么会直接更新这篇博文。

也通过 VSCode 的 Command Palette(唤起 Command Palette 快捷键,windows:ctrl+shift+p,macOS:cmd+shift+p)调用 Cnblogs: 上传到博客园命令,将当前正在编辑的 markdown 上传到博客园。

在上传博文时,扩展会保留 YAML front matter,此行为可于设置中变更。

博客园博文列表

当点击列表中的博文时,会自动将博文内容下载到工作空间一个本地文件中(此时这个本地文件就关联到了这篇博文),完成编辑后可以再将本地的内容上传到博客园。

搜索博文

在博文列表的工具栏中,包含一个搜索的图标,点击这个图标可以触发搜索功能,点击后会先要求输入关键词,输入完成后按回车确认,搜索结果将在列表中进行展示。

列表中的 搜索结果 那一项的工具栏包含两个可以使用的命令,分别是 刷新搜索结果清除搜索结果; 也可以通过右键上下文菜单调用这两个命令。

将本地文件关联到博客园博文

一个本地文件可以关联到已有的博客园博文,VSCode打开本地文件,在右键菜单中点击关联博客园博文

拉取远程博文内容更新本地文件

本地文件和博文关联后,如果通过博客后台更新了这篇博文,此时本地文件是不会自动更新的,但是可以通过 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 发布到博客园会导致图片无法正常展示,为此我们提供了 提取图片 功能,您可以通过编辑器的上下文菜单调用此功能。

image

也可以在设置中配置上传到博客园时自动提取图片。

image

此功能除了可以提取本地图片,也可以提取其他承载在第三方图床中的图片。

image

此功能会上传图片到博客园然后替换源 markdown 中的图片链接。

博文设置面板

首次发布本地 markdown 到博客园时,会打开博文设置面板允许编辑博文相关的设置。

同时,也可以在博客园随笔列表视图,文件列表视图和 markdown 编辑器中上下文菜单中可以通过博文设置命令打开博文设置面板。

闪存

本扩展支持对闪存进行查看发布评论等操作,在侧边栏博客园视图中,展开 闪存 即可; 点击闪存标题栏中的加号图标可以发布新闪存。

也可以在编辑器中选中一段文本或代码,然后鼠标右键唤起上下文菜单,可以将选中的内容发到闪存。

PS: 上下文菜单的"将选中内容发到闪存"功能默认处于禁用,您可以在 VSCode 设置中启用此功能 demo-settings-enable-publish-select-to-ing

编辑完内容后回车会弹出确认框,此时如果需要添加标签或者修改访问权限,可以使用确认对话框中的 编辑访问权限 编辑标签编辑内容 选项。

也可以通过 VSCode 命令面板(ctrl/cmd+p唤起命令面板)调用发闪存命令。

通过本扩展发布的闪存,在尾部会显示一个 VSCode 图标。

此外,扩展设置中提供了用于调整闪存用户头像和星星样式的选项,或许能进一步改善您的摸鱼体验。

Markdown 语法扩展

本扩展可以让 VSCode 中的 markdown 预览支持博客园中扩展的 markdown 语法,您可以通过设置来控制是否要启用此功能。

使用示例:

复制博文链接

文件浏览器和随笔列表中的上下文菜单里有复制博文链接选项,点击后可以复制不同格式的博文链接。

https://img2023.cnblogs.com/blog/35695/202301/35695-20230130155516202-1979736560.png

默认的的链接形如: https://www.cnblogs.com/cmt/p/47365.html
Markdown 下的链接形如: [博文标题](https://www.cnblogs.com/cmt/p/47365.html)
也可以选择仅复制博文的Id。

博客备份

您可以通过本扩展创建或浏览您的博客备份。

博客备份说明

博客备份会将您的博客中的随笔,文章等数据导出到一个 SqLite 的数据库文件中,此操作为耗时的任务式操作,完成后您可以在 博客后台本扩展 中下载备份文件(后缀名为 .db.zip)

创建博客备份后,在博客备份记录列表中,您可以看到博客备份记录的状态会实时更新。

您可以通过下载按钮将博客备份下载到本地; 下载过程中您可以看到实时的下载进度; 下载完成后,扩展会帮您自动进行解压(解压完成后会自动删除源压缩文件)。

您可以在扩展中浏览您博客备份中的博文。

您可以删除博客列表中的备份记录,已下载备份。

VSCode 版本要求

1.70.0 或更高。

扩展设置

  • workspace:扩展需要用到的工作空间,扩展仅当检测到 VSCode 处于此目录下才会生效,默认值为 ~/Documents/Cnblogs

问题反馈

您可以将任何问题或建议反馈至 GitHub Issues,我们会尽力解决。这对改善扩展体验至关重要。