/story-formats-archive

An archive of Twine 2 story formats

Primary LanguageHTML

Story Format Archive (SFA)

This is a collection of JSON files storing the files of story formats for Twine beginning with 2015 (Twine 1.4.2).

Each story format in the collection contains all necessary files and individual software licenses.

Database Base URLs

  • Official: https://videlais.github.io/story-formats-archive/official/index.json
  • Unofficial: https://videlais.github.io/story-formats-archive/unofficial/index.json

Organization

Organization is split between official and unofficial. If a story format currently is or was packaged with Twine at any point in time, it is considered "official" with all others falling into the "unofficial" collection. Generally, those in the "unofficial" collection are more experimental in nature with some providing complex functionality and others, for example, the ability to export Twine data in particular formats.

Story formats are additionally sorted into twine1 and twine2 sub-collections. In some cases, a story format might be in both categories if it was originally published during the transitory period between major versions.

Organization Example

URL: /official/index.json

{
    "twine1": [
        {

        }
    ],
    "twine2":[
        {

        }
    ]
}

Directories within the major Twine versions include the minor version per story format (e.g. harlowe-3.3.0). For Twine 1 story formats, the version of Twine (e.g. 1.4.2) is used unless explicitly mentioned by the build or author.

Directory Example

URL: /official/twine2/chapbook-1.0.0/

Story Format Properties

Each story format has the following properties:

  • name: (string) Name.
  • author: (string) Author(s) of the story format.
  • version: (string) Semantic version.
  • proofing: (boolean) true if story format is for proofing and false otherwise.
  • description: (string) Summary of story format.
  • files: Files of the story format.

Example:

{
    "twine1": [
        {
            "name": "jonah",
            "version": "1.4.2",
            "files": [
                "LICENSE",
                "code.js",
                "header.html"
            ]
        }
    ],
    "twine2": [
        {
            "name": "chapbook",
            "version": "1.0.0",
            "files": [
                "LICENSE",
                "format.js",
                "logo.svg"
            ]
        }
    ]
}

Twine 2

Each story format folder contains:

Twine 1

Depending on the story format, there may be up to three files:

  • header.html: HTML, JavaScript, and CSS.
  • LICENSE: License text.
  • code.js: Additional JavaScript code.

In cases where the code.js file is not included, the complete JavaScript of the story format can be assumed to be part of the header.html file.