mirror of
https://github.com/Jermolene/TiddlyWiki5
synced 2024-11-19 16:24:51 +00:00
0d0ece6377
Like the load command except retrieves the file over HTTP/HTTPS. Allows experimentation with server-side twederation This is a cleaned up version of code that I wrote last year at TWEUM 2016 @inmysocks @pmario @twMat @xcazin
29 lines
1.6 KiB
Plaintext
29 lines
1.6 KiB
Plaintext
title: $:/language/Help/fetch
|
|
description: Fetch tiddlers from wiki by URL
|
|
|
|
Fetch one or more files over HTTP/HTTPS, and import the tiddlers matching a filter, optionally transforming the incoming titles.
|
|
|
|
```
|
|
--fetch file <url> <import-filter> <transform-filter>
|
|
--fetch files <url-filter> <import-filter> <transform-filter>
|
|
```
|
|
|
|
With the "file" variant only a single file is fetched and the first parameter is the URL of the file to read.
|
|
|
|
With the "files" variant, multiple files are fetched and the first parameter is a filter yielding a list of URLs of the files to read. For example, given a set of tiddlers tagged "remote-server" that have a field "url" the filter `[tag[remote-server]get[url]]` will retrieve all the available URLs.
|
|
|
|
The `<import-filter>` parameter specifies a filter determining which tiddlers are imported. It defaults to `[all[tiddlers]]` if not provided.
|
|
|
|
The `<transform-filter>` parameter specifies an optional filter that transforms the titles of the imported tiddlers. For example, `[addprefix[$:/myimports/]]` would add the prefix `$:/myimports/` to each title.
|
|
|
|
Preceding the `--fetch` command with `--verbose` will output progress information during the import.
|
|
|
|
Note that TiddlyWiki will not fetch an older version of an already loaded plugin.
|
|
|
|
The following example retrieves all the non-system tiddlers from http://tiddlywiki.com and saves them to a JSON file:
|
|
|
|
```
|
|
tiddlywiki --verbose --fetch file "http://tiddlywiki.com/" "[!is[system]]" "" --rendertiddler "$:/core/templates/exporters/JsonFile" output.json text/plain "" exportFilter "[!is[system]]"
|
|
```
|
|
|