"Filter Expression" doc

81 views
Skip to first unread message

Jean-Pierre Rivière

unread,
May 4, 2021, 3:09:23 PM5/4/21
to TiddlyWiki
In the "Filter Expression" tiddler the :enter prefix is not listed in the first part, only given in a subsequent table.

As such, :else lacks a proper explanation of what it does.

Saq Imtiaz

unread,
May 4, 2021, 3:30:54 PM5/4/21
to TiddlyWiki
As the table indicates, :else is equivalent to the ~ filter run prefix which is explained earlier in the same tiddler.

Jean-Pierre Rivière

unread,
May 4, 2021, 3:46:02 PM5/4/21
to TiddlyWiki
right. not very user friendly. could be noted earlier at ~

the same for the others. when there is so much to read, being kind on the reader is not undue.

Saq Imtiaz

unread,
May 4, 2021, 3:59:46 PM5/4/21
to TiddlyWiki
I don't disagree. Contributions to the documentation are very welcome.

Jean-Pierre Rivière

unread,
May 4, 2021, 4:50:32 PM5/4/21
to TiddlyWiki
Fine. How may I help then? It's also that bit that I find lacking in the doc (just poke at it but got no interesting stuff for this).

Joshua Fontany

unread,
May 4, 2021, 7:13:42 PM5/4/21
to TiddlyWiki
Fork the TW5 repository to your own GitHub user account, and then clone it locally. 

Then checkout the "tiddlywiki-com" branch via git command line. (This branch can live push updates to the website, and not wait until the next Version release).

Then, run the node command given in the `bin` scripts folder:
`./path/to/TiddlyWiki5/bin.serve.sh`

This launches the "tiddlywiki-com-server" Edition (from the 'TiddlyWiki5/editions' folder) as a node process.

Navigate a browser to 127.0.0.1:8080. Make changes to documentation tiddlers. Push your changes back to your fork.

From GitHub, create a Pull Request from your fork of the "tiddlywiki-com" branch to the official repository's "tiddlywiki-com" branch. Describe your changes in your PR.

The community can then review those changes, and Jeremy can merge if it all looks good.

Best,
Joshua Fontany



Joshua Fontany

unread,
May 4, 2021, 7:14:28 PM5/4/21
to TiddlyWiki
Ooops, that should have been  `./path/to/TiddlyWiki5/bin/serve.sh`.

Best,
Joshua Fontany
Message has been deleted

Saq Imtiaz

unread,
May 5, 2021, 7:33:22 AM5/5/21
to TiddlyWiki
Joshua's reply is the best way to work with docs. However, if you aren't already using node and just want to make a PR for a single tiddler, you can do so via the Github web interface.
  • Find the tiddler you want to make a PR for at TiddlyWiki.com
  • From the tiddler toolbar choose the more dropdown arrow, then info.
  • Go to the Sources tab.
  • Follow the second link to Github.
  • Edit the tiddler on Github to make a PR. It is a good idea to do the actual editing on TiddlyWiki.com and then copy and paste over your content to the Github editor, preserving the metadata at the top of the tiddler.

Reply all
Reply to author
Forward
0 new messages