Skip to content

Latest commit

 

History

History
428 lines (270 loc) · 14 KB

README.zh-tw.md

File metadata and controls

428 lines (270 loc) · 14 KB
Raw

English Readme / 简体中文说明 / 繁體中文說明

Markdown Image

一個用於方便的在 Markdown 中插入圖片的擴展，支持將圖片存放在本地或第三方的圖床或對象存儲。

❤ Sponsor me / 贊助開發者

功能

  1. 可複製圖片文件或截圖粘貼，快捷键 Alt + Shift + V，或右键菜单 粘贴图片。
  2. 自動生成 Markdown 代碼插入。
  3. 可配置支持 Imgur，七牛，SM.MS，Coding 等圖床。默認為本地，需打開 Markdown 文件所在文件夾。
  4. 也可以自定義代碼實現圖片上傳。
  5. 支援 Windows，MacOS，Linux。

依赖要求

Windows 和 MacOS 用戶可直接使用，Linux 用戶須安裝 xclip.

Ubuntu

sudo apt install xclip

CentOS

sudo yum install epel-release.noarch
sudo yum install xclip

注意事項

如果你要在 Remote 模式中使用，請設置 remote.extensionKind 如下：

"remote.extensionKind": {
  "hancel.markdown-image": [
    "ui"
  ]
}

而且，如果要將圖像保存在遠程工作目录中，則必須使用 SFTP 上傳方法，Local 方法無法在 Remote 模式中使用。

擴展設置項目

基本設置項目

  • markdown-image.base.uploadMethod: 上傳圖片的方式，根據不同的方式，須在設置不同的項目。
  • markdown-image.base.fileNameFormat: 圖片文件命名格式化字符串。支持多種變量做格式化，可同時配置文件夾格式，具體見設置。
  • markdown-image.base.codeType: 插入代碼的類型， 你可以設置為使用 <img> 標籤或 Markdown。
  • markdown-image.base.imageWidth: 圖片的最大寬度，若圖片大於這個寬度，則會設置寬度為該值。設置為 0 則表示不設置。
  • markdown-image.base.urlEncode: 是否對圖像的 URL 編碼。

Local 设置项目

  • markdown-image.local.path: 圖片本地存放路徑，支持相對路徑，相對於所粘貼的 Markdown 文件。 / 表示打開的文件夾根目錄。若路徑不存在，將會自動創建。
  • markdown-image.local.referencePath: Markdown 中的圖片的引用路徑格式（不包含文件名）。留空表示使用相對路徑。你可以使用 #markdown-image.base.fileNameFormat# 中的所有變量。例如：/images/${YY}-${MM}/

GitHub Settings

  • markdown-image.github.path: 倉庫中的圖片保存目錄（如果不存在，則自動創建）。
  • markdown-image.github.token: Git Hub 的個人[訪問令牌](https://github. com/settings/tokens)，用於訪問倉庫，上傳圖片。
  • markdown-image.github.repository: 所要上傳的目的倉庫，比如：https://github.com/username/repository/。倉庫必須要先初始化。
  • markdown-image.github.branch: 要存放圖片的倉庫分支。
  • markdown-image.github.cdn: 要使用的 CDN 地址格式，${username} 表示上傳倉庫的用戶名，${repository} 表示上傳的倉庫，${branch} 表示上傳的分支，${filepath} 表示上傳的倉庫目錄與文件名。
  • markdown-image.github.httpProxy : 設置訪問Github的 HTTP 代理。

Imgur 設置項目

  • markdown-image.imgur.clientId: 在 imgur 註冊的 Client Id。您可以在這裡註冊。
  • markdown-image.imgur.httpProxy: 設置訪問的 HTTP 代理。

SM.MS 設置項目

  • markdown-image.sm_ms.token: SM.MS Secret Token。您可以註冊一個帳戶，然後訪問 API Access 頁面生成。

七牛設置項目

  • markdown-image.qiniu.accessKey: 七牛賬戶的 Access Key。
  • markdown-image.qiniu.secretKey: 七牛賬戶的 Secret Key。
  • markdown-image.qiniu.bucket: 七牛的對象存儲空間名。
  • markdown-image.qiniu.domain: 七牛空间绑定的域名。
  • markdown-image.qiniu.zone: 七牛空間的存儲區域。

又拍云设置项目

  • markdown-image.upyun.bucket: 又拍雲的雲存儲服務名稱。
  • markdown-image.upyun.domain: 又拍雲雲存儲服務綁定的域名。
  • markdown-image.upyun.operator: 又拍雲的操作員名。
  • markdown-image.upyun.password: 又拍雲的操作員密碼。
  • markdown-image.upyun.path: 又拍雲圖片存儲路徑。
  • markdown-image.upyun.link: 又拍雲鏈接線路。

Cloudinary 設置項目

這些值可以在 Cloudinary Dashboard 上找到

  • markdown-image.cloudinary.cloudName: 你的帳戶名稱。
  • markdown-image.cloudinary.apiKey: 你的帳戶 API key。
  • markdown-image.cloudinary.apiSecret: 你的帳戶 API secret。
  • markdown-image.cloudinary.folder: 圖像上傳文件夾。

Cloudflare 設置項目

這些值可以在 CloudFlare Dashboard 上找到

  • markdown-image.cloudflare.accountId: 你的帳戶名稱。
  • markdown-image.cloudflare.apiToken: Cloudflare API 令牌.

S3 設置項目

這些值可以在 S3 服務 Dashboard 上找到

  • markdown-image.s3.endpoint: 你的 S3 API 端點，是從存儲桶設置或 dashboard 獲得的。
  • markdown-image.s3.region: 你的 S3 存儲桶區域，是從存儲桶設置中獲得的。
  • markdown-image.s3.bucketName: 你的 S3 存儲桶名稱。存儲桶訪問權限應該是公開的。
  • markdown-image.s3.accessKeyId: 你的 S3 access key ID。
  • markdown-image.s3.secretAccessKey: 你的 S3 secret access key。
  • markdown-image.s3.cdn: 設定你的 S3 CDN URL。你可以使用變數 ${bucket} ${region} ${pathname} and ${filepath}。比如：https://${bucket}.${region}.s3.amazonaws.com/${pathname}/${filepath}。

SFTP 設置項目

  • markdown-image.sftp.host: 遠端伺服器地址。
  • markdown-image.sftp.port: SSH 服務端口。
  • markdown-image.sftp.username: 遠端賬戶。
  • markdown-image.sftp.password: SSH 密碼。
  • markdown-image.sftp.privateKeyPath: 遠端私鑰文件路徑。
  • markdown-image.sftp.path: 遠端伺服器的圖片存儲目錄（如果不存在，則自動創建）。支持相對路徑，相對於所粘貼的 Markdown 文件。 / 表示打開的文件夾根目錄。注意：您不能在此處使用變量。您可以在 #markdown-image.base.fileNameFormat# 中使用變量。
  • markdown-image.sftp.referencePath: Markdown 中的圖片的引用路徑格式（不包含文件名）。留空表示使用相對路徑。你可以使用 #markdown-image.base.fileNameFormat# 中的所有變量。例如：/images/${YY}-${MM}/

Azure Storage 設置項目

  • markdown-image.azure.authenticationMethod: 用於 Azure Blob 存儲帳戶的身份驗證方法。 默認值為 Passwordless。 您可以從這裡獲取更多信息。
  • markdown-image.azure.accountName: 你的 Azure Blob 存儲帳戶名。
  • markdown-image.azure.connectionString: 你的 Azure 存儲連接字符串。
  • markdown-image.azure.container: 你的 Azure 存儲容器名稱。

自定義設置項目

  • markdown-image.DIY.path: 你寫的代碼的路徑。你的代碼必須 exports 一個像 async function (filePath:string, savePath:string, markdownPath:string):string 的函數。 比如： 
    const path = require('path');
module.exports = async function(filePath, savePath, markdownPath) {
    // Return a picture access link
    return path.relative(path.dirname(markdownPath), filePath);
}

發布歷史

1.1.43

  • 修正 path 變量仍然存在替換不完全的反斜杠的問題。

1.1.42

  • 修正 path 變量在 Windows 作業系統下不符合 Unix 格式的問題。

1.1.41

  • 添加了新設置項目 markdown-image.s3.config 用於配置 s3 client。
  • 更正 s3 CDN 地址变量错误的问题。

1.1.40

  • 新增了新設定項目 markdown-image.s3.cdn 用於設定 s3 CDN 位址。

1.1.39

  • 為 s3 上傳方法新增了 Content-Type。

1.1.38

  • 支援 Azure Blob Storage Passwordless 身分識別方式。

1.1.37

  • 添加了 Azure 对象存储的支持。

1.1.36

  • 修复了占位符变量 filename 没有使用 fileNameFormat 计算后的值的问题。

1.1.35

  • 修正文件名變量相同變量僅第一個有效問題。

1.1.34

  • 添加了新設置項目 markdown-image.base.altFormat 用於設置圖片程式碼的佔位符。

1.1.33

  • 添加了新設置項目 markdown-image.base.uploadMethods 用於支援多種上傳方式並發上傳。
  • 添加了新設置項目 markdown-image.base.fileFormat 用於設置剪切板圖片文件保存格式。
  • 移除已失效的 Coding 圖床。
  • 支援圖片粘貼到非常規編輯窗口。

1.1.30

  • 添加了新設置項目 markdown-image.github.httpProxy 去設置 GitHub HTTP 代理.

1.1.29

  • 修正在 Deepin 系統無法獲取剪貼板圖片的問題。

1.1.28

  • 支持設置項目分組
  • 添加對遠程模式的支持。
  • 添加 SFTP 上傳方法。
  • 包括以下新設置：
    • markdown-image.sftp.host
    • markdown-image.sftp.port
    • markdown-image.sftp.username
    • markdown-image.sftp.password
    • markdown-image.sftp.privateKeyPath
    • markdown-image.sftp.path
    • markdown-image.sftp.referencePath

1.1.27

  • 添加了對 S3 的支持。
  • 新增了包括以下新的設置：
    • markdown-image.s3.endpoint
    • markdown-image.s3.region
    • markdown-image.s3.bucketName
    • markdown-image.s3.accessKeyId
    • markdown-image.s3.secretAccessKey

1.1.26

  • 添加了對 又拍雲 支持.
  • 新增了包括以下新的設置：
    • markdown-image.upyun.bucket
    • markdown-image.upyun.domain
    • markdown-image.upyun.operator
    • markdown-image.upyun.password
    • markdown-image.upyun.path
    • markdown-image.upyun.link

1.1.25

  • 修正當開啟 markdown-image.base.urlEncode 時，GitHub CDN 地址編碼錯誤的問題。

1.1.24

  • 修正一些 markdown-image.local.referencePath 的使用 bug；
  • 修正圖片 alt 計數在重載控件重新開始的問題。

1.1.23

  • 添加了新設置項目 markdown-image.github.cdn 去設置 GitHub CDN 地址.

1.1.22

  • 修复 GitHub 模式上傳文件路徑錯誤問題。

1.1.21

  • 修復了當文件路徑包含中文時，上傳到 GitHub 失敗的問題。

1.1.20

  • 修復 Local 模式設置 local.referencePath 以 / 開始的值導致路徑從磁盘根目录開始的问题。

1.1.19

  • 修復 Local 模式設置保存到項目根目錄，實際保存到磁盤根目錄問題。

1.1.18

  • 修復 Local 模式不能使用絕對路徑的問題。

1.1.17

  • 添加了對 Cloudflare CDN 支持.
  • 新增了包括以下新的設置：
    • markdown-image.cloudflare.accountId
    • markdown-image.cloudflare.apiToken

1.1.16

  • 添加支持上傳圖像到 Github 存儲庫。

1.1.15

  • 添加文件格式化變量 prompt。 可以在粘貼圖像時通過輸入框輸入自定義名稱。

1.1.14

  • 更新 Coding-Picbed 修復上傳到 Coding 錯誤。

1.1.13

  • 添加了設置项目 markdown-image.local.referencePath 用于支持修改在 Markdown 文件中的图片引用路徑。

1.1.12

  • 添加支持在 jupyter 文件中的粘貼圖像。

[1.1.11]

  • 更新了Cloudinary CDN 以使用 markdown-image.base.fileNameFormat 設置保存文件路徑。文件路徑若已存在，將提示是否覆蓋。

1.1.10

  • 添加了對 Cloudinary CDN 的支持
  • 新增了包括以下新的設置：
    • markdown-image.cloudinary.cloudName
    • markdown-image.cloudinary.apiKey
    • markdown-image.cloudinary.apiSecret
    • markdown-image.cloudinary.folder

1.1.9

  • 添加設置選項 markdown-image.base.codeType 和 markdown-image.base.imageWidth 用於設置圖片最大寬度。

1.1.8

  • 修正 VSCode 會緩存 DIY 路徑代碼，導致修改無法即時生效的問題。

1.1.7

  • 新增一個選項用於切換是否對 URL 編碼。

1.1.6

  • 修正擴展Log等級，避免干擾其他擴展開發者。
  • 更新替換文件後動作。

1.1.5

  • 修正 Data URL 設定項目説明。

1.1.4

  • 新增插入 Markdown 圖片方式： Data URL.
  • 修正粘貼多個文件無效問題。

1.1.3

  • 修复了文件名變量 ${path}導致在 Windows 系統下存在兩級以上 Markdown 路徑時，Coding 圖床上傳失敗問題。

1.1.2

  • 再一次修復了粘貼複製的圖片時，路徑包含中文提示無法找到問題。😂

1.1.1

  • 修復了粘貼複製的圖片時，路徑包含中文提示無法找到問題。

1.1.0

  • 添加了 Beta 功能，支持粘貼富文本格式。（僅支持Windows）

1.0.14

  • 修復了與 Windows 7 不兼容的問題。

1.0.13

  • 修復了在 Windows 中獲取剪貼板圖片的路徑分辨率錯誤的問題。

1.0.12

  • 添加了文件名變量 ${path}： 正在編輯的 Markdown 文件相對於根目錄的路徑。

1.0.11

  • 修正 sm.ms API 地址。
  • 修復了在 Linux 中找不到帶空格的文件名的問題。
  • 添加了 sm.ms 沒有設置 token 的提示。

1.0.10

  • 修復變量 $mdname 沒有去除非 md 後綴名的問題。

1.0.9

  • 修復了文件名格式化日期小時獲取錯誤的問題。

1.0.8

  • 加入支持 mdx 文件。

1.0.7

  • 修復了無法自動在 MacOS 和 Linux 上啟動擴展名主頁的問題。
  • 修復了圖片地址冒號被錯誤轉義的問題。

1.0.6

  • 修正日期變量沒有考慮時區的問題。

1.0.5

  • 修正包含空格的文件名無法預覽的問題。
  • 修正 ${rand} 變量不可用的問題。

1.0.4

  • 更新贊助鏈接。

1.0.3

  • 添加贊助鏈接。

1.0.2

  • 修正圖片替換提示錯誤。

1.0.1

  • 更新 Readme。

1.0.0

  • 初版发布。

其他

Enjoy!