Ciang Brides 黃金城 dokuwiki:dev:plugin

dokuwiki:dev:plugin:feed

Anonymous (anonymous@undisclosed.example.com) — 2019-03-26T18:14:10+00:00

建議透過 URL 中的 title 參數自訂 feed 標題（目前只能自訂「feed 的連結的標題」）

Load on demand 的外部資源檢視器

Anonymous (anonymous@undisclosed.example.com) — 2017-11-07T23:25:00+00:00

Load on demand 的外部資源檢視器

現況: iframe 無法 load on demand; popupviewer 僅支援內部文件/媒體; popupviewer 也只有燈箱效果，不支援 iframe

∴希望做個 plugin 解決上述 plugin 的局限

研究

^20171107 前幾天請教 popupviewer 要怎麼改才能支援外部資源，結果昨夜作者不太耐煩地說這個 plugin 就是只看全域變數 $ID 所以只支援內部網頁（意思就是不想管我），然後把我的問題關掉了 ☞ Render external web pages · Issue #15 · i-net-software/dokuwiki-plugin-popupviewer
- 不過至少他提示去參考該 plugin 的 action.php，以及 DW 的 DokuHttpClient

實做

^20171107 用 DokuWiki Plugin Wizard 做個新 plugin 的骨架
1. 勾選 Use Configuration
2. Add Plugin Components 先加一個 syntax
3. URL 必填，所以還是得先建 https://github.com/GJRobert/dokuwiki-plugin-popupbrowser
4. 按 Create 後果然是下載一包基本的骨架檔 → 放到本機 GitHub repo 中
5. 做好了。然後呢？zzzzzzz
搜尋整個 DW 主目錄，有用到 HttpClient 的地方並不多……
研究 popupviewer 的 action.php，大概一次啃一點，慢慢多讀懂一點……

我開發的 DokuWiki plugin

Anonymous (anonymous@undisclosed.example.com) — 2019-10-23T12:09:19+00:00

我開發的 DokuWiki plugin

formatplus2：^20171022 前陣子解決 formatplus jQuery 型別錯誤後，fork 在 GitHub 上，今天 po 到 DokuWiki.org 去；只是 fork 人家的成果後小修一下，修改的內容也是從網路上取來的 ∴稱不上開發！
1. 在 DokuWiki.org 上，登入後建立一個 plugin:formatplus2 頁面，一開始就有個 template 可供填寫、修改了，真方便
2. 雖然大致是照 template 填了，也順利測試可以透過 DW 的管理介面搜尋到這個 plugin 並安裝，但發現自己忘了改 plugin 資料夾裡的 plugin.info.txt、VERSION 等資訊，所以一度顯示成和原作者相同的資料然後我修改時又沒有一次到位，GitHub 上的版本日期和資料夾裡的記載又兜不起來……一言難盡啦，搞到今晚發現這個 plugin 無法正常在 DW 上發揮功能，而且更新時也一直出錯
  ↑原來問題出在，原本我是在本機直接改 formatplus plugin 資料夾中的 syntax.php 一個檔案而已，等於是自己的 tweak。可是現在 fork 一個新的 plugin，也取了新名稱「formatplus2」，這樣會導致檔案的路徑都改變，所以各支 php 檔裡面的路徑其實都要改掉才行。
  - ^22:31 還有所有提到 xxx_plugin_formatplus_yyy 的 class name 也都要加個 2？← 是的，連這個也改了以後，總算恢復正常了
3. 這不禁讓我反省，這樣好像為了一點點的虛榮，其實只是一點點的 bug fix，就 fork 出一個全新的 plugin，搞得這麼麻煩……也許我應該是請 Tom 授權我開個 formatplus 的 GitHub repo，也更新該 plugin 的下載連結，然後我再 commit 到該 repo 就好？
  → 寫信詢問 Tom 了，等他意見
4. ^20171107 今天透過 devel:badextensions [DokuWiki] 這頁發現我的 plugin.info.txt 中少了 base 的宣告？☞ devel:plugin_info [DokuWiki] 唉，這不能怪我啊，formatplus 原本就沒寫……_{（但他的 plugin 怎麼沒有被舉發錯誤？）}
  1. 趕快修改 plugin.info.txt，把 base formatplus2 這行加進去，並透過 GitHub Desktop commit 並上傳了
  2. devel:badextensions 這頁不會立刻更新，看了一下它的更新紀錄，原來每天定期更新的，不知道是哪裡有腳本還是？真厲害。DW 的世界感覺比 TW 更精深博大
5. ^20191023 後來今年 4 月間 Andi（！）有來提出 pull request，我也 merge 了。今天去改了 DW 官網上的日期（原來系統判斷有無新版 extension 與否是看那裡！）

開發 DokuWiki popup plugin

Anonymous (anonymous@undisclosed.example.com) — 2020-04-01T01:25:13+00:00

開發 DokuWiki popup plugin

緣起：

目標

簡單的輸入語法
popup 內使用一般 DW markup 而非 HTML
從 getElementById 變為 getElementByClassName？

參考

開發 DW plugin 一般要點：
- devel:plugins
- devel:plugin_file_structure
- devel:plugin_programming_tips
  - pseudo-plugin

實做

^20200321 準備開始。

^20200322 把最基本的 CSS + JS 做成 pseudo-plugin，

搭配類似像這裡面的 HTML 標記碼（而非 DokuWiki 自身語法）

<html><div class="popup" onclick="myFunction()">Click me!
  <span class="popuptext" id="myPopup">Popup text...</span>
</div>
</html>

→ 最粗略的 v0.1 Release Original basic method, working · GJRobert/dokuwiki-plugin-popup

然後開始實做 syntax：拿 plugin:ruby 的 syntax.php 來改，目前想先用 [按鈕]^^泡泡內容^^ 這樣的語法。

^20200323 這個 commit 初步成功，但有多個要修改的問題，而且目前想用的語法似乎會和連結語法 [[...]] 衝突，可能需要改。

插曲：一次自動新增多個 GitHub issue

找到 Ricky54326/Github-Auto-Issue-Creator: An automatic issue creator for Github, written in Python. It'll go through your entire git repo, look for any lines that start with TODO: and add them as issues to your repo.
下載來用，卻看到

Traceback (most recent call last):
  File "./autoissue.py", line 207, in <module>
    main()
  File "./autoissue.py", line 170, in main
    from github import createIssues
  File "/Volumes/SD/tmp/Github-Auto-Issue-Creator-master/github.py", line 1, in <module>
    import requests
ImportError: No module named requests

少了 Python requests 模組，變成還得再想辦法安裝

執行了 $ which -a python python2 python2.7 python3 python3.6²⁶⁾，發現我有：

/usr/bin/python
/usr/bin/python2.7
/usr/local/bin/python3

3 份 Python

這裡有人建議不要在 macOS 隨附的 Python 中安裝 requests 模組，而且 macOS 的 Python 2.7.10 很誇張，沒有 pip，也沒有 easty_install ∴我決定改用 Python 3↓

$ pip3 install requests

但接下來 Python 3 執行那個腳本，卻又語法錯誤

$ python3 ./autoissue.py -i -p /Volumes/SD/Dropbox/projects/dokuwiki-plugin-popup/ -s 'FIXME'
  File "./autoissue.py", line 37
    except IOError as (eno, strerror):
                      ^
SyntaxError: invalid syntax

所幸有 Python3 的腳本：Ricky54326/Github-Auto-Issue-Creator at python3
→ 執行了卻找不到任何 issue

↑放棄上面的腳本，結果透過 Zapier，順利把記錄在 Google Spreadsheet 上的 issue，自動加到 GitHub 去了。還是要靠專業的來啊！🆗🔚

3/23 晚上，改成了 [^按鈕文字^]^^泡泡內容^^
然後又改用 [^按鈕文字^](^泡泡內容^)，暫時可能會先用這個，再來可能要先處理別的問題了 ☞ Issues · GJRobert/dokuwiki-plugin-popup，我可能要想辦法做個表把這些 issue 排個優先順序

^20200324 來研究 plugin:folded 的 /syntax，並參考 devel:syntax_plugins

看來 getType() 應該用 formatting 或 container 的

^20200325

先把按鈕的 div 改為 span 試試 → inline ✅（GitHub 自動把 Issue #5 close 掉了！真神奇）
如果變 inline 的話，就一定需要適當的 style 來顯示 button 了
- 突然想到，以前 TiddlyWiki 的 popup，可以設成只需 hover、不需 click ∴這次我可能也可以考慮是否要調整成不一樣的行為；樣式方面，如果只要 hover 的話，可能不一定要做成有陰影的按鈕
- → 開了一個 branch「ohhover」來修改。但是隨即發現，不是叫 onhover，而是 oumouseover 糗 ²⁷⁾
  → 好了，總之弄出來了。

^20200330

昨天承 3/24，試著開始修改 getType() 等，想解決容納其他 DW 語法的問題，但參考發現要改的甚多 ∴暫時改到一半，留在 master branch 裡 ☞ #3 1 hour ago
語法不好啃，改改 style 總行了吧？→ 開 styles branch 並試做基本樣式，再 merge 到另兩個 branch = close 掉 #9 Proper style for button

^20200331

再找找看其他可資參考的 plugin：
- abbr 似乎不是我要的 ∵它產生的也是 HTML <abbr> tag，裡面應該是裝不了 DW 語法
- DW 內建 footnote 功能其實挺不錯的，要是可以擴充就好了
  ↑嗚好幾支 core script 要看喔，主要在 /inc/parser 裡的樣子，handler、lexer、parser、renderer、xhtml 等 .php 可能都有 "@@"
- autotooltip？← 應該不行，它的 getType() 也是 substition

未完成

²⁵⁾

devel:javascript

²⁶⁾

macos - What version of Python is on my Mac? - Stack Overflow

²⁷⁾

JavaScript function onhover in <div> - Stack Overflow