如何为Typora配置图床,实现图片自动上传

在项目开发中经常会使用Typora记录下一些笔记,此时会用到一些图片。但如果图片存在本地的话,当更换设备或移动位置,或者将这些笔记发布到网上时,则会出现图片丢失或无法识别的问题。因此需要为Typora配置图床,当在笔记中添加图片时自动上传该图片到“已配置成功”的图床中。实现步骤如下:

1.安装node.js

官网:Node.js

PS: 检测是否安装成功

Win + R输入cmd打开命令行窗口,输入“node -v”,“npm -v”,如下图所示则代表安装成功:

2.Gitee图床仓库创建:

1).创建图床仓库:

登录“gitee.com”网站后点击右上角“+”创建新仓库:

 image-20230108230847420

注意:

1.新创建的仓库一定要勾选“Readme文件”,其他保持默认即可

2.Gitee网站改版后无法直接在创建仓库时设置其为“开源”,只能在创建完成后在“仓库设置”中再修改。具体修改方式:菜单栏“管理 -> 仓库设置 -> 基本信息”,勾选“开源”即可

image-20230108231502624

2).生成私人令牌:

“Gitee”网站点击右上角头像:

 点击左侧菜单中“安全设置 -> 私人令牌”:

image-20230108233735501

点击右上角“生成新令牌”:

image-20230108233924639

在“权限”中只需要勾选以下两个即可:

image-20230108234146254

之后点击“提交”即可生成“私人令牌”。

PS:这里成功创建的“私人令牌”的编码需要保存起来,用于后续PicGo中图床参数配置。因为在Gitee中创建“私人令牌”后,只有在此时才可以看到该令牌的详细编码,之后无法在任何地方再查询到,因此如果该令牌后续需要用在如Typora图床等地方,则需要预先暂存该编码,否则只能重新创建新的“私人令牌”)

3.PicGo安装及配置:

1).PicGo安装:

PicGo下载:Releases · Molunerfinn/PicGo · GitHub,选择“正式版”,这里安装的是“PicGo-2.3.1”

2).Gitee插件安装:

在PicGo左侧菜单栏“插件设置”中搜索“gitee”,选择“gitee-uploader 1.1.2”安装

 PS之前的插件“gitee 2.0.5”已经无法上传图片,会报错“【上传异常】403 Forbidden”。故这里选择新版插件“gitee-uploader 1.1.2”,经过测试可以正常使用

3).Gitee上传配置:

参数解析

repo”: 代表gitee上新创建的仓库的链接,但注意:这里不能直接使用“仓库名称”,而应该使用仓库的链接地址中“https://gitee.com”后续的内容:(该信息可在“管理 -> 仓库设置 -> 基本信息”中找到)。

“branch”:指gitee图床仓库中使用的分支名,默认为“master”(有的仓库默认分支为“main”),并且也可以使用仓库中的其他分支,因此可以根据需求自由填写使用的分支

“token”:指之前生成“私人令牌”密钥

“path”:上述设置了使用的仓库分支,如果需要将图片上传到指定分支下的指定文件夹中,则可以在此填写文件夹名字,如需要将图片上传到“main”分支下的“Typora”文件夹中,则设置“path”为“Typora”即可(但需要先确保远程仓库的“main”分支下有文件夹“Typora”,否则会上传失败)

 “customPath”: 上传图片后生成的链接中的“图片名字”

  • “default”代表保持图片原本的名字

  • “年/年季/年月”代表根据当前时间对图片链接重命名,通常选择“年月”

“customUrl”:保持默认,不做改变

4.在Typora中配置“图片上传”:

1).设置“插入图片时”执行“上传图片”操作:菜单栏“文件 -> 偏好设置”

2).在下方的“上传服务”中选择“PicGo(app)”:

 PS:

1.Gitee图床仓库必须为“公有仓库(开源)”,否则图片上传时会因为缺少权限而失败

2.可以在PicGo应用程序的“相册”中随时查看当前已上传的图片(该“相册”与“远程图床仓库”中包含的图片内容一致)。因此当删除“相册”中任意图片时,“远程图床仓库”中该图片也会被自动删除

3.当需要验证配置是否正确时,可以直接使用“验证图片上传选项”。如果上传失败,则可在以下路径查看log文件C:\Users\xxx\AppData\Roaming\picgo\picgo.log,避免盲目纠错

4.上传图片时出现报错“【上传异常】403 Forbidden”,出现该报错的原因大概有两种:

1).PicGo中的Gitee插件已经失效,需要更换新版的Gitee插件,如“gitee-uploader 1.1.2”

2).“远程图床仓库”的“在线修改”功能未开启。此时在Gitee仓库中,点击“管理 -> 仓库配置 -> 功能配置 -> 在线编辑”,勾选“允许仓库文件在线编辑”即可