修好 Trac 1.6 上的 TracSubtickets

Trac 1.6 總算從死了三年的 Python 2.7 換成了 Python 3，所以算是蠻強大的升級動力，但也可以想像到相關的 plugin 其實因此爛了不少，加上 Trac 現再用的人愈來愈少，沒有人會修這些問題，所以你就得當「沒有人」跳下去修...

標題上提到的 TracSubtickets 算是這樣的一個套件，他的概念很好用，但大概從 Trac 1.2 以後就沒什麼更新了，先前有遇到 MySQL 8.0 的資料庫搭配起來會撞到關鍵字而出錯，得自己修。

而這次遇到的問題是 TracSubtickets 在頁面輸出子票資訊時用到 ITemplateStreamFilter 這個功能，而從官方文件開頭也可以看到問題：Trac 1.4 的時候內部的 template engine 就從自家研發的 Genshi 換成了 Python 社群用的更廣泛的 Jinja2，但當時只是先標成 deprecated，還沒到不能用，直到 Trac 1.5.1 時拔掉了，所以接下來的 Trac 1.6 就沒得用了。

在官方的「Replacing the ITemplateStreamFilter interface」有提出建議的方法，是用 JavaScript 改 DOM：

The only way left to alter the generated content is to perform these modifications dynamically on client-side using JavaScript.

我看了半天 Trac 1.6 的程式碼，看起來的確沒有什麼比較好的方法可以處理... 只能回來照官方的方法走，後續的問題就是看要處理的多乾淨 (或是多髒)。

因為 Trac 本身沒有 client template engine (像是 React 或是 Vue 之類的)，我決定這邊還是讓 server 端全部把 html string 都產生出來，再由 client 端生一個 div 直接用 innerHTML 塞進去：這樣就不用傳一包 JSON 到 client 端慢慢組了...

於是就出現了這包 diff/patch：「Comparing cae40fb..master · gslin/trac-subtickets-plugin」。

基本的思路是，既然以前的 filter_stream() 是產生 html tree 的程式碼，那就重複拿來用，把結果輸出轉成 html string，用 add_script_data 丟到 window 下的 global variable (喔耶)，再寫一段 javascript 把這串東西塞進本來在的 DOM 位置。

這樣至少就能動了...