TiddlyWiki5

歡迎

歡迎來到 TiddlyWiki，這是一個非線性個人網路筆記本，任何人都可以獨立於任何公司使用和永久保存。

TiddlyWiki 是一個完整的 JavaScript 互動式 wiki。它可以用作瀏覽器中的單一 HTML 文件，也可以用作功能強大的 Node.js 應用程式。它是高度可自訂的：整個使用者介面本身是在可破解的維基文本中實現的。

示範

了解更多並查看其實際效果，請訪問 https://tiddlywiki.com/

開發者文檔

開發人員文件正在撰寫中，網址為 https://tiddlywiki.com/dev/

拉取請求預覽

拉取請求預覽由 Netlify 提供

加入社區

官方論壇

https://talk.tiddlywiki.org/

用於討論 TiddlyWiki 的新官方論壇：請求幫助、新版本和插件的公告、討論新功能或只是分享經驗。您可以透過相關網站參與，或透過電子郵件訂閱。

talk.tiddlywiki.org是一項由我們自行託管和維護的社群營運服務。適度的運作成本由社區捐款支付。

谷歌網路論壇

為了方便現有用戶，我們也繼續經營原來的 TiddlyWiki 群組（自 2005 年起託管在 Google 線上論壇）：https://groups.google.com/group/TiddlyWiki

開發者論壇

GitHub 統計

有多種資源供開發人員了解有關 TiddlyWiki 的更多資訊並討論其開發並為其開發做出貢獻。

• tiddlywiki.com/dev 是官方開發者文檔
• 參與 GitHub 上的開發
• GitHub 討論用於問答和開放式討論
• GitHub Issues 用於提出錯誤報告並提出具體的、可操作的新想法
• 舊的 TiddlyWikiDev Google 群組現已關閉，取而代之的是 Talk TiddlyWiki 和 GitHub 討論
  • 它仍然是一個有用的檔案：https://groups.google.com/group/TiddlyWikiDev
    • mail-archive.com 上提供了增強的群組搜尋功能
• 在 https://gitter.im/TiddlyWiki/public 聊天（開發室即將推出）

嘰嘰喳喳

• 在 Twitter 上關注@TiddlyWiki 以了解最新消息

其他論壇

• TiddlyWiki Subreddit
• 在 https://gitter.im/TiddlyWiki/public 與 Gitter 聊天！
• 在 Discord 上聊天：https://discord.gg/HFFZVQ8

文件

還有一個專門討論 TiddlyWiki 文件改進計劃的討論群組：https://groups.google.com/group/tiddlywikidocs

---

在 Node.js 上安裝 TiddlyWiki

TiddlyWiki 是一個 SingleFileApplication，容易使用。對於進階使用者和開發人員，可以使用 Node.js 用戶端/伺服器配置。此配置也用於建立 TiddlyWiki SinglePageApplication

1. 安裝 Node.js
   • Linux：

     Debian/Ubuntu ：
     apt install nodejs
     可能需要跟進：
     apt install npm

     架構Linux
     yay -S tiddlywiki
     （安裝 Node 和 tiddlywiki）

   • 蘋果

     brew install node

   • 安卓

     Android 版 Termux

   • 其他

     請參閱 http://nodejs.org

2. 打開命令列終端機並輸入：

   npm install -g tiddlywiki

   如果失敗並出現錯誤，您可能需要以管理員身份重新執行該命令：

   sudo npm install -g tiddlywiki (Mac/Linux)

3. 鍵入以下內容確保 TiddlyWiki 已安裝：

   tiddlywiki --version

   • 作為回應，您應該會看到 TiddlyWiki 報告其當前版本（例如「5.3.6」。您也可能會看到報告的其他偵錯資訊。）
4. 試試一下：
   1. tiddlywiki mynewwiki --init server為包含伺服器相關元件的新 wiki 建立資料夾
   2. tiddlywiki mynewwiki --listen啟動 TiddlyWiki
   3. 在瀏覽器中造訪http://127.0.0.1:8080/
   4. 嘗試編輯和建立tiddlers
5. （可選）製作離線副本：
   • 點選 側邊欄中的「儲存變更」按鈕，或者
   • tiddlywiki mynewwiki --build index

-g標誌導致 TiddlyWiki 全域安裝。如果沒有它，TiddlyWiki 將僅在您安裝它的目錄中可用。

警告

如果您使用 Debian 或基於 Debian 的 Linux，並且儘管安裝了 node.js 軟體包，但收到了node: command not found錯誤，您可能需要在nodejs和node之間建立符號連結。請查閱您的發行版手冊和whereis以正確建立連結。請參閱 github 問題 1434。

Debian v8.0 範例： sudo ln -s /usr/bin/nodejs /usr/bin/node

提示

您也可以像這樣安裝以前的版本：
npm install -g [email protected]

在 Node.js 上使用 TiddlyWiki

TiddlyWiki5 包括一組在命令列上使用的命令，用於執行基於 TiddlyWikiFolders、TiddlerFiles 的大量操作。

例如，以下命令從 TiddlyWiki HTML 檔案載入 tiddlers，然後將其中一個儲存為靜態 HTML：

 tiddlywiki --verbose --load mywiki.html --render ReadMe ./readme.html

從命令列執行tiddlywiki會啟動 TiddlyWiki 核心、載入核心外掛並建立一個空的 wiki 儲存。然後它從左到右順序處理命令列參數。參數之間以空格分隔。

在 v5.1.20 中引入首先，可以有零個或多個插件引用，由插件名稱的前綴+或插件資料夾的路徑的++標識。除了 TiddlyWikiFolder 中指定的任何插件之外，還會載入這些插件。

下一個參數是要載入的 TiddlyWikiFolder 的可選路徑。如果不存在，則使用目前目錄。

接下來是命令及其各自的參數，每個命令都由前綴--標識。

 tiddlywiki [+ | ++] [] [-- [[,]]]

例如：

 tiddlywiki --version
tiddlywiki +plugins/tiddlywiki/filesystem +plugins/tiddlywiki/tiddlyweb mywiki --listen
tiddlywiki ++./mygreatplugin mywiki --listen

v5.1.18 中引入 支援大量參數的命令（例如 ListenCommand）可以使用 NamedCommandParameters 來簡化操作。例如：

 tiddlywiki wikipath --listen username=jeremy port=8090

有關可用命令的完整列表，請參閱命令。

在 Node.js 上升級 TiddlyWiki

如果您按照常規方式在 Node.js 上安裝了 TiddlyWiki，那麼當新版本發佈時，您可以使用以下命令升級它：

 npm update -g tiddlywiki

在 Mac 或 Linux 上，您需要新增sudo ，如下所示：

 sudo npm update -g tiddlywiki

另請參閱

• 建構 TiddlyWikiClassic
• 自訂 Tiddler 檔案命名
• Node.js 上的環境變數
• 使用 TiddlyWiki 產生靜態站點
• 如何從單一 tidlers 建立 TiddlyWiki5
• 在 Node.js 上安裝自訂插件
• 在 Node.js 上安裝官方插件
• 網路資訊服務
• 在 Node.js 上安裝 TiddlyWiki 預發行版
• 多Tiddler文件
• 多Tiddler檔案語法
• 命名命令參數
• Node.js 上的 TiddlyWiki 腳本
• Termux 上的 Node.js
• 提德勒文件
• tiddlywiki.files 文件
• tiddlywiki.info 文件
• TiddlyWiki 資料夾
• 使用 Node.js 卸載插件
• 在客戶端-伺服器版本中使用自訂路徑前綴
• 使用 TiddlyWiki 取得 GitHub 專案文檔
• 使用 TiddlyWiki5 儲存庫

此自述文件由 TiddlyWiki 自動生成