test

撰寫並顯示數學式

Anonymous (anonymous@undisclosed.example.com) — 2017-10-02T22:09:59+00:00

撰寫並顯示數學式

mathjax plugin:mathjax
- $…$ 就可以在行內輸入了
  - 如果要輸入正常的金錢符號時，可像之前在 TiddlyWiki 時那樣，用 \$ escape 掉
- 自訂巨集
  - 可設定 plugin»mathjax»configfile：
    (Optional) One or more files containing MathJax configuration commands. Specify paths relative to the dokuwiki installation directory (e.g. conf/mathjax.js or data/pages/mathjaxconf.txt), and separate multiple files with semicolons.
    
    然後即可自訂 command？是類似 TiddlyWiki plugin 的 \third、\quarter 這種嗎？
    - 【補充】
      
      How to define global shortcuts / new commands?
      
      Answer Add data/pages/mathjax.txt in the configuration manager under plugin»mathjax»configfile and then create the page mathjax with something simmilar to:
      
      MathJax.Hub.Config({ TeX: { Macros: { RR: "{\\bf R}", bold: ["{\\bf #1}",1], Msun: "{\\textrm{M}_{\\odot}}" } } });
      
      原文連結
    - 但如果有 farm 的話，farmer 的設定檔路徑可以順利讓 animal 吃到嗎？
  - ^20160914 且慢，是不是也可以直接在 plugin»mathjax»config 的 textarea 裡設定就好了呢？
    - 如果可以這樣設的話，就可以跨 farmer/animal 了
    - 不過我現在還不太確定怎樣把 MathJax macro 寫成 JSON 表示式啊，只有 TiddlyWiki 時代的 macro 設定可以參考
      \def\half{\frac{1}{2}} \def\third{\frac{1}{3}} \def\quarter{\frac{1}{4}
    - → Okay 寫了這樣的東西
      MathJax.Hub.Config({ tex2jax: { inlineMath: [ ["$","$"], ["\$","\$"] ], displayMath: [ ["$$","$$"], ["\\[","\\]"] ], processEscapes: true }, TeX: { Macros: { half: "{\\frac{1}{2}}", third: "{\\frac{1}{3}}", quarter: "{\\frac{1}{4}" } } });
      
      （切記標點符號那些不能錯漏啊～）→ 成功了
其他 plugin 大概不用試了，都老了廢了

測試

$ \frac{1}{10} $ 奉獻
一般的金錢符號？$1000 元

表格 caption

Anonymous (anonymous@undisclosed.example.com) — 2017-10-02T22:09:45+00:00

表格 caption

問題: DokuWiki 內建語法好像沒有 table caption？有嗎？還是要用什麼 plugin 擴充？
答: 對，沒有，plugin 如下

caption [Till Biskup]（德文出沒注意 XD）（原文連結）
- 照語法輸入後，並沒有如作者網站一樣出現「表 1」、「圖 1」的編號，好像是要照語言自訂（內建只有英、德）原文
  
  Über die DokuWiki-Konfigurationsoberfläche kann eingestellt werden, ob die Über-/Unterschriften mit abgekürzten oder ausgeschriebenen „Labels“ beginnen („Abbildung“ vs. „Abb.“/„Tabelle“ vs. „Tab.“).
  
  Die „Labels“ sind über die Standardlokalisierung der Plugins vorerst in Deutsch und Englisch vorhanden, können aber bei Bedarf auch für andere Sprachen ergänzt werden.
  
  原文連結
  - → 自訂 lib/plugins/caption/lang/zh-tw/lang.php（其實是把 en/lang.php copy 過去再改），初步並沒有成功
  - 難道我用錯語法？
    
    標題
    
    表格
    
    在此
  - 改成 zh/lang.php 也沒用
  - 好難哦
- 有 editor 的 toolbar button 耶
plugin:indexnumber [DokuWiki] （原文連結）
- 搭配 indexreference

表	格
在	此

todo, 待研究

換行

Anonymous (anonymous@undisclosed.example.com) — 2017-10-02T22:09:55+00:00

換行

DokuWiki 預設行為：

兩個換行 = 段落
一個換行：一律忽略
三個以上？
：要用 \\

↑^20160810 用久了開始覺得麻煩，用 <code>...</code> 的話雖能保留所有換行，但卻無法保留一切其他 wiki 語法

∴→ faq:newlines [DokuWiki] （原文連結）

方案：

plugin:xbr [DokuWiki] （原文連結）
- 保留「一個換行」；連續多個換行則不予保留
- 安裝後要把系統設定 renderer_xhtml 改為 xbr
- 試用
  - 初步正常
  - 行首若有空格，仍會變成 code
plugin:poem [DokuWiki] （原文連結）
- 新增一個 <poem> tag，裡面的換行（不論幾個）均可保留
- 測試 poem plugin
- 裡面只接受行內元素，不接受區塊元素
plugin:plaintext [DokuWiki] （原文連結）
- 這好像比 poem 更合用！似乎可搭配 xbr？
- 但不接受其他語法，只比 code block 好一點（某些情況這樣夠用）

巨集

Anonymous (anonymous@undisclosed.example.com) — 2017-10-02T22:09:57+00:00

巨集

plugin

plugin:macros [DokuWiki] （原文連結）
- 嗟夫～會有導致編輯段落按鈕消失的問題
plugin:textinsert [DokuWiki] （原文連結）
- 看起來這個的問題沒有樓上多
- ^20160830 今天終於試用，初步可以運作（純文字 macro ✔ HTML macro ✔），但 HTML macro 不適用於 bootswrapper 的代碼，也就是說真的是輸出 HTML 代碼而已，而並非 DokuWiki 代碼（這樣看來也不能用於 wrap 了）。嗟夫！
舊
- plugin:templater [DokuWiki] （原文連結）
  - 看來有模有樣（因為就是實作類似 MediaWiki 的功能），可惜舊了，不確定能不能用
- easyvar
- kaixovar
- replace

dokuwiki:syntax:outdent

Anonymous (anonymous@undisclosed.example.com) — 2017-10-02T22:10:04+00:00

plugin:outdent [DokuWiki] （原文連結）

有趣，值得一試
好像是讓 section 可以有個結尾，好像也因此可以順利讓 section 套疊起來？

擴充的 list 語法

Anonymous (anonymous@undisclosed.example.com) — 2017-10-02T22:09:52+00:00

擴充的 list 語法

plugin

yalist
- ^20160615 先注意到的是這個，不過之前安裝失敗，故之前用的是 definitionlist↓；現在裝上了，會不會衝突呢？
  - 嗯，看來是會。因為 definitionlist 的語法是 ; :，啟用的話，它的 nice style 會影響到 yalist 的 :
- 應該不是錯覺吧？裝了以後，list 的 style 有點不同的樣子
  - ↑好像是因為 yalist 重新引入了 DokuWiki 預設 stylesheet 裡的 .levelN class
definitionlist
- ^20160615 一山難容二虎，先停用
- 不過它的 nice style 比 yalist 的好看說
extlist
- ^20160907 前陣子發現這個有更新
- 希望它的 dl list style 有比 definitionlist 的好看 ← 沒有耶，dt.compact 好像沒有特殊的 CSS 效果
- 還是說用這個，然後 dl style 用之前網路上找到的 nice style？
- ^20160908 再用了一下，疑似造成 TOC 位置及頁面排版錯亂 → 再次停用回去 definitionlist
其他沒幾個了，好像都舊了、壞了！

測試

? 地球
: 太陽系第三顆行星
: 孕育眾生之地
* 接著
** 多行
.. 內容
.. > 一樣沒有直接結合引文語法
.. <WRAP>

> 還是要自己加 wrap
</WRAP>

擴充文字語法

Anonymous (anonymous@undisclosed.example.com) — 2017-10-02T22:09:43+00:00

擴充文字語法

現成 plugin

這個過期了，不知還能不能用：plugin:formatplus [DokuWiki] （原文連結）
- 看來沒有什麼問題
plugin:typography [DokuWiki] （原文連結）
其實 wrap plugin inline 的部分也是用來讓文字具有不同樣式，應該也屬於本文範疇
Wrap plugin

參考

官方說明

試用
- 對我來說，除了它的預設功能外，加入自訂 class 也挺重要。依官方說明：
  
  編輯 /conf/userstyle.css 加入自訂 .wrap_xxx style（看來 DokuWiki 沒有內建這個檔，那就自己用 Sublime Text 寫好然後上傳到我的 NAS 吧！）
  
  在要使用該 style 的頁面中輸入 <wrap xxx>...</wrap> → ~~沒有效果？！~~已解決
  
  ~~看來現在主要問題是我的 ''/conf/userstyle.css'' 尚無效果……~~ ← 解決！目前先用 userall.css，至於 userstyle.css 待確認
- ^20160603 用了數日，它的 nested 能力真的很棒，是輸入多行文字的利器，處理複雜內容毫不吃力。感恩 wrap，讚美 wrap！
預設 style

較不重要，很重要……都用得出來
Wu̱ hau bo̱?

dokuwiki:syntax:wrap · ghsrobert
有問題
^20160621 這兩個有沒有可能替代 wrap？
- importanttext
  - 試用 importanttext
- important_paragraf
  - 試用 important_paragraf

自製 plugin

官方說明（devel:syntax_plugins）（原文連結）

感覺不容易

Tweak formatplus

formatplus 的 plugin 內容應該相對來說較簡單，且蠻符合我想要的語法 plugin 的樣子，看能否把它擴充修改一下，加入自己想要的語法？

todo, 待研究

Wrap plugin

Anonymous (anonymous@undisclosed.example.com) — 2017-10-02T22:10:11+00:00

有問題

Wrap plugin

參考

官方說明

試用

對我來說，除了它的預設功能外，加入自訂 class 也挺重要。依官方說明：
1. 編輯 /conf/userstyle.css 加入自訂 .wrap_xxx style（看來 DokuWiki 沒有內建這個檔，那就自己用 Sublime Text 寫好然後上傳到我的 NAS 吧！）
2. 在要使用該 style 的頁面中輸入 <wrap xxx>...</wrap> → ~~沒有效果？！~~已解決
  - ~~看來現在主要問題是我的 ''/conf/userstyle.css'' 尚無效果……~~ ← 解決！目前先用 userall.css，至於 userstyle.css 待確認
^20160603 用了數日，它的 nested 能力真的很棒，是輸入多行文字的利器，處理複雜內容毫不吃力。感恩 wrap，讚美 wrap！

預設 style

較不重要，很重要……都用得出來
Wu̱ hau bo̱?