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 自动生成