This page is part of a static HTML representation of the TiddlyWiki at https://tiddlywiki.com/

FetchCommand

18 février 2017 à 13h15

Télécharge un ou plusieurs fichiers via HTTP/HTTPS, puis importe les tiddlers correspondant à un filtre, en transformant optionnellement les titres des tiddlers importés.

--fetch file <url> <filtre-import> <filtre-de-transformation>
--fetch files <filtre-urls> <filtre-import> <filtre-de-transformation>

Avec la variante "file", un seul fichier est téléchargé et le premier paramètre est l'URL du fichier à lire.

Avec la variante "files", plusieurs fichiers sont téléchargés et le premier paramètre est un filtre produisant une liste d'URLs pour les fichiers à lire. Par exemple, étant donné un ensemble de tiddlers tagués "remote-server" et disposant d'un champ "url", le filtre [tag[remote-server]get[url]] permet de récupérer toutes les URLs disponibles.

Le paramètre <filtre-import> spécifie un filtre qui détermine quels tiddlers seront importés. Lorsqu'il n'est pas indiqué, il prend comme valeur par défaut [all[tiddlers]].

Le paramètre <filtre de transformation> spécifie un filtre optionnel qui transforme les titres des tiddlers importés. Par exemple, [addprefix[$:/myimports/]] permettrait d'ajouter le préfixe $:/myimports/ à chaque titre.

On obtient des informations concernant la progression de l'importation en faisant précéder la commande --fetch de la commande --verbose.

Il faut noter que TiddlyWiki ne téléchargera pas une version plus ancienne d'un plugin déjà chargé.

L'exemple ci-dessous récupère tous les tiddlers non-système de https://tiddlywiki.com et les enregistre dans un fichier JSON :

tiddlywiki --verbose --fetch file "https://tiddlywiki.com/" "[!is[system]]" "" --rendertiddler "$:/core/templates/exporters/JsonFile" output.json text/plain "" exportFilter "[!is[system]]"