前言

Typora是书写markdown文档的一大利器。考虑到在各大技术交流平台上传md文档的需求,需要对md文档中的图片进行上传,以便于直接复制本地文件中的md文档直接上传网站。

此处Typora图片上传采用以下技术方案:利用PicGo-Core工具将一些公开不大的图片上传到gitee开源仓库中,以实现图床功能。

环境准备

该文档是在window操作系统下实现的,其他系统实现需另外参考Typora提供的技术文档说明来操作。

软件准备

  • Typora:该文档编辑软件为一次性付费软件,价格合理,请支持正版。具体安装细节参考“Typora安装”类别的技术文档。
  • PicGo-Core:这个可以在Typora中直接下载使用,具体操作参考下文“PicGo-Core安装”。
  • Node.js:具体安装细节参考“Node.js安装”类别的技术文档。此处需要用到这个来安装所需插件,如果不想留着可以在插件安装完成后卸载,不影响正常使用。

PicGo-Core安装

打开Typora,选择“文件”中的“偏好设置...”,在“图像”设置中的“上传服务”中选择PicGo-Core,并点击下方的“下载或更新”。

image-20241229164210305

image-20241229164331484

此处下载来源是GitHub,因此部分电脑或者网络环境可能会下载缓慢。我的解决方案:用GitHub上一个技术大佬提供的fastgithub开源项目解决访问和下载GitHub项目缓慢问题。(此处原理不做解释)

插件准备

  • gitee-uploader:必须安装,用于实现图片上传。
  • super-prefix:可选,作用是将图片重命名为日期格式,方便整理。

gitee-uploader、super-prefix安装

安装思路:在本地文件夹中找到PicGo脚本所在的目录,打开该路径下的cmd命令行,进行插件安装。

参考以下Typora文档说明,Typora安装PicGo-Core时生成的picgo.exe文件大致在C盘下用户文件夹中的“Roaming/AppData”下的“Typora/picgo”中。(具体操作系统文件层次可能略有不同,大家仔细翻翻,差不多这个位置)

image-20241229164426300

image-20241229164603980

在picgo.exe文件所在路径文件夹下打开cmd命令行,分别输入以下命令安装插件。

.\picgo install gitee-uploader
.\picgo install super-prefix

image-20241229164730972

仓库准备

创建仓库

在gitee主页导航栏中选择“新建仓库”,设置号仓库名、开源和初始化仓库(图片引导中忘记选这一步了,后续也开源初始化)。

image-20241229165125575

image-20241229165310757

image-20241230124529426

创建令牌

在gitee主页导航栏中选择“设置”,后选择个人设置页面中左侧导航栏中的“私人令牌”进行令牌创建。创建过程需填写令牌名(方便管理)、令牌权限(此处可只勾选前两项权限),提交后一定一定要记得保存一下生成的私人令牌哦,后续配置需要使用。

image-20241229165450000

image-20241229165524508

image-20241229170730318

image-20241229170818377

PicGo配置

最最最核心的一步来啦,编辑PicGo-Core的配置文件。通过Typora的“偏好设置”-“图像”-“打开配置文件”打开配置文件,根据以下代码对PicGo-Core上传图片进行配置。

{
  "picBed": {//设置图床
    "uploader": "gitee",//图片上传的图床选择
    "current": "gitee",//同上,根据官网手册,可不需要
    "gitee": {//设置gitee
      "branch": "master",//分支,默认就是master
      "customUrl": "",//可以不填
      "path": "images",//仓库中建立的文件夹,初始化以后自行创建
      "repo": "a_littlemiao/picgo",//“账号名称/仓库名称”,注意大小写敏感,要和网站链接保持一致
      "token": "d8sdadhiwhda2d14d7d67d3235dsdhiawd1"//私人令牌
    }
  },
  "picgoPlugins": {//设置插件,安装完插件后默认添加的
    "picgo-plugin-gitee-uploader": true,
    "picgo-plugin-super-prefix": true
  },
  "picgo-plugin-super-prefix": {//设置super-prefix插件
    "fileFormat": "YYYYMMDDHHmmss"
  },
  "picgo-plugin-gitee-uploader": {
    "lastSync": "2024-12-29 11:03:28"
  }
}

配置完保存后可在此处对配置进行验证,它会上传一张图到仓库中,并获取图片链接。验证成功后就可愉快的写文档啦!

image-20241229230543035

参考链接

posted on 2024-12-30 13:51  吞了一只鳄鱼  阅读(234)  评论(0)    收藏  举报