Plotlines
Plotlines is a tool to help create online choice-based narratives.
Authors create a basic story structure in Inkscape. Plotlines will read the SVG file and generate templates for HTML5 output.
Works-in-progress can be saved in human-readable TOML files. This format is better suited to collaborative editing.
Workflow
Inkscape's Connectors tool makes it easy to design a branching narrative structure.
You can capture ideas in the title and description fields of both nodes and edges using the Object Properties
editor.
When that phase is complete, you use Plotlines to save the structure as a .toml file where the serious process of writing and editing begins.
Finally, you can export to a template tree ready for Spiki to generate the HTML suitable for a static web site on the Internet.
Features
Plotlines can import SVG from either of these editors:
| Mode of use | CLI options | Progress | Status |
|---|---|---|---|
| Auto-generation of plot structures | Omit -i option |
Ongoing | :x: |
| Convert Dunnart files to TOML format | -i <file>.svg -o .toml |
Complete | :ok: |
| Convert Inkscape files to TOML format | -i <file>.svg -o .toml |
Complete | :ok: |
| Load and plot a file in TOML format | -i <file>.toml |
Complete | :ok: |
| Load file and generate a Spiki template tree | -i <file>.toml -o <dir> |
Complete | :ok: |
Usage
python3 -m plotlines.main --help
usage: python -m plotlines.main [-h] [--debug] [-i INPUT] [-o OUTPUT] [--ending ENDING] [--limit LIMIT] [--exits EXITS]
options:
-h, --help show this help message and exit
--debug Display debug information
-i, --input INPUT Specify an input file
-o, --output OUTPUT Specify an output file or directory
--ending ENDING Set the number of endings [4].
--limit LIMIT Limit the number of Nodes and Edges in the graph [100]
--exits EXITS Fix the number of exiting Edges from each Node [4]
Metadata
Release files for plotlines 0.5.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| plotlines-0.5.0.tar.gz | 72.2 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| plotlines-0.5.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 158.0 kB
Release files / plotlines-0.5.0.tar.gz
| Download URL | plotlines-0.5.0.tar.gz |
|---|---|
| Size | 72.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
731f3c83a74ca1059d9f3735f553af95bb1302dd5a91d3abc868562be7007211
|
|
BLAKE2b-256 checksum How to use checksums |
eef92635e728e27ec63f56dfa4b056acc8d1a6b182949a01f518945b3615d73b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.0
|
Release files / plotlines-0.5.0-py3-none-any.whl
| Download URL | plotlines-0.5.0-py3-none-any.whl |
|---|---|
| Size | 85.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c0e46369391c0b136d41cd63b1c87071284be6bbd7b81887cf052c83b7349a50
|
|
BLAKE2b-256 checksum How to use checksums |
65be205f35f6207ef08aa2f6c15175d772c9ea2f9d53708a944ffa357ba93504
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.0
|
Security for plotlines 0.5.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.