之前介紹了筆記軟體挑選 tiddlywiki 的理由,但下載後才發現根本沒有語法突顯(syntax highlighting)阿?其實不然,想要讓 tiddlywiki 變得更完善就需要善用 plugins(外掛)。
點選 設定圖示 —> 選擇 plugins 標籤頁 —> Get more plugins —> Open plugin library —>在 plugins(56) 的標籤頁找到 Highlight.js: syntax highlighting 並安裝。
完成後,就可以在新增一筆 tiddler 時,於內容輸入「```
」和「```
」即是標準的程式碼區塊,而第一個「```
」緊接著輸入你想要使用的程式語言,如「```python
」,就會出現對應的語法突顯(syntax highlighting)。
至於 Highlight.js:syntax highlighting 所支援的語法如下:
- apache
- arduino
- arm assembly
- asciidoc
- autohotkey
- awk
- bash
- cmake
- coffeescript
- cpp
- cs
- css
- diff
- dockerfile
- erlang
- fortran
- go
- gradle
- haskell
- html
- http
- ini
- intel x86 assembly
- java
- javascript
- json
- kotlin
- makefile
- markdown
- mathematica
- matlab
- nginx
- objectivec
- perl
- php
- powershell
- python
- R
- ruby
- rust
- sql
- typescript
- vim script
- xml
- yaml
你疑惑地想著,如果想要的程式語言不在其中怎麼辦?像我就喜歡使用 Excel 和 VBA ,難道就沒有辦法使用語法突顯了嗎?這問題找我就對啦!
連結到 highlight.js 官方網站,標註著「185 languages and 91 styles」,感受到什麼了嗎?沒錯,除了可以支援 185種程式語法突顯,還多了 91種的色彩配置。接著就讓我們來實際操作吧
本次的目標:除了既有的語法突顯,並新增 Excel 和 VBA(相當於 VB.NET),同時調整風格為 A 11 Y Dark
如何設定對應程式語言的種類
在 highlight.js 網站點選 Get version 9.18.1 後,透過頁面下方所列表的程式語言,除了上面 Common 區塊已經核選,下面的 Other 區塊再逐一核選自己需要的,像是本例的 Excel 和 VB.NET,最後按下 Download 即可得到壓縮檔案。
(※別忘了把原本 tiddlywiki highlight.js 既有的加入,因為從網站下載的檔案並沒有涵蓋到原本的語法範圍喔;或者就只核選自己常用的語言即可,畢竟日後都還可以再增添。)
- 打開壓縮檔,使用編輯器打開
highlight.pack.js
,從!function(e){var
開始框選到],i:/#(?!!)/}});
為止複製起來; - 開啟 tiddlyWiki 並切換至 plugins 選擇 Highlight.js:syntax highlighting (如上圖),按下黃色標記的
$:/plugins/tiddlywiki/highlight/highlight.js
進入編輯畫面,將剛才複製的內容完整對應地貼上,不要覆蓋到第一行和最後一行的句子,如下面所示:(第一行:var hljs ...
;最後一行:exports.hljs ...
),最後儲存即可正常使用囉。
var hljs = require("$:/plugins/tiddlywiki/highlight/highlight.js");
/*! highlight.js v9.15.6 | BSD3 License | git.io/hljslicense */
!function(e){var n="object"==typeof window&&window||"object"==typeof ......
.......
{b:/\$[(.]/},e.METHOD_GUARD,{cN:"class",bK:"class",e:/[{;=]/,eE:!0,i:/[:"\[\]]/,c:[{bK:"extends"},e.UTM]},{bK:"constructor get set",e:/\{/,eE:!0}],i:/#(?!!)/}});
exports.hljs = hljs;
如何調整色彩配置
你想到了嗎?就是去調整綠色標記的部分。(教學的部分就留給自己去研究,就在下載檔案裏面的 *.css 或者從下載頁面的「For other available styles look into the highlight.js styles directory (and don’t forget to add “.min" before “.css").」去複製)