> I have several TiddlyWikis in one directory.
> How can I link to a tiddler in one TW from another TW
Using the 'permalink' syntax in an 'external link':
[[text to display|otherfile.html#TiddlerName]]
will open the otherfile.html document in a separate tab/window, and
automatically display the TiddlerName specified following the "#".
If, however, you want to display this tiddler *in the current
document*, without opening a separate document window, you can use
http://www.TiddlyTools.com/#ExternalTiddlersPlugin
This plugin extends the core's <<tiddler TiddlerName>> macro, so that
you can dynamically render content stored in other files simply by
using a URL or path/file reference in place of the normal TiddlerName
param. For example:
<<tiddler somefile.txt>>
will read and render the contents of 'somefile.txt' (contained in the
same directory as the current document), while
<<tiddler
http://www.example.com/somefile.txt>>
renders the contents of somefile.txt, stored on a remote server.
Each time the <<tiddler>> macro is rendered, it will re-read the
content from the external file. This is particularly useful when the
external file is dynamically-updated on a periodic basis (such as a
web server error log file). Every time the <<tiddler>> macro is re-
rendered, the *current* error log contents is retrieved and displayed,
giving you an instant 'system monitor' within your TiddlyWiki
document!
For your requested purpose (linking to tiddlers in other TW
documents), in addition to being able to pull contents from ANY file
type, the plugin's extended syntax also allows you to make references
to specific tiddlers contained WITHIN an external TW document, using
the standard 'permalink' syntax:
<<tiddler otherfile.html#TiddlerName>>
Note: this plugin also provides a 'fallback' mechanism that allows you
to specify a list of alternative sources for the tiddler content,
using "|" to separate the alternatives, e.g.:
<<tiddler TiddlerName|localfile.html#TiddlerName|http://
www.example.com/remotefile.html#TiddlerName>>
The plugin tries each alternative, in turn, until one is successfully
read in. In addition, if the FIRST alternative is a simple
TiddlerName that does NOT exist in the current document, and an
alternative is successfully read, that TiddlerName is automatically
created from the external source, effectively 'caching' the results
locally, so that the external access does not have to be repeated
during the current document session.
By default, if you subsequently save the current document, these auto-
imported tiddlers ARE saved with the document. However, the plugin
can also automatically tag the locally-cached tiddlers with
"temporary", so that if you have installed
http://www.TiddlyTools.com/#TemporaryTiddlersPlugin
the auto-imported tiddlers will be skipped over when you save the
current document, so that those tiddlers will be re-read from the
external source each time your document is loaded.
enjoy,
-e
Eric Shulman
TiddlyTools / ELS Design Studios