筆記
- 我不完全贊同 Diátaxis 架構
Diátaxis 最近受到很大的推崇，尤其是被開源專案大量參考，但是隨著功課做了越來越多就越不贊同 Diátaxis 架構，包含順序問題和座標軸問題。
- 技術寫作的相關重點
本文整理技術寫作相關知識，還在很草稿的階段，因為我自己的知識也還不足以真正介紹這個主題。
- Technical Writing: Microsoft
這是 Claude 翻譯的 Top 10 tips for Microsoft style and voice。
以下開始翻譯。
我們的現代設計以簡潔俐落為核心。愈短愈好。若想進一步了解，請參閱〈品牌語氣〉。
- Technical Writing: hireawriter.us
這是 Claude 翻譯的 English Grammar Rules for Technical Documents: 20 Dos and Don'ts。
以下開始翻譯。
- Technical Writing: draft.dev
- 色彩科學
修復 Blowfish 文字對比度過低的問題，隨筆記錄這次修復學到的東西。
- CSS 置中方式
總是記不起來 CSS 置中方式，因此做一個小筆記。
- 修復 macOS 上 Chrome DevTools 設為獨立視窗後無法顯示的錯誤
MacOS 使用 Chrome DevTools，並且把 Dock side 設定為獨立視窗 (Undock into separate window) 後，有機會下次開啟 DevTools 時 DevTools 視窗不會顯示，這會導致連修改 Dock side 都沒辦法，因為按鈕就在 DevTools 裡面，現在整個 DevTools 都不顯示自然連改都沒辦法。
- 目的、情況和決策
進行任何實際行為之前，應該先明確釐清動機，搞清楚想要做這個動作的原因是什麼，想要達到什麼效果。需避免盲目行動，避免情緒驅動，避免承擔非必要責任，並且明確預期目標結果避免偏離。
- Diátaxis Documentation
更新
對 Diátaxis 有更深的理解了，見我不贊同 Diátaxis 架構
Hugo 文檔的問題眾所皆知，Hacker News 也有討論這個問題，比如說文檔的這張擷圖，你能找到怎麼安裝 Hugo 嗎？
- Hugo 語法上色 Syntax Highlighter
這是把語法上色從 Hugo 內建的 Chroma 改成 prism.js/highlight.js 又改成 shiki 的心得，網路上你哪裡能找到全部試過一輪的心得呢，想改的原因不外乎就是顏色醜，辨識度低，不好看。
- Hugo Blowfish 主題的客製化
補足各種功能，例如文章存檔頁面、閱讀進度、文章編輯時間。
- Hugo Blowfish 的問題修復
修復 blowfish 相關的功能問題。
- WebP 圖片壓縮與解碼性能
WebP 與 AVIF 的壓縮率比較
- Rician Fading生成方式，包含Emil Björnson大師的正解
整理生成Rician fading的方法
- 利用 Cloudflare Tunnel 和 DDNS 無需開放端口實現安全外網訪問
紀錄把一台破電腦裝成 NAS 的過程