太微中文论坛

@机杼 $:/plugins/dyp/mulu，在https://dyp1121054136.github.io/dyp-plugins-library/中有示例，条目名叫“目录测试”

我不是写了一个目录插件吗，可以加前缀序号，加在标题或者caption都可以，按序号排序，而且在浏览的时候序号是隐藏的

新增了自动用uri引用github仓库在线图片的功能

tiddlywiki.info

{
	"description": "TiddlyWiki Plugin Library",
	"plugins": [
		"tiddlywiki/pluginlibrary",
		"tiddlywiki/highlight",
		"tiddlywiki/jszip"
	],
	"themes": [
                "tiddlywiki/vanilla",
                "tiddlywiki/snowwhite"
	],
	"languages": [
                "zh-Hans"
	],
	"includeWikis": [
	],
	"build": {
                "externalimages": [    
                        "--save", "[is[image]]", "images",  
                        "--setfield", "[is[image]]", "_canonical_uri", "$:/core/templates/canonical-uri-external-image", "text/plain",  
                        "--setfield", "[is[image]]", "text", "", "text/plain",  
                        "--render", "$:/core/save/all", "index.html", "text/plain"],
		"library": [
			"--makelibrary","$:/UpgradeLibrary",
   			"--savelibrarytiddlers","$:/UpgradeLibrary","[prefix[$:/]] -[prefix[$:/plugins/tiddlywiki/]] -[prefix[$:/themes/tiddlywiki/]] -[prefix[$:/languages/]] -[[$:/plugins/tiddlywiki/upgrade]] -[[$:/plugins/tiddlywiki/translators]] -[[$:/plugins/tiddlywiki/pluginlibrary]] -[[$:/plugins/tiddlywiki/jasmine]]","recipes/library/tiddlers/","$:/UpgradeLibrary/List",
   			"--savetiddler","$:/UpgradeLibrary/List","recipes/library/tiddlers.json",
			"--rendertiddler","$:/plugins/tiddlywiki/pluginlibrary/library.template.html","index.html","text/plain"],
		"gui": ["--load","gui/",
			"--rendertiddler","$:/core/save/all","index.html","text/plain"]
	}
}

记得修改图片uri指向路径前缀到自己仓库
tiddlers/external/tiddlywiki.files

{  
    "directories": [  
        {  
            "path": "../../files/images/",  
            "filesRegExp": "^.*\\.(?:jpg|jpeg|png|gif)$",  
            "isTiddlerFile": false,  
            "searchSubdirectories": true,  
            "fields": {  
                "title": {"source": "basename-uri-decoded"},  
                "created": {"source": "created"},  
                "modified": {"source": "modified"},  
                "type": "image/jpeg",  
                "tags": {"source": "subdirectories"},  
                "text": "",  
                "_canonical_uri": {"source": "filepath", "prefix": "https://raw.githubusercontent.com/dyp1121054136/dyp-plugins-library/refs/heads/master/files/images/"}  
            }  
        }  
    ]  
}

.github/workflows/main.yml

name: Node.js CI  
  
on:  
  # push:  
  #   branches: [ master ]  
  workflow_dispatch:  # 添加手动触发事件

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          submodules: 'recursive'
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '22'
      - run: npm install tiddlywiki
      - run: mkdir -p node_modules/tiddlywiki/plugins/dyp/
      - run: cp -r plugins/* node_modules/tiddlywiki/plugins/dyp/
      - run: ./node_modules/.bin/tiddlywiki .  --output output --build externalimages
      - run: ./node_modules/.bin/tiddlywiki .  --output output/library --build library
      - run: ./node_modules/.bin/tiddlywiki .  --output output --build gui
      - name: Deploy to GitHub Pages
        if: success()
        uses: crazy-max/ghaction-github-pages@v2
        with:
          target_branch: gh-pages
          build_dir: output
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

关于字体

woff2字体条目类型已修改为 application/octet-stream (一种MIME类型，通用的二进制文件类型)；

为了加快网站响应速度，部分不常用的字体已禁用，前缀为“引用字体-”的条目 $:/tags/Stylesheet 标签已移除，可重新加上 $:/tags/Stylesheet 标签使之生效

我也遇到了类似的情况，css和筛选器对被打包成插件的影子条目不生效了

以上方法不知为什么失效了，自建了一个新的tiddlywiki中文版空白模板：

https://github.com/dyp1121054136/tw-online-template

示例：

https://dyp1121054136.github.io/tw-online-template/

不需要下载任何软件，写几条命令就能发布github pages了，而且会自动更新到最新版本的核心。

@机杼 这是一个插件库，不是网站，是让别人下载插件的，cpl也能搜索到我制作的插件了。字体还是制作为本地的好，手机端也能用，在线引用css每次打开wiki都要重新下载一遍很麻烦。

字体插件有未知bug，如果字体不生效，可能是安装的时候woff2文件打包状态被破坏了，修改条目类型为 application/font-woff2 或 font/woff2，可使字体重新生效

功能：

放置在“plugins”插件文件夹中的tiddlywiki插件将自动托管在此仓库的 GitHub Pages 站点上，提交到 master 分支将自动更新tiddlywiki插件库。

步骤：

1、复制此模板并新建仓库
https://github.com/mklauber/tw5-plugins-template

点击："Use this template"-"Create a new repository"，填写仓库名 Repository name-点击"Create repository"

2、gui/Library.tid 修改链接指向自己的仓库

url: https://{github 用户名}.github.io/{仓库名}/library/index.html

示例：https://dyp1121054136.github.io/dyp-plugins-library/library/index.html

3、新建github动作配置文件.github/workflows/main.yml

name: Node.js CI

on:
  push:
    branches: [ master ]
  workflow_dispatch:  # 添加手动触发事件

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          submodules: 'recursive'
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '22'
      - run: npm install tiddlywiki
      - run: mkdir -p node_modules/tiddlywiki/plugins/dyp/
      - run: cp -r plugins/* node_modules/tiddlywiki/plugins/dyp/
      - run: ./node_modules/.bin/tiddlywiki .  --output output/library --build library
      - run: ./node_modules/.bin/tiddlywiki .  --output output --build gui
      - name: Deploy to GitHub Pages
        if: success()
        uses: crazy-max/ghaction-github-pages@v2
        with:
          target_branch: gh-pages
          build_dir: output
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

4、修改仓库权限

"Settings"-"Actions"-"General"-"Workflow permissions"，勾选"Read and write permissions"，工作流在所有范围的存储库中均具有读写权限。

5、设置为中文

tiddlywiki.info 中增加

	"languages": [
                "zh-Hans"
	],

新建文件gui/$__language.json

[{"created":"20250508112256704","text":"$:/languages/zh-Hans","title":"$:/language","modified":"20250508112643825"}]

6、修改master分支中的内容会自动部署gh-pages分支，如果没有，可以手动部署

"Actions"-"Node.js CI"-"Run workflow"-"Branch: master"-"Run workflow"

7、GitHub Pages指向gh-pages分支

"Settings"-"Pages"，选"Deploy from a branch"，"gh-pages"-"/ (root)"-"Save"

8、部署成功后访问：
{github 用户名}.github.io/{仓库名}

示例：dyp1121054136.github.io/dyp-plugins-library

其他技巧：

1、想要预装tiddlywiki官方插件，可以修改tiddlywiki.info文件，插件名格式为"tiddlywiki/插件名"，用英文逗号隔开多个插件

示例：

	"plugins": [
		"tiddlywiki/pluginlibrary",
		"tiddlywiki/highlight"
	],

tiddlywiki官方插件库：https://github.com/TiddlyWiki/TiddlyWiki5/tree/master/plugins/tiddlywiki

2、个人常用配置和新条目可以上传到 gui 文件夹

可以直接上传json文件

例如：
网站标题、网站副标题

$__SiteTitle.json、$__SiteSubtitle.json

3、禁用自动部署，只需注释掉 push 触发器，只保留 workflow_dispatch 手动触发器，避免文件修改或上传到一半的时候就自动部署了

  # push:  
  #   branches: [ master ]

Deepwiki AI 分析本仓库：

https://deepwiki.com/dyp1121054136/dyp-plugins-library

github tiddlywiki插件库示例：

源代码：

https://github.com/dyp1121054136/dyp-plugins-library

在线演示

https://dyp1121054136.github.io/dyp-plugins-library/

确实是收不到的，默认已经有权限发贴的了，无功能限制

在使用node命令转换前需先安装TiddlyWiki

win+R，输入npm或powershell打开终端，输入：

npm install -g tiddlywiki

检查TiddlyWiki是否安装成功，输入：

tiddlywiki --version

tiddlywiki源代码：
https://github.com/Jermolene/TiddlyWiki5

用node构建本地服务器重新打开wiki（也可以导入文件夹到太记直接编辑）

示例代码：

tiddlywiki "D:\TidGi\TidGi备份\TidGi-Reading" --listen

在浏览器打开 http://127.0.0.1:8080/

html单文件版wiki转文件夹版wiki

使用node命令转换

node下载地址：
https://nodejs.org/zh-cn

示例代码：

tiddlywiki --load "E:\星愿浏览器\星愿浏览器下载的文件\TidGi-Reading.html" --savewikifolder "E:\星愿浏览器\星愿浏览器下载的文件\TidGi-Reading"

需按实修改路径，html文件名和新文件夹名

当云端github仓库为空，太记本地文件夹有内容时，无法直接同步，需要先用git命令推送到云端（需额外安装git软件）

也适用于已有单文件版wiki的html，直接无损转换为文件夹版wiki上传github存档的情况

git软件下载地址：
https://git-scm.com/

教程-推送本地文件夹到github仓库

git init 本地初始化一个git仓库
git add . 将本地所有文件添加到我们本地仓库
git commit -m "first commit" 提交
git remote add origin git@github.com:crazy-dking/xxx.git 添加远程连接（地址需要更改为实际地址）
git push -u origin master 推送代码到远程

【最简单的方式将本地的代码提交到远程github仓库-哔哩哔哩】 https://b23.tv/JcIic1L

宏的名字得全部换掉吧，打上 $:/tags/Macro 标签就可以随处用了

太记客户端需要配置GitHub仓库信息，以便拉取数据和上传更新。

设置-同步和备份-Git身份凭证

新建工作区，导入线上wiki，填对应的仓库网址并设置保存到的本地父文件夹和新文件夹名

文件夹版wiki无需设置GitHub保存模块，但会多一个 $:/plugins/linonetwo/github-external-image/ControlPanel/Settings 条目，需要修改内容

注意GitHub pages要选action的方式

经测试，多个条目打包成的json文件直接上传到GitHub仓库的tiddlers文件夹，也是可以识别的，原来的标签等信息也不会丢失。一有修改，action会自动触发并重新部署静态网页，需要等部署成功才能看到更新内容。

文件夹版wiki只能用太记客户端编辑同步，在网页上编辑无法回传保存。

太记客户端下载地址：
https://github.com/tiddly-gittly/TidGi-Desktop