TiddlyWiki5/core/language/en-GB/Help/rendertiddler.tid

title: $:/language/Help/rendertiddler
description: Render an individual tiddler as a specified ContentType

(Note: The `--rendertiddler` command is deprecated in favour of the new, more flexible `--render` command)

Render an individual tiddler as a specified ContentType, defaulting to `text/html` and save it to the specified filename.

Optionally the title of a template tiddler can be specified, in which case the template tiddler is rendered with the "currentTiddler" variable set to the tiddler that is being rendered (the first parameter value).

A name and value for an additional variable may optionally also be specified.

```
--rendertiddler <title> <filename> [<type>] [<template>] [<name>] [<value>]
```

By default, the filename is resolved relative to the `output` subdirectory of the edition directory. The `--output` command can be used to direct output to a different directory.

Any missing directories in the path to the filename are automatically created.

For example, the following command saves all tiddlers matching the filter `[tag[done]]` to a JSON file titled `output.json` by employing the core template `$:/core/templates/exporters/JsonFile`.

```
--rendertiddler "$:/core/templates/exporters/JsonFile" output.json text/plain "" exportFilter "[tag[done]]"
```
Move command documentation into the core 2014-02-25 14:50:37 +00:00			`title: $:/language/Help/rendertiddler`
			`description: Render an individual tiddler as a specified ContentType`

Add "save" and "render" commands A first pass at fixing #2973 - comments are welcome. If everybody is happy, the next step is to deprecate the existing rendertiddler(s)/savetiddler(s) commands and replace them in all examples and tiddlywiki.info files with the new equivalents. 2017-09-12 15:04:07 +00:00			(Note: The `--rendertiddler` command is deprecated in favour of the new, more flexible `--render` command)

Enhance rendertiddler command with support for additional variable Passing an arbitrary variable allows us to e.g. reuse the export filters as shown in the example 2017-02-18 13:17:44 +00:00			Render an individual tiddler as a specified ContentType, defaulting to `text/html` and save it to the specified filename.

			`Optionally the title of a template tiddler can be specified, in which case the template tiddler is rendered with the "currentTiddler" variable set to the tiddler that is being rendered (the first parameter value).`

			`A name and value for an additional variable may optionally also be specified.`
Move command documentation into the core 2014-02-25 14:50:37 +00:00
			```
Enhance rendertiddler command with support for additional variable Passing an arbitrary variable allows us to e.g. reuse the export filters as shown in the example 2017-02-18 13:17:44 +00:00			`--rendertiddler <title> <filename> [<type>] [<template>] [<name>] [<value>]`
Move command documentation into the core 2014-02-25 14:50:37 +00:00			```
Add `--build` command First pass at the build system described in #356. To test it, move to a new, empty directory and try `tiddlywiki editions/tw5.com --verbose --build` 2014-04-25 21:41:59 +00:00
Improve output directory handling This change is likely to break most existing scripts that call TiddlyWiki. TL;DR - output paths are now relative to the editions/output folder, rather than to the current folder See [[Notes for upgrading to 5.0.11-beta]] for details. 2014-04-27 07:28:21 +00:00			By default, the filename is resolved relative to the `output` subdirectory of the edition directory. The `--output` command can be used to direct output to a different directory.

Add `--build` command First pass at the build system described in #356. To test it, move to a new, empty directory and try `tiddlywiki editions/tw5.com --verbose --build` 2014-04-25 21:41:59 +00:00			`Any missing directories in the path to the filename are automatically created.`
Enhance rendertiddler command with support for additional variable Passing an arbitrary variable allows us to e.g. reuse the export filters as shown in the example 2017-02-18 13:17:44 +00:00
			For example, the following command saves all tiddlers matching the filter `[tag[done]]` to a JSON file titled `output.json` by employing the core template `$:/core/templates/exporters/JsonFile`.

			```
			`--rendertiddler "$:/core/templates/exporters/JsonFile" output.json text/plain "" exportFilter "[tag[done]]"`
			```