2019-04-14 11:04:00 +00:00
title: $:/language/Help/savewikifolder
description: Saves a wiki to a new wiki folder
2019-05-31 07:38:34 +00:00
<<.from-version "5.1.20">> Saves the current wiki as a wiki folder, including tiddlers, plugins and configuration:
2019-04-14 11:04:00 +00:00
```
2023-06-29 14:40:35 +00:00
--savewikifolder <wikifolderpath> [<filter>] [ [<name>=<value>] ]*
2019-04-14 11:04:00 +00: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 14:40:35 +00:00
The following options are supported:
* ''filter'': a filter expression that defines the tiddlers to include in the output.
2023-07-01 10:11:08 +00: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 08:00:06 +00: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 14:40:35 +00:00
2019-04-14 11:04:00 +00:00
A common usage is to convert a TiddlyWiki HTML file into a wiki folder:
```
tiddlywiki --load ./mywiki.html --savewikifolder ./mywikifolder
```
2023-06-29 14:40:35 +00:00
Save the plugin to the tiddlers directory of the target wiki folder:
```
tiddlywiki --load ./mywiki.html --savewikifolder ./mywikifolder explodePlugins=no
2023-10-01 08:00:06 +00:00
```