~~NOTOC~~
===== Twine 2=====

<WRAP group>
<WRAP right 64%>

Twine 2 is the most recent release series of Twine. If you've never used Twine before, this version is recommended.

<WRAP group>
<WRAP half column>
==== Tutorials ====

  * [[http://catn.decontextualize.com/twine/|Tutorial by Allison Parrish]]
  * [[twine2:videos|Dan Cox's Twine 2 Videos]]
</WRAP>
<WRAP half column>
==== Reference Documentation ====

  * [[twine2:guide|Twine 2 Guide]]
  * [[harlowe:reference|Harlowe reference]]
</WRAP>
</WRAP>
</WRAP>
<WRAP box 33%>
[[https://twinery.org|Official download]]

[[https://twinery.org/2|Use online]]

[[https://bitbucket.org/klembot/twinejs/downloads|Download local web version]]

[[twine2:release_notes|Release notes]]

[[https://github.com/klembot/twinejs|Source repository and bug tracker]]

[[tools|Tools and utilities]]
</WRAP>
</WRAP>

===== Twine 1 =====

<WRAP group>
<WRAP right 64%>
Twine 1 was the original version of Twine, and is still available to download for Windows and Mac.

<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://videlais.github.io/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]]
  * [[https://neocities.org|Neocities]]
  * [[http://adventurecow.com|Adventure Cow]]
  * [[https://itch.io|Itch.io]]
</WRAP>

<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 fiction, and 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>

<note tip>
Couldn't find an answer to your question here? Try [[https://twinery.org/questions/|the Q&A]].
</note>

<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>