2019-04-14 12:04:00 +01:00
title: $:/language/Help/savewikifolder
description: Saves a wiki to a new wiki folder
2019-05-31 08:38:34 +01:00
<<.from-version "5.1.20">> Saves the current wiki as a wiki folder, including tiddlers, plugins and configuration:
2019-04-14 12:04:00 +01:00
```
2023-06-29 22:40:35 +08:00
--savewikifolder <wikifolderpath> [<filter>] [ [<name>=<value>] ]*
2019-04-14 12:04:00 +01:00
```
* The target wiki folder must be empty or non-existent
* The filter specifies which tiddlers should be included. It is optional, defaulting to `[all[tiddlers]]`
* Plugins from the official plugin library are replaced with references to those plugins in the `tiddlywiki.info` file
* Custom plugins are unpacked into their own folder
2023-06-29 22:40:35 +08:00
The following options are supported:
* ''filter'': a filter expression that defines the tiddlers to include in the output.
2023-07-01 11:11:08 +01:00
* ''explodePlugins'': defaults to "yes"
** ''yes'' will "explode" plugins into separate tiddler files and save them to the plugin directory within the wiki folder
** ''no'' will suppress exploding plugins into their constituent tiddler files. It will save the plugin as a single JSON tiddler in the tiddlers folder
2023-10-01 10:00:06 +02:00
Note that both ''explodePlugins'' options will produce wiki folders that build the exact same original wiki. The difference lies in how plugins are represented in the wiki folder.
2023-06-29 22:40:35 +08:00
2019-04-14 12:04:00 +01:00
A common usage is to convert a TiddlyWiki HTML file into a wiki folder:
```
tiddlywiki --load ./mywiki.html --savewikifolder ./mywikifolder
```
2023-06-29 22:40:35 +08:00
Save the plugin to the tiddlers directory of the target wiki folder:
```
tiddlywiki --load ./mywiki.html --savewikifolder ./mywikifolder explodePlugins=no
2023-10-01 10:00:06 +02:00
```