您是否曾經(jīng)感覺過頭部不夠大，無法容納需要記住的所有內(nèi)容？
歡迎使用TiddlyWiki，這是一個(gè)用于捕獲，組織和共享復(fù)雜信息的獨(dú)特的非線性筆記本。
使用它來保存您的工作清單，計(jì)劃論文或小說，或組織您的婚禮。記錄跨越您大腦的每一個(gè)想法，或者建立一個(gè)靈活而響應(yīng)迅速的網(wǎng)站。
- 網(wǎng)站官網(wǎng)：詳情
下載其他版本，只需對(duì)網(wǎng)頁進(jìn)行一些修改，然后保存，即可保存至本地。
詳細(xì)介紹
- 原文來源：詳情
這篇文章將簡要介紹 TiddlyWiki 的特點(diǎn)，并且分享一些常用的參考鏈接、資源、插件和常見問題的解決方案，以方便有相近需求的小伙伴們。
TiddlyWiki ，按官方說法是一個(gè)「非線性個(gè)人 Web 筆記本」。相比其他筆記和 Wiki 系統(tǒng)，其最大的特點(diǎn)之一是程序本體和數(shù)據(jù)全部都在一個(gè)單 html 文件內(nèi)，與此同時(shí)仍然有著非常強(qiáng)大的功能和插件系統(tǒng)。在我看來，管理以文字、代碼和數(shù)學(xué)公式為主的個(gè)人知識(shí)庫， TiddlyWiki 可謂是最好的選擇之一。
可以在我的知識(shí)庫站點(diǎn)「Dimpurr’s Knowledge Base #1」：http://note.dimpurr.com/?體驗(yàn)一下 TiddlyWiki 的使用和效果。
注意，任意訪客都可以體驗(yàn)到 TiddlyWiki 的全部功能，包括編輯和設(shè)置。不用擔(dān)心，你可以隨意折騰，因?yàn)槟銦o法將更改保存到我的服務(wù)器上，只能下載到本地。
我想找到一個(gè)能方便快捷的打打筆記和維護(hù)個(gè)人知識(shí)庫 Wiki 的方式已經(jīng)很久了。
筆記軟件，例如 EverNote 、 WizNote 、 OneNote 的確十分不錯(cuò)，但是也會(huì)帶來客戶端是否跨平臺(tái)、啟動(dòng)速度是否好看甚至默認(rèn)文字排版是否美觀的問題；而且，常規(guī)的筆記軟件也達(dá)不到 Wiki 級(jí)別方便的 Tag 標(biāo)簽系統(tǒng)。當(dāng)然， Wiki 系統(tǒng)有經(jīng)典的 MediaWiki 系統(tǒng)，還有許許多多的靜態(tài) Wiki 系統(tǒng)、 Wiki 知識(shí)庫類客戶端。然而， MediaWiki 龐大、復(fù)雜和丑陋； Wiki?客戶端程序有好有壞，有設(shè)計(jì)簡陋也有強(qiáng)大美觀，但是最大的限制還是往往不跨平臺(tái)；一些可以用 Github Pages 部署的，基于 Markdown 的 Wiki 系統(tǒng)盡管幾乎能在功能上滿足我的需求，但是每一次撰寫新條目和部署的復(fù)雜度還是令人難以接受。
你可能已經(jīng)看出了我口味相當(dāng)?shù)牡筱@和需求相當(dāng)?shù)脑幃?…… 高中時(shí)因?yàn)闆]有時(shí)間折騰，我搭建了一個(gè) Ghost 博客來存放簡單的讀書筆記，然而隨著某次 VPS 上的 SQLite 被我搞跪了之后，天國的 WIKI#0 除了遺留下來數(shù)據(jù)庫里的幾篇文章之外，就這樣成為了歷史。高中畢業(yè)的暑假來臨，我決定動(dòng)手尋找一款我需要的 Wiki 系統(tǒng)。于是，我找到了 TiddlyWiki 。
TiddlyWiki 的特點(diǎn)
- 程序和數(shù)據(jù)全部存儲(chǔ)在一個(gè)單文件 html 中
- 這讓 TiddlyWiki 既可以在你的本機(jī)運(yùn)行，類似一個(gè)在瀏覽器中運(yùn)行的綠色版單文件應(yīng)用程序；又可以上傳到服務(wù)器上，和網(wǎng)絡(luò)上的所有人分享
- 同時(shí)部署極其簡單，只需要一個(gè)能存放 html 的服務(wù)器，上傳上去就可以使用，根本不需要 PHP、 Node.js、Python 或者其他什么語言環(huán)境，也沒有任何配置步驟
- 你可以隨時(shí)再把服務(wù)器上的 TiddlyWiki 保存進(jìn)本地或者 U 盤，以便帶進(jìn)任何沒有網(wǎng)絡(luò)的環(huán)境查閱
- 作為 Wiki 系統(tǒng)，有 Tag 標(biāo)簽和條目關(guān)聯(lián)等必須的基本功能，和強(qiáng)大的編輯器
- 你能用 Tag 快速整理?xiàng)l目
- 你能用?
[[條目名]]?這樣的語法快速鏈接到其他條目 - 你能用條目名作為 Tag 其他條目，達(dá)到設(shè)置子條目的效果
- 你甚至可以用?
<>?這樣的過濾器生成一個(gè)包含特定 Tag ，但是刪除掉另一個(gè)特定 Tag 的條目列表！ - TiddlyWiki 使用一種類似 Markdown 但是稍有差異的語法，不過很快可以習(xí)慣并且非常好用
- 方便的插件和主題系統(tǒng)
- 可以通過插件支持代碼高亮、 LaTex 數(shù)學(xué)公式、標(biāo)準(zhǔn) Markdown 語法、文章嵌入 TODO 列表、條目加密鎖定 ……
- 可以安裝 Material Design 風(fēng)格、博客風(fēng)格的樣式主題 ……
- 外觀和操作設(shè)計(jì)別致，使用體驗(yàn)好
- TiddlyWiki 是一個(gè)典型的單頁面 Web 應(yīng)用，所以打開的時(shí)候全部內(nèi)容都已經(jīng)載入和緩存在了瀏覽器中，換而言之你不需要刷新頁面，操作和訪問體驗(yàn)非常快速和流暢
- TiddlyWiki 在右側(cè)是搜索和多種方式的條目索引，而左邊是可以卡片式展開多個(gè)和關(guān)閉的條目，還可以為特定的條目順序和組合生成靜態(tài)鏈接，瀏覽和使用十分方便
如何開始
進(jìn)入?http://tiddlywiki.com?官網(wǎng)，閱讀下面的 GettingStarted 條目。這里根據(jù)你的瀏覽器版本會(huì)切換的對(duì)應(yīng)的教程，不過總的來說，你只需要點(diǎn)擊 Download Empty 按鈕就可以下載好一個(gè)全新的 TiddlyWiki 的 html 文件了。或者，你可以按照官方說明通過 Node.js 從 npm 安裝。
你已經(jīng)可以開始本地體驗(yàn)和使用了。
注意，你可能需要去設(shè)置頁面手動(dòng)安裝并啟用中文語言包。
當(dāng)然，我覺得大部分人應(yīng)該都有上傳到服務(wù)器上，以便發(fā)送地址和在線共享的需求。一般我們會(huì)需要把默認(rèn)的 tiddlywiki.html 重命名成 index.html ，這樣訪問就很方便了。
不過如果你直接上傳 html 文件到服務(wù)器，你會(huì)發(fā)現(xiàn)，每次保存都會(huì)重新向本地下載一個(gè)編輯后的 html ，然后你需要不厭其煩的用 FTP 再進(jìn)行上傳和替換 …… 其實(shí)，只需要簡單的配置 PHP 或者 Node.js 保存服務(wù)，就可以解決這個(gè)問題。
額外的：?http://tiddlyspot.com?提供了一個(gè)似乎是免費(fèi)的在線托管 TiddlyWiki 的服務(wù)，還提供了專門用于 GTD 的一些模板；?TiddlyDesktop?是一個(gè) TiddlyWiki 專用的瀏覽器，或者說桌面客戶端。
PHP 保存
PHP 保存非常容易配置。官方的教程在這里：《官方教程》?
- 在?《官方下載》?下載一份?
TiddlyHome_*.*.*.zip - 找到里面?
_thlibstore.php?這個(gè)文件，解壓并編輯里面的?$USERS = array( 'UserName1'=>'Password1', etc)?為你想要的用戶名和密碼 - 上傳 store.php 到你的服務(wù)器，去 TiddlyWiki > 保存 >?TiddlySpot 保存模塊 ，設(shè)置 高級(jí)設(shè)置 >?服務(wù)器網(wǎng)址 為這個(gè) store.php 文件的完整地址，然后在上面填寫用戶名和密碼
- 現(xiàn)在，點(diǎn)擊保存時(shí)，已經(jīng)會(huì)直接保存在服務(wù)器上了
- 注意：
- 你可能需要把備份文件名設(shè)置成 index.html
- 每次保存都會(huì)自動(dòng)創(chuàng)建一份備份，你可以定期手動(dòng)清理
- 建議修改備份文件夾為 backup ，這樣會(huì)把備份保存在 backup/ 子目錄而非 . 根目錄下
因?yàn)?TiddlyWiki 并沒有用戶登陸界面，這個(gè)設(shè)置頁面就相當(dāng)于登陸頁面。密碼是按瀏覽器保存的，所以如果你想在當(dāng)前瀏覽器退出登錄，到設(shè)置頁面清除密碼設(shè)置就好。如果你換了一個(gè)瀏覽器打開 Wiki ，你將需要進(jìn)入設(shè)置重新填寫一次密碼(相當(dāng)于登陸)，才能使用在線保存。
可能遇到的 store.php 錯(cuò)誤
如果你在如上配置完成后，點(diǎn)擊保存后彈出正在保存 Wiki，此后就沒有反應(yīng)、并且在瀏覽器開發(fā)者工具中的 Network 網(wǎng)絡(luò)面板看到 500 Internal Servel Error ，你可以嘗試打開 PHP 的錯(cuò)誤日志查看報(bào)錯(cuò)：
vim /usr/local/php/etc/php-fpm.conf
php_flag[display_errors] = On # 直接在網(wǎng)頁上顯示錯(cuò)誤信息
#php_admin_value[error_log] = /usr/local/php/var/log/php_errors.log
#php_admin_flag[log_errors] = on
cat /usr/local/php/var/log/php-error.log # 或者直接在瀏覽器中查看報(bào)錯(cuò)
如果遇到關(guān)于 split() 函數(shù)的問題：
那么可能是你運(yùn)行的 php 版本已經(jīng)廢棄這個(gè)函數(shù)，編輯?store.php?文件并查找替換所有的?split 為?explode?即可。
可能用到的資源
我收集的 TiddlyWiki 相關(guān)資源，都會(huì)第一時(shí)間整理到我的知識(shí)庫：?詳情
比較重要的包括：
- 第三方官網(wǎng)繁體中文翻譯：?詳情?(感謝 Bennyli 提醒)
- 編輯器標(biāo)記語法參考：?詳情
- TiddlyWiki Community (官方整理的社區(qū)資源列表)：?詳情
- tid.li Plugins (一個(gè)個(gè)人第三方插件源)：?詳情
- CommunityPlugins?(更大的一個(gè)第三方插件索引)：?詳情
關(guān)于插件
需要注意的是， TiddlyWiki 最新的版本 5 有重大的變化，導(dǎo)致針對(duì)老版本設(shè)計(jì)的插件全部失效無法安裝。你可能會(huì)在網(wǎng)上搜索到很多老版本的插件源，以及告訴你使用新建條件、粘貼插件代碼內(nèi)容的方式安裝，都已經(jīng)無法再使用了。所以，記得確認(rèn)你找到的插件支持 TW5 。
目前，正確的插件安裝方式除了在設(shè)置頁面的官方插件源在線安裝，對(duì)于第三方插件源來說，一般是你拖動(dòng)第三方插件源提供的鏈接、圖標(biāo)或者按鈕(不一定有效)，或者其設(shè)置頁面的插件名稱(一定有效)，拖動(dòng)到你的 Wiki 頁面上，完成導(dǎo)入安裝。
我這里安利下我用到的插件，更多的可以在官方插件、主題市場(chǎng)和上面的插件源里自己發(fā)掘。
- TiddlyWiki 官方插件程式庫
- Highlight.js: syntax highlighting?代碼高亮，程序員必備
- Markdown parser?添加標(biāo)準(zhǔn) Markdown 支持，如果你希望和?md 格式的平臺(tái)互相導(dǎo)入和導(dǎo)出的話；大部分情況下，如果可以我建議使用原生 TiddlyWiki 語法，因?yàn)楣δ芨訌?qiáng)大和對(duì)插件支持更好
- KaTeX: mathematical typography?數(shù)學(xué)公式輸入和排版
- MathJax?相比 KaTeX 更強(qiáng)大的 TeX 解析器
- 為了兼容新版主題，你可能需要?做點(diǎn)微小的工作?修改一行插件代碼
- TiddlyWiki Community Search
- tw5-checklist?我經(jīng)常使用的，一個(gè)輕量級(jí)在文章中嵌入 checklist 的插件，適合做些學(xué)習(xí)計(jì)劃等
- Encrypt-Tiddler?對(duì)單個(gè)條目啟用輸入密碼查看
- tid.li Plugins
- ToDoNow?一個(gè)強(qiáng)大的簡直有點(diǎn)過頭的嵌入 Todolist 插件
- EditorCounter & Autosaver?為編輯器添加字?jǐn)?shù)統(tǒng)計(jì)和一定字?jǐn)?shù)更改后自動(dòng)保存 (原生自帶了條目修改確認(rèn)和刪除操作時(shí)自動(dòng)保存功能，去設(shè)置里開啟即可)
- TiddlyMap?一個(gè)強(qiáng)大的令人發(fā)指的流程圖、思維導(dǎo)圖等繪制插件
至于主題也有不少，不過我對(duì)默認(rèn)的主題很滿意 (你可能會(huì)發(fā)現(xiàn) TiddlyWiki 的默認(rèn)樣式巧合的和我的?Clearision?博客主題灰色風(fēng)格的設(shè)計(jì)十分相似) ，外加懶得折騰，所以就沒有更換。
當(dāng)然，盡管內(nèi)容數(shù)據(jù)很難占據(jù)多少空間，安裝過多不必要的插件卻可能很快使 html 源文件尺寸增大，這點(diǎn)需要注意。
關(guān)于文本編輯
請(qǐng)務(wù)必花點(diǎn)時(shí)間閱讀編輯器標(biāo)記語法參考?http://tiddlywiki.com/#WikiText?的內(nèi)容，你會(huì)發(fā)現(xiàn)十分值得。這里強(qiáng)調(diào)幾點(diǎn)我覺得特別有用的內(nèi)容。
插入圖片的正確姿勢(shì)是?[img[http://img1.cheny.org/dptool/img/170921112724_v2-0d6d1cde06a90b753193b510e5b9a5a4_r.jpg]]?。文本中的 URL 會(huì)被自動(dòng)識(shí)別為鏈接，如果你想要給一段自定義文本設(shè)置超鏈接，試試?[ext[個(gè)人成長/學(xué)習(xí)/考試/品格/自控/時(shí)間管理 - Dimpurr 的知乎收藏|https://www.zhihu.com/collection/104053246]](ext 大部分情況下可以省略)。
相比 Markdown 的用縮進(jìn)排版， TiddlyWiki 的無序列表 * 和有序列表 # ，以及縮進(jìn)子列表不用 Tab 而是用兩次列表符號(hào)比如 ** 或者 *# 剛開始可能顯得有點(diǎn)讓人迷惑。習(xí)慣就好。
用 TiddlyWiki 排版表格真的非常的爽！你可以自由的設(shè)置表頭，表尾，表名，每個(gè)單元格對(duì)齊方式，跨格，而且語法非常簡單方便，輸入流暢。請(qǐng)閱讀官方文檔?《官方文檔》?。
前面展示過自動(dòng)生成條件列表，并且按 Tag 過濾的「魔法」。參考：《官方文檔》?，記得閱讀底部的 See also 詳細(xì)說明！
如果你愿意折騰，你可以嘗試學(xué)習(xí) Macro 宏和 Variables 變量的用法。
TiddlyWiki 有時(shí)會(huì)把符合 PascalCase /?UpperCamelCase 的詞自動(dòng)識(shí)別為條目鏈接。你只需要在前面加入一個(gè)波浪線 ~ 轉(zhuǎn)義，比如 ~TiddlyWiki ，就會(huì)恢復(fù)為純文本。
安裝了?Highlight.js 插件后，你可以這樣指定代碼塊使用的高亮語法：
```bash
? ~ pwd
/Users/dimpurr
```在 Highlight.js 插件設(shè)置頁面你可以找到支持的語法列表。注意所有 shell 命令的標(biāo)識(shí)符是 bash ，而不是 sh 或者其他的什么。
一些小問題
禁用搜索最小字?jǐn)?shù)限制
TiddlyWiki 默認(rèn)的搜索框存在字符數(shù)限制，要求搜索關(guān)鍵詞大于三個(gè)字符。對(duì)于英語環(huán)境來說這很合理，但是對(duì)于中文來說，二字詞的搜索是很常見的，因此很不方便。修改這個(gè)設(shè)置只需要：
- 添加一個(gè)標(biāo)題為?
$:/config/Search/MinLength?的新條目 - 內(nèi)容為?
1
禁用自動(dòng) WikiLink
TiddlyWiki 默認(rèn)自動(dòng)會(huì)把符合 CamelCase 的文本替換為條目鏈接，稱為 WikiLinks?或者 WikiWords?。一般來說你可以用 ~WikiText 來轉(zhuǎn)義禁止鏈接，但是對(duì)于長篇文章這樣做實(shí)在辛苦。網(wǎng)上流傳的基本是直接禁用 WikiLink 功能的方法，但是這樣之前 ~ 反轉(zhuǎn)移過的文字又會(huì)顯示出 ~ 符號(hào)。
一個(gè)既能讓之前的 ~ 不顯示，同時(shí)也不會(huì)有自動(dòng)鏈接的方法是：
- 點(diǎn)擊搜索框旁邊的圖標(biāo)進(jìn)入?AdvancedSearch
- 搜索?
$:/core/modules/parsers/wikiparser/rules/wikilink.js?，或者點(diǎn)擊?$:/core再找到這個(gè)條目，點(diǎn)擊進(jìn)入編輯 - 系統(tǒng)會(huì)提示?
這是一個(gè)修改過的默認(rèn)條目。刪除此條目可以還原為 $:/core 插件中的默認(rèn)版本。?因此不用擔(dān)心 - 找到最后面的?
return [{return [{ type: "link",?，在這一行上面加上一行?return [{type: "text", text: linkText}];?，以便在本要返回鏈接的時(shí)候返回純文本
使用樹狀結(jié)構(gòu)組織條目內(nèi)容
如果你對(duì)條目的組織結(jié)構(gòu)有強(qiáng)迫癥，又不像我一樣覺得內(nèi)容零散到只能手動(dòng)編寫目錄，使用自帶的樹狀目錄系統(tǒng)是個(gè)好選擇。
<div class="tc-table-of-contents">
<<toc-selective-expandable 'Contents' sort[title]>>
</div>通過以上代碼可以創(chuàng)建以 Contents 條目(該條目不會(huì)顯示出來)為根節(jié)點(diǎn)，按照標(biāo)簽關(guān)系嵌套的樹狀目錄結(jié)構(gòu)列表。
通過將這個(gè)條目命名為「目錄」，并加上?$:/tags/SideBar?標(biāo)簽，就可以使這個(gè)目錄顯示到側(cè)邊欄。效果如下：
