Skip to content

提供標籤名單

LibelDev edited this page May 30, 2024 · 2 revisions

作為提供者 (Provider),你需要製作一個JSON格式的標籤名單,並將檔案放上互聯網以供其他人訂閱。

你可以使用製作訂閱名單功能,輕鬆地將你目前的個人標籤記錄資料庫製作成可供其他人訂閱的名單檔案。


檔案托管

你可以選擇以任何檔案托管方式(例如 Google Drive, Dropbox, GitHub Pages, 或私人雲端/服務器)來分享標籤名單。

GitHub Pages

我們推薦使用 GitHub Pages,原因如下:

  • GitHub Pages 提供免費的項目托管服務,官方網頁已經有詳細教學
  • GitHub 項目 (Repository) 具有協作功能 (Pull Request),可以讓任何人參與編寫訂閱名單內容
  • 網站設有快取機制,所以不需要擔心流量限制問題

參考 GitHub Pages "Project site > Start from scratch" 的教學並以上述樣本為例子:

  1. 根據 GitHub Pages 步驟1 建立新的存儲庫(Repository)
  2. sample1.json 拖曳到剛建立的存儲庫頁面
  3. Commit changes 確認上載檔案
  4. 根據 GitHub Pages 步驟4 設定 GitHub Pages
  5. 假設你的用戶名稱是 username,存儲庫名稱是 repository
    檔案網址則會是:http://username.github.io/repository/sample1.json

第三方雲端儲存服務

你亦可以選擇使用 Google DriveDropbox 等第三方雲端儲存服務

注意:你需要將檔案的讀取權限設定為「任何人」,透過「某些方法」取得該檔案的直接連結,然後其他人就可以將直接連結新增到標籤訂閱功能。

Dropbox 為例子:

  1. 將準備好的標籤名單檔案上載到 Dropbox
  2. 點擊檔案的 Share 按鈕
  3. Who can access 設定為 Anyone with link
  4. 點擊 Copy link,會得到類似以下分享連結
    https://www.dropbox.com/s/61o98taojhv4evp/sample1.json?dl=0
  5. 按以下規則修改複製到的連結
    1. https://www.dropbox.com 修改為 https://dl.dropboxusercontent.com
    2. dl=0 修改為 dl=1
  6. 會得到類似以下直接連結
    https://dl.dropboxusercontent.com/s/61o98taojhv4evp/sample1.json?dl=1

然後可以嘗試新增直接連結到標籤訂閱功能

⚠ 使用這類第三方雲端儲存服務須注意該服務有沒有限制流量,而且上述取得直接連結的方法也不保證一直有效,萬一連結失效,你則需要提供新的連結給已經訂閱標籤名單的用家讓他們重新訂閱。


檔案樣本

https://LibelDev.github.io/libel/data/mock/subscriptions/sample1.json

{
  "name": "(Sample) Libel認證【戇鳩】會員名單",
  "version": "1.0",
  "homepage": "https://github.com/LibelDev/libel",
  "color": "#fbc308",
  "data": {
    "35092": [
      {
        "text": "戇鳩",
        "reason": "認為【安心出行】冇問題",
        "url": "https://lihkg.com/thread/2412564/page/1",
        "date": 1619968323508,
        "source": {
          "thread": "2412564",
          "page": 1,
          "messageNumber": "1"
        }
      }
    ]
  }
}

你可以在這裡找到更多樣本。