Loading...
The passage marked as the 'start of the story' in twine will always be the first numbered passage, like this one is.
For help with:
[[Formatting Text]].
[[Passage Links]].
[[Passage Order]].
[[Other features]].
[[Converting to EPUB]].
WritingFantasy has some compatibility with <a href="https://gordianbook.art/">Gordian Book</a>, to [[learn more->Gordian Book]]Text style markup is largely the same as Harlowe (the default story format for Twine 2), allowing:
`''`''bold''`''`
`//`//italics//`//`
`~~`~~strikethrough~~`~~`
`^^`^^superscript^^`^^`
`*`*emphasis*`*`
`**`**strong emphasis**`**`
As well as <a href="https://www.youtube.com/watch?v=dQw4w9WgXcQ">html tags</a>.
In addition, you can also `__`__underline__`__` text with a double underscores.
Formatting can be escaped using backticks, each backtick in a passage toggles whether following markup will be ignored.
[[->learning how to use Writing Fantasy]]Writing passage links is the same as normal, two "[" brackets on either side of your text will turn it into a link.
You can also use both "->" and "<-" links for text that describes something other than a passage title.
This even works with //completely blank// text links, which WritingFantasy will use to insert a simple turn instruction with no accompanying text.
Examples of passage link formatting and how they appear:
<ul><li>`[[Passage Links]]` = [[Passage Links]]</li>
<li>`[[display text->Passage Links]]` = [[display text->Passage Links]]</li>
<li>`[[Passage Links<-display text]]` = [[Passage Links<-display text]]</li>
<li>`[[Passage Links<-]]` = [[Passage Links<-]]</li>
<li>`[[->Passage Links]]` = [[->Passage Links]]</li>
<li>`[[#->Passage Links]]` = [[#->Passage Links]]</li>
<li>`[[turnto->Passage Links]]` = [[turnto->Passage Links]]</li></ul>
[[->learning how to use Writing Fantasy]]It is possible to take the generated html from WritingFantasy and put it into a .html file that you convert to epub, preserving the hyperlinks.
But it's a bit awkward, in that simply viewing the source of a WritingFantasy page will only show the twine metadata and WritingFantasy javascript, not the generated html.
Instead, you must //inspect// in your browser the WritingFantasy page, and copy html from within the ''id="storyhere"'' paragraph.
If you are aiming for a print/pdf version of your story, make sure to [[check out Gordian Book->Gordian Book]]
[[learning how to use Writing Fantasy<-]] Passages with a "hidden" or "skip" tag won't be displayed by WritingFantasy.
If you have any passage nodes you don't want to be visible (e.g: a "notes" node) make sure to mark them as hidden, or they will be shuffled into the list of passages and displayed with all the others.
You can disable hyperlinks too: When you publish your twine story to html, in the exported file search for "var usePassageLinks = true;" and replace it with to be "var usePassageLinks = false;".
[[->learning how to use Writing Fantasy]]This passage won't be displayed, because it has the "hidden" tag.
Hello to people who dug into the data and found this passage, you're cool nerds!
Anyway this is my to-do list I use when working on Writing Fantasy:
- Find a way to specify the formatting tips within twine for when a passage has no text
- check if the "edit story javascript" actually gets run or if I need to do stuff like I did for the story stylesheet stuff
- Make an explicit twine-epub converter sometime, if it will save work vs copy/pasting the generated html
- make it so epub chapter titles don't read as 'turn to X' in ibooks (is there some html a property I need to set for the in-page links?)
- make it so front/back matter of unspecified ordered passages is the same regardless of whether there are specified passages or not (use the order they are found in)
- formatting is WEIRD when the markup is detected within a tag, eg the // in html links messes with italic formating
Add more compatibility with Gordian Book:
- end/death tags
- look into long/breakbefore/breakafter tags
- look into the ‘special html’ stuffWritingFantasy is a twine story format inspired by old-school adventure gamebooks, specifically the Fighting Fantasy series.
The main features of WritingFantasy are that it:
<ul><li>Displays twine stories as a series of shuffled numbered passages</li><li>Converts passage links to a "turn to XYZ" format)</li></ul>
This essentially takes twine stories and displays them in a way that can be printable, but also (by default) includes in-page hyperlinks which makes it easier for people to follow when playing the story as a webpage or ebook.
To begin [[learning how to use Writing Fantasy]]
To use WritingFantasy, you can get the latest version here:
<a href="writingfantasy_1.js">writingfantasy_1.js</a>
or the minified version:
<a href="writingfantasy_1_min.js">writingfantasy_1_min.js</a>Passages are shuffled randomly for the most part, with a few exceptions:
<ul><li>The passage marked as the 'start' in twine will always be the first numbered passage</li><li>A passage with the tag "ending" or "last" will always be the last numbered passage (just like this one)</li><li>Passages with a tag formatted as either "fixednumber_123" or "123" will be given the specified passage number, provided there are enough passages (otherwise it will be placed at the end)</li></ul>
Passages can also appear outside of the list of numbered passages:
<ul><li>Passages with the tag "frontmatter" will always appear before numbered passages</li><li>Passages with the tag "backmatter" will always appear after numbered passages</li></ul>The order of front and back matter passages can be specified with tag formatting like "frontmatter_1", "frontmatter_2", etc.
Passage links work even when linking outside of the numbered passages, for example: [[->Thanks]].
Additionally, specially titled passages will appear around the story (and without their passage titles visible):
<ul><li>Passages titled "gb-front-cover" will before all other passages</li><li>Passages titled "gb-introduction" will just before numbered passages (after any front matter)</li><li>Passages titled "gb-rear" will after numbered passages and any back matter</li><li>Passages titled "gb-back-cover" will after all other passages</li></ul>Thanks for your interest in WritingFantasy, and especially thanks to all of my patrons whose support allows me to make things like this.
If you would like to support me on patreon, you can find me here:
<a href="https://www.patreon.com/SophieHoulden">patreon.com/SophieHoulden</a><a href="https://gordianbook.art/">Gordian Book</a> is tool very similar to WritingFantasy. Both take twine stories to make gamebooks, but the process and the results you get will be a bit different.
Most notably, WritingFantasy is a twine "Story Format" which builds and displays your gamebook at once, whereas Gordian Book is more explicitly a converter with an import/export process.
If you are interested in WritingFantasy then Gordian Book is definitely worth a look, __especially__ if you are aiming to have a print/pdf version of your work.
The good news is it doesn't really have to be an either/or choice. Both systems have a degree of shared compatibility, so stories written for one will generally work with the other. Just make sure to check your results after switching as there isn't //complete// feature parity.
[[learning how to use Writing Fantasy<-]]