差異處

這裏顯示兩個版本的差異處。

連向這個比對檢視

下次修改
前次修改
tech:gist [2025/10/09 16:46] – 建立 jonathantech:gist [2025/10/09 17:15] (目前版本) – 調整內容描述方式 jonathan
行 1: 行 1:
 ====== 使用 gist.github.com 管理公開型資料 ====== ====== 使用 gist.github.com 管理公開型資料 ======
-  * 因為有些公開定義檔希望以有版本控管, 也能夠讓大量外部主機以讀取使用, 發現可以透過 gist.github.com 服務來達成+  * 在開發或系統管理中,常需分享公開定義檔(如 Nginx 配置或環境變數),但傳統檔案託管容易導致 URL 因版本更新而失效。這不僅影響外部主機的自動讀取,還能造成維護麻煩。幸運的是,GitHub Gist 提供了一個簡單的解決方案:它支援版本控制,你輕鬆管理檔案變更,同時生成穩定的 Raw URL,適合大量外部系統存取。 
 + 
 +===== Gist 的優勢 ===== 
 +  * 版本控制:自動記錄每次編輯歷史,方便回溯。 
 +  * 公開分享:無需完整 GitHub 帳號,即快速建立。 
 +  * 穩定 URL:Raw 連結不易因更新而變更,確保可靠存。 
 +  * 輕量級:適合小檔案,不需完整專案。 
 + 
 +===== 如何建立並使用 Gist ===== 
 +  - 前往 https://gist.github.com,登入 GitHub 帳號。 
 +  - 右上角 + (Create new gist) 
 +  - 填寫 Filename Exp. example.conf 
 +  - 上傳檔案或直接輸入內容 
 +  - 點擊「Create secret gist」建立
  
 ===== 範例 ===== ===== 範例 =====
行 6: 行 19:
   * 要讓程式直接讀取必須改成 Raw 網址 \\ {{:tech:螢幕擷取畫面_2025-10-09_164042.png?1024|}}   * 要讓程式直接讀取必須改成 Raw 網址 \\ {{:tech:螢幕擷取畫面_2025-10-09_164042.png?1024|}}
     * Exp. \\ {{:tech:螢幕擷取畫面_2025-10-09_164207.png|}}     * Exp. \\ {{:tech:螢幕擷取畫面_2025-10-09_164207.png|}}
-  但是[[https://gist.githubusercontent.com/tryweb/bf745d68c55f581370977edac9c2a1d4/raw/4213cd6c885e10d1539f748653e53206f2e9201d/example.conf|這 Raw 網址]]因為更版而改變, 所以要將後面那段與版本相關的網址移除 Exp.  + 
-    * 有版本網址 - https://gist.githubusercontent.com/tryweb/bf745d68c55f581370977edac9c2a1d4/raw/4213cd6c885e10d1539f748653e53206f2e9201d/example.conf +===== 生成穩定 Raw URL 的關鍵技巧 ===== 
-    * 版本網址 - https://gist.githubusercontent.com/tryweb/bf745d68c55f581370977edac9c2a1d4/raw/example.conf+  原始 Raw URL 會包含版本相關的雜湊碼(如 /4213cd6c...),更新 Gist 後會改變。為了讓 URL 永久穩定,只需移除版本部分,保留檔案名稱即可: 
 +    * 原始 URL(不穩定): <code>https://gist.githubusercontent.com/tryweb/bf745d68c55f581370977edac9c2a1d4/raw/4213cd6c885e10d1539f748653e53206f2e9201d/example.conf</code> 
 +    * 移除版本 URL(穩定): <code url>https://gist.githubusercontent.com/tryweb/bf745d68c55f581370977edac9c2a1d4/raw/example.conf</code> 
 +  * 這樣,即使你更新 Gist 內容,URL 仍指向最新版本
  
 {{tag>tips}} {{tag>tips}}
  • tech/gist.1759999570.txt.gz
  • 上一次變更: 2025/10/09 16:46
  • jonathan