又好久沒寫雜談了！會有這種情況主要是把內容要求想得太嚴謹，這樣不行，還是要隨興些，把值得記的事情寫下來。

zinit 作者刪庫

前幾天才知道，原來我目前用的 zsh 套件管理器——zinit，在去年十月發生了作者把整個 GitHub organization 即「zdharma」 刪除事件，而旗下的 repo 也都跟著遭殃。

自從用 Hexo 建立自己的 blog 後不久，就有認真思考過要不要在文末加上 LikeCoin 按鈕，但一直都沒有行動。原因大致有二：

1. 重視美感，覺得 LikeCoin 按鈕和 blog 整體風格似乎有點不搭。
2. 覺得拍手前的登入程序頗為麻煩，連我自己可能都懶得登入，又怎麼能夠期待收獲別人的拍手呢？

基於上述兩個理由，即使後來方格子、Medium 等平台以及更早的 WordPress 都已經陸續支援了 LikeCoin 按鈕，我還是興趣缺缺。

但為什麼後來又回心轉意了呢？原因有點特別。

在專案中，我們很多時候會需要透過程式碼來操作某項服務——比如操作 Google Map 或本文的 Docker——而不是使用相對直覺的 CLI 或更方便的 GUI，畢竟它們都是給人類使用的。

遇到這樣的需求，腦中第一個浮現的通常是「這服務有沒有官方 API 可以呼叫？」，再進一步想，如果有提供我們 SDK 就更好了！

本文將介紹 Python Docker SDK 的基本使用方式，大致集中在初始化連線及容器操作部分，主要參考自 SDK 官方文件，並會加上一些個人的實作經驗與小提醒。

前言：場景說明

最近，由於需要審查同事的程式碼，「比較分支差異」成為一個必要的需求。

在工作中，通常將一個功能指派給一個開發者，在一個獨立的分支上進行開發。當分支的開告一段落時，審核人需要明確知道從 fork 時的 commit 到目前功能分支的所有變更，才能進行 code review。

功能分支範圍內通常會包括多個 commit 與多個檔案的變動，我們需要能夠一次就看到分支累積的所有變動。

以往我都是一個一個 commit 慢慢看，土法煉鋼——這真的太蠢了！還好很快就受不了，找到更好的辦法。

手動新增了一個全站熱門文章頁面！當時位置就在分頁選單的「TOP 10」，統計最近 90 天瀏覽量排名前十的文章，並列成清單。數據來自本站 Google Analytics。

替代方案——Ruff：Python 開發：Ruff Linter、Formatter 介紹 + 設定教學

相關文章：

• Python 開發：pre-commit 設定 Git Hooks 教學
• Python 開發：pyproject.toml 介紹 + 使用教學
• Python Flake8 與 Black Formatter 擴充套件快速上手

---

在〈Flake8 與 isort in VS Code〉中提到了 Python 的 linter——pylint 與 Flake8，今天就來說明 linter 與 formatter 的具體設定方法。

不得不說，善用 linter 與 formatter，無疑是 Python 程式開發的起手式。尤其在多人協作的時候，想深入要求每個人的寫作習慣很難，但至少在排版風格上，能藉由工具能達到基本的統一。

相關文章：Notion 教學：10 個我最常用的 Markdown 語法與快捷鍵介紹

---

曾經在〈我自架部落格的理由與選擇（下）〉一文的接近尾聲處留了一個很明確的伏筆，那時是這樣說的：

從前面看下來，你是否覺得有點奇怪，我明明一開始說不愛用 Markdown 寫作，怎麼最後卻是選了基於 Markdown 的靜態框架？

簡言之，我找到了用 Markdown 寫作的折衷方式。這部分細節不少，請容我再另闢一篇討論，因為它確實滿重要的，也會影響你寫作的舒適度，最終決定你能否長期運行與產出。

這伏筆現在終於要來認真回收了——介紹何謂「Markdown 寫作的折衷方式」。