Skip to content

Latest commit

 

History

History
15 lines (12 loc) · 2.23 KB

README.md

File metadata and controls

15 lines (12 loc) · 2.23 KB
Raw

tiddly-aliases

JS-based implementation of Wikipedia-style aliases and redirects for non existing tiddlers. This plugin allows you to setup tiddlers with an "aliases" field. All aliases will then also be links to the parent tiddler. This could be useful for situations where you want multiple terms to refer to the same thing, such as when a character has multiple names.

Known limitations:

  • An alias does not re-render automatically when you change the number of aliases it points to. This can make links that look like they're missing actually resolve, and links that look like they resolve instead go to a disambiguation page. However, this issue only lasts until the tiddler holding the link is re-rendered.
  • In TiddlyWiki 5.1.22 and below, the 'Missing tiddler' tool is populated with aliases, limiting its usefulness. This problem is corrected in versions TiddlyWiki 5.1.23 and above using the "enlist-input" function, which is available only on these more recent versions of TiddlyWiki.

How-to:

  • Install from https://mklauber.github.io/tw5-plugins/ or upload files to your Tiddlywiki instance.
  • To add aliases to a tiddler, create an "aliases" field and add as many aliases as you desire. For one single single-word aliases, no brackets are needed. For several aliases, use double square brackets to separate aliases (eg. [[alias1]] [[another alias]] ).
  • Use the [[$:/Aliases]] tool to easily add an "aliases" field to tiddlers without aliases, edit the aliases of these tiddlers or any others that have been modified during the session, as well as to investigate any missing tiddlers.

Change log:

  • 210525: Added an [[$:/Aliases]] tool that makes it easy to add an "aliases" field to tiddlers without aliases, to edit the aliases of these tiddlers or any other that have been modified during the session, as well as to investigate any missing tiddlers.
  • 210524: The 'Missing tiddler' tool was populated with aliases, limiting its usefulness. The problem is corrected on versions TiddlyWiki 5.1.23 and above, while behaviour is unchanged on prior versions. The problem is corrected on recent versions of TiddlyWiki by adapting the filter in [[$:/core/Filters/Missing]] by using the "enlist-input" function, which is available only on TiddlyWiki 5.1.23 and above.