User Tools

Site Tools


start

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
start [2015/04/12 19:52]
klembot
start [2018/10/06 03:34] (current)
greyelf [Story Formats]
Line 1: Line 1:
-==== Twine Information ​====+~~NOTOC~~ 
 +===== Twine 2=====
  
-The most recent version of Twine 2.x is **2.0.4**, released 12 April 2015. ([[http://​twinery.org/​downloads/​twine_2.0.4.zip|Download]],​ [[http://​twinery.org/​2|Use online]])+<WRAP group> 
 +<WRAP right 64%>
  
-  * [[Twine 2.0.4 release ​notes]] +Twine 2 is the most recent ​release ​series of Twine. ​If you've never used Twine before, this version is recommended.
-  * [[Twine 2.0.3 release notes]] +
-  * [[Twine 2.0.2 release notes]] +
-  * [[Twine 2.0.2 bugs]] +
-  * [[Twine 2.0.1 release notes]] +
-  * [[Twine 2.0.1 bugs]]+
  
-The most recent version of Twine 1.x is **1.4.2**, released 2 Jun 2014. ([[http://​twinery.org/​downloads/​twine_1.4.2_win.exe|Windows]],​ [[http://​twinery.org/​downloads/​twine_1.4.2_osx.zip|OS X]])+<WRAP group> 
 +<WRAP half column>​ 
 +==== Tutorials ====
  
-  * [[Twine 1.4.2 release notes|Twine 1.4.2 release notes]] +  * [[http://catn.decontextualize.com/twine/|Tutorial by Allison Parrish]] 
-  * [[Twine 1.4.2 bugs]] +  * [[https://www.youtube.com/​playlist?​list=PLlXuD3kyVEr5tlic4SRe6ZG-R9OyS1T4d|Screencasts by Dan Cox]] 
-  * [[Twine 1.4.1 release notes]] +</​WRAP>​ 
-  * [[Twine 1.4.1 bugs]] +<WRAP half column> 
-  * [[Twine 1.4 release notes]] +==== Reference Documentation ====
-  * [[Twine 1.4 bugs]] +
-  * [[Versions of Twine]] +
-  * [[Twine licenses]] +
-  * [[Browser support]]+
  
-==== Twine 2 Resources ====+  * [[twine2:​guide|Twine 2 Guide]] 
 +  * [[harlowe:​reference|Harlowe reference]] 
 +</​WRAP>​ 
 +</​WRAP>​ 
 +</​WRAP>​ 
 +<WRAP box 33%> 
 +[[https://​twinery.org|Official download]]
  
-The [[twine2:​guide|Twine 2 Guide]] explains how to use the 2.0 version. [[http://twine2.neocities.org/|Harlowe documentation]] introduces the new default story format and describes differences between it and standard 1.x formats.+[[https://twinery.org/2|Use online]]
  
-[[http://furkleindustries.com/fictions/twine/twine2_CSS_tutorial|Twine 2 CSS tutorial]] for Harlowe. +[[https://bitbucket.org/klembot/twinejs/downloads|Download local web version]]
-   +
-==== Getting Started with Twine 1.x ====+
  
-There are some great tutorials on Twine:+[[twine2:release_notes|Release notes]]
  
-  * [[http://www.auntiepixelante.com/twine/|Anna Anthropy'​s How To Make Games With Twine]] is a great, fast way to get started with Twine. +[[https://bitbucket.org/klembot/twinejs/|Source repository ​and bug tracker]]
-  * [[http://​aliendovecote.com/​twine101|Brenda Neotenomie'​s Twine 101]] is an online Twine tutorial in slideshow format, perfect for teaching workshops. You can navigate using arrow keys or mouse. Right/left goes from topic to topic, down focuses more deeply into that topic. +
-  * [[http://​www.gamasutra.com/​blogs/​DanCox/​20130203/​185939/​Learning_Twine_Part_1.php|Dan Cox's Learning Twine]] blog post series is a gentle introduction to Twine as well. (direct link: parts [[http://​www.gamasutra.com/​blogs/​DanCox/​20130209/​186341/​Learning_Twine_Part_2.php|2]] and [[http://​www.gamasutra.com/​blogs/​DanCox/​20130218/​186810/​Learning_Twine_Part_3.php|3]])  +
-  * The [[Twine Reference]] goes over all of Twine'​s features in detail. +
-  * [[Tutorial Videos ​and Screencasts]]  +
-==== Twine Index ====+
  
-Learn about these Twine terms:+[[tools|Tools and utilities]] 
 +</​WRAP>​ 
 +</​WRAP>​
  
-  * [[Passage]] - The text of your story +===== Twine 1 =====
-  * [[Syntax]] - Ways to style and format the text +
-  * [[Tag]] - Tag your passages +
-  * [[Link]] - From text to hypertext +
-  * [[Expression]] - A basic unit of code +
-  * [[Variable]] - Tracking the player'​s state +
-  * [[Function]] - Special, powerful expressions +
-  * [[Macro]] - Commands to program your stories with +
-  * [[Stylesheet]] - Style your story with CSS +
-  * [[Script]] - Extend Twine with Javascript +
-  * [[Image]] - Illustrate your story +
-  * [[Annotation]] - Notes inside your story'​s source code +
-==== Tips and Tricks ​====+
  
-  * See the [[Frequently Asked Questions]] page for common and valuable tips. +<WRAP group> 
-  * The [[Resources]] page curates a list of quality ​Twine development resources - custom macros, stylesheets,​ code references, and so forth. +<WRAP right 64%> 
-  * Visit the [[http://​twinery.org/​forum/​|Twine forum]] ​for additional help. +Twine 1 was the original version ​of Twine, and is still available to download ​for Windows and Mac.
-  * Finally, Twine programmer Leon has made a number of [[example files]] showcasing lesser used Twine features. +
-==== Publishing Your Work ====+
  
-Twine publishes to HTML, so you can place your stories on any web site. If you're looking for a place to publish for free, try one of these:+<WRAP group> 
 +<WRAP half column>​ 
 +==== Tutorials ====
  
 +  * [[http://​www.auntiepixelante.com/​twine/​|Anna Anthropy'​s introduction]]
 +  * [[http://​www.gamasutra.com/​blogs/​DanCox/​20130203/​185939/​Learning_Twine_Part_1.php|Dan Cox's Learning Twine blog series]]
 +  * [[http://​aliendovecote.com/​twine101|Online slides]] suitable for a presentation or workshop
 +  * [[example_files|Example files]] by Leon Arnott.
 +</​WRAP>​
 +<WRAP half column>
 +==== Reference Documentation ====
 +
 +  * [[twine1:​reference|Twine 1 Reference]]
 +  * [[twine1:​frequently_asked_questions|Frequently asked questions]]
 +  * [[twine1:​glossary|Glossary]]
 +  * [[twine1:​license_information|License information]]
 +  * [[twine1:​browser_support|Browser support]]
 +</​WRAP>​
 +</​WRAP>​
 +</​WRAP>​
 +<WRAP box 33%>
 +[[https://​twinery.org/​|Official download]]
 +
 +[[twine1:​release_notes|Release notes]]
 +
 +[[twine1:​known_bugs|Known bugs]]
 +
 +[[https://​github.com/​tweecode/​twine|Source code repository]]
 +
 +[[tools|Tools and utilities]]
 +</​WRAP>​
 +</​WRAP>​
 +
 +===== Story Formats =====
 +
 +Story formats are separate from the Twine editor, and determine the markup and code you use to write your stories. They allow you to add conditional logic, display effects, and other interactivity. ([[twine2:​how_to_choose_a_story_format|How do I decide which story format is right for me?]])
 +
 +<WRAP group>
 +<WRAP column half>
 +==== Harlowe ====
 +
 +Harlowe is the default story format for Twine 2. It isn't available in Twine 1, and features newer, different markup and macros from Twine 1's formats.
 +  * [[http://​twine2.neocities.org/​|Official documentation]]
 +  * [[https://​bitbucket.org/​_L_/​harlowe/​|Source repository and bug tracker]]
 +  * [[http://​furkleindustries.com/​fictions/​twine/​twine2_CSS_tutorial|How to change your story'​s appearance]]
 +  * [[https://​twinery.org/​forum/​index.php/​topic,​2571.msg8154.html#​msg8154|Notepad++ syntax mode]]
 +</​WRAP>​
 +
 +<WRAP column half>
 +==== SugarCube ====
 +
 +SugarCube is a popular format descended from Twine 1's default, Sugarcube. Twine 2 comes packaged with the latest in the SugarCube 1.x series, but there'​s also a 2.x series available that can be added manually.
 +  * [[http://​www.motoslave.net/​sugarcube/​1/​|1.x Official documentation]]
 +  * [[http://​www.motoslave.net/​sugarcube/​2/​|2.x Official documentation]]
 +  * [[https://​twinery.org/​forum/​index.php/​topic,​2670.msg8673.html#​msg8673|Notepad++ syntax mode]]
 +  * [[https://​bitbucket.org/​tmedwards/​sugarcube/​|Source code repository and bug tracker]]
 +</​WRAP>​
 +</​WRAP>​
 +<WRAP group>
 +<WRAP column half>
 +==== Snowman ====
 +
 +Snowman is a format intended for programmers who have experience with JavaScript development,​ particularly jQuery.
 +
 +  * [[https://​github.com/​klembot/​snowman|Official documentation]]
 +</​WRAP>​
 +<WRAP column half>
 +==== Other Formats ====
 +
 +  * [[http://​www.maximumverbosity.net/​twine/​Entweedle/​|Entweedle]] creates Twee source files from a story.
 +  * [[https://​mcdemarco.net/​tools/​entwee/​|Entwee]] exports a Twine 2 project as a Twee source file.
 +  * [[http://​www.maximumverbosity.net/​twine/​Illume/​|Illume]] is an improved proofing format.
 +  * [[https://​github.com/​massivedanger/​protagonist|Protagonist]] is similar to Snowman, but has more functionality built-in.
 +  * [[https://​longwelwind.github.io/​adventures/​|Adventures]] is a RPG related story format based on Snowman 2.
 +  * [[http://​www.mcdemarco.net/​tools/​scree/​paloma/​|Paloma]] is a Jonah like format format based on Snowman.
 +  * **Jonah** and **Sugarcane** are formats packaged with Twine 1. Sugarcane has been superceded by SugarCube, while there as yet no successor to Jonah. The main difference between the two is that when a reader clicks a link in Jonah, new text appears underneath the existing text, instead of replacing it.
 +
 +</​WRAP>​
 +</​WRAP>​
 +
 +===== Publishing Your Work =====
 +
 +Twine stories are published in HTML format, which means you can publish your files on any web server.
 +
 +<WRAP group>
 +<WRAP column half>
 +==== Free Twine Hosting ====
   * [[http://​www.philome.la|Philomela]]   * [[http://​www.philome.la|Philomela]]
   * [[https://​neocities.org|Neocities]]   * [[https://​neocities.org|Neocities]]
   * [[http://​adventurecow.com|Adventure Cow]]   * [[http://​adventurecow.com|Adventure Cow]]
 +</​WRAP>​
  
-Once you have a finished storyconsider:+<WRAP column half> 
 +==== After You've Published ==== 
 +  * [[http://​ifdb.tads.org|Add an entry on it on the IFDB]]\\ This will get your work in front of people curious about interactive fictionand will also cause it to appear on the twinery.org home page. 
 +  * [[http://​ifarchive.org|Upload it to the IF Archive]]\\ The pre-eminent archive of interactive fiction. 
 +  * [[http://​twitter.com/​twinethreads|Tweet a link to @twinethreads]]\\ We'll retweet you and help spread the word. 
 +</​WRAP>​ 
 +</​WRAP>​
  
-  * Adding ​an entry for it on [[http://ifdb.tads.org|IFDB]]. This will get your work in front of people curious about interactive fiction, and will also cause it to appear on the twinery.org ​home page. +<note tip> 
-  * Uploading an archived version to the [[http://ifarchive.org|IF Archive]]. +Couldn'​t find an answer to your question here? Try [[https://​twinery.org/​questions/|the Q&A]]. 
-  * Tweeting a link to [[http://​twitter.com/​twinethreads|@twinethreads]]-- we'll retweet you and help spread the word!+</note>
  
-//Because of spam, edits to the home page are restricted to specific users. If you'd like to make a change ​to this page, please ​request editing permission for this page by emailing ​wiki at twinery dot org.//+<note warning>​ 
 +Because of spam, self-serve user registration has been disabled. If you'd like to contribute ​to the wiki, please ​email wiki at twinery dot org with the user name you would like and a quick explanation of what you'd like to do on the wiki (so it's easier to filter out spam). 
 +</note>
start.1428882739.txt.gz · Last modified: 2017/10/09 20:38 (external edit)