This plugin requires Grunt
If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:
npm install grunt-entwine --save-dev
The "entwine" task
In your project's Gruntfile, add a section named
entwine to the data object
files property should look like this:
You can add as many entries to the array as you like. Here's how they will be combined:
- Twine story files will combine passages.
- Twee source code will combine passages.
- CSS files will have their contents appended to the story's stylesheet field.
The first story file listed is treated specially. It will:
- Use its starting passage as the generated story file's starting passage, if
you haven't overridden it with the
startPassageoption (see below).
- Set the generated story's name, if you haven't overridden it with the
storyNameoption (see below).
You can use this task with Twine 2 stories without publishing them first. In order to find the path of a story, use the Show Library item in the Twine menu. This will show the full path of your Twine 2 story library. Combine this with the file name of the story file you'd like to use. Twine 2 will update the file as you edit it, so you don't need to do anything else to get the most recent version of the story.
You must set this, either at the task level or in a target. This is a file path
to a Twine 2 story format (usually named
format.js). If you'd like to use a
format that comes packaged with Twine 2, you can download it from the source
repository, under the
story-formats directory. Make sure to download the appropriate file named
format.js. You don't need any other file from the repository.
The story name to set on the generated story file. If omitted, this will use
the story name of the first story file you add in the
The passage name to use as starting point on the generated story file. If
omitted, this will use the start passage of the first Twine story file you add
The example below shows how to create a single story file from several ones.
1.2.0: Add option to set the starting passage. 1.1.0: Add Twee source support. This doesn't fully support a Twee-only workflow yet, as there's no means to indicate what the starting passage should be. 1.0.0: Initial version.