Typora + GitHub = 效率
Typora 是一款简单、高效而且优雅的 Markdown 编辑器,它提供了一种所见即所得的全新的 Markdown 写作体验。它把源码编辑和效果预览两者合二为一,在输入 Markdown 代码的时候即时生成预览效果。Typora 的一切都围绕纯粹的生产效率而设计。Typora一直是老逛最喜欢的 markdown 编辑器,写博客、记笔记的首选软件。相信大部分朋友也在使用 Typora 这款软件。但是 Typora 之前是不支持图床功能的,只能通过第三方插件实现图片自动上传的功能。不过最近 Typora 有了更新,终于支持图床功能了,接下来我会分别介绍借助插件上传图片和 Typora 自身的图床功能。老逛亲身体验,Typora 软件自带的图片上传功能很慢,不如自己写的插件好用。1. 借助插件实现自动上传之前老逛也是使用第三方插件进行图片的上传,该插件安装后的使用效果如下:插件配置接下来可以配置将图片上传到哪个图床,打开 plugins/image/upload.js 文件,拉到最下面 将最后一行的 $.image.init(); 按照下面的说明进行配置:上传到Github - 推荐免费且无需自己搭建服务器,流量交易是一种不错的方式,配置中需要填写token,添加 token 可登陆 GitHub后访问此链接:https://github.com/settings/tokens仅给 typora 使用的 token 授予最小的权限(repo.public_repo) 即可。
//注册token的尽量不要跟其他应用共用,同时授予最小权限
//免费+无需自己搭建服务器,是一种不错的方式
$.image.init({
target:'github',
quality:1, //图片压缩开关,1表示原图上传 取值为:0<quality<=1,如果要压缩推荐 0.7
github:{
Token : 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', // 添加一个仅给typora使用的token 授予最小的权限(repo.public_repo) ,添加token:https://github.com/settings/tokens
CommitterName : 'nickname', // 提交人昵称,写你github的昵称
CommitterEmail : 'email@mail.com', // 提交人邮箱,写你github的邮箱
Repository : 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', // github项目名,比如你的项目地址是:https://github.com/Thobian/typora-plugins-win-img 那就是后面的“Thobian/typora-plugins-win-img”
Filepath : 'typora', // 图片在项目中的保存目录,可以不用提前创建目录,github提交时发现没有会自动创建
// 【注意:开启CDN后会将原github的文件地址换成 jsDelivr 的地址,如出现镜像出现国内无法访问,或者不再继续运营你的图片也将不能访问到,请谨慎开启该功能】
jsDelivrCND : false, // 是否开启GitHub图片走镜像,国内有时候访问不太方便,如要打开设置为:true
}
});
上传到自建服务器将图片上传地址换成你自己的后端接口,由于调用时不带登录态,请注意接口安全别被坏人利用。为了防止坏人利用你服务器接口,插件支持设置请求头,可一定程度避免被利用
接口协议:
请求方式:POST
请求参数:data:image/png;base64,xxxxxx (图片原转换成base64后的值)
成功响应:{‘code’:0, ‘message’:‘成功’, ‘data’:{‘url’=>‘imageURL’}}
失败响应:{‘code’:x, ‘message’:‘错误原因’, ‘data’:null} 失败时,code必须未非0
后端接口代码可以参考代码文件:upload.php
$.image.init({
target:'self',
self:{
//默认上传地址 https://jiebianjia.com/typora-plugins/upload.html
url:"https://you-server/the-image-upload-path",
headers:{
//默认: token:B40289FC92ED660F433BF0DB01577FDE
token:"value" //自己定义好,并在接口里面检查避免坏人利用你接口
}
}
});
上传到腾讯云OSS
//为了你腾讯云的安全,强烈建议你为这个操作添加一个单独的子账号,并只开启API访问权限
//添加子账号:https://console.cloud.tencent.com/cam
//更多关于腾讯云子账号(CAM)说明:https://cloud.tencent.com/document/product/598/13665
$.image.init({
target:'tencent',
tencent : {
Bucket: 'bucket-name', // 对象存储->存储桶列表(存储桶名称就是Bucket)
SecretId: 'SecretId', // 访问控制->用户->用户列表->用户详情->API密钥 下查看
SecretKey: 'SecretKey', // 访问控制->用户->用户列表->用户详情->API密钥 下查看
Region: 'Region', // 对象存储->存储桶列表(所属地域中的英文就是Region)
folder: 'typora', // 可以把上传的图片都放到这个指定的文件夹下
},
});
上传到阿里云OSS
//为了你阿里云账号的安全,强烈建议你为这个操作添加一个单独的子账号,并只开启API访问权限
//添加子账号:https://ram.console.aliyun.com/users
//给子账号授权:https://ram.console.aliyun.com/permissions
//更多关于阿里云子账号(RAM)说明:https://help.aliyun.com/product/28625.html
//SecretId 就是阿里云的:AccessKey ID
//SecretKey 就是阿里云的:AccessKey Secret,这个值只能在你创建 AccessKey 时看到,所以要保管好,否则只能重新生成
$.image.init({
target:'aliyun',
aliyun : {
// 个人觉得阿里云的这个 AccessKey 没有腾讯云的好用
SecretId: 'xxxx', // 需要先创建 RAM 用户,同时访问方式选择“编程访问”
SecretKey: 'xxxx', // 最好是子账号的key,仅授予oss读写权限(不包括删除)
Folder: 'typora', // 可以把上传的图片都放到这个指定的文件夹下
BucketDomain : 'http://xxx.com/', // 存储空间下有个:Bucket 域名 挑一个就好了
}
});
上传到七牛云
//“密钥管理”页面地址:https://portal.qiniu.com/user/key
$.image.init({
target:'qiniu',
qiniu: {
UploadDomain: 'https://xxx.com', // 上传地址,需要根据你存储空间所在位置选择对应“客户端上传”地址 详细说明:https://developer.qiniu.com/kodo/manual/1671/region-endpoint
AccessDomain: 'http://xxx.com/', // 上传后默认只会返回相对访问路径,需要设置好存储空间的访问地址。进入“文件管理”下面可以看到个“外链域名”就是你的地址了,复制过来替换掉 xxx 就可以了。
AccessKey : 'xxxx', // AK通过“密钥管理”页面可以获取到
SecretKey: 'xxxx', // SK通过“密钥管理”页面可以获取到
Folder: 'typora', // 可以把上传的图片都放到这个指定的文件夹下
policyText: {
scope: "xxx", // 对象存储->空间名称,访问控制记得设置成公开
deadline: 225093916800, // 写死了:9102-12-12日,动态的好像偶尔会签名要不过
},
}