2b:null 2c:["$","title",null,{"children":"RiTa with Twine | Daniel Howe | Observable"}] 31:[{"id":"8c1aa873846e96d0b6fb924babf18456a75bbb9a63c46aff56a13f67bf58167d20dd64ce1286951340a93f07ed2bc263246e701098f4c955d0799607fa9eae57","href":"https://static.observableusercontent.com/files/8c1aa873846e96d0b6fb924babf18456a75bbb9a63c46aff56a13f67bf58167d20dd64ce1286951340a93f07ed2bc263246e701098f4c955d0799607fa9eae57","name":"twirk.png","type":"image/png","lastModified":1615070941778.861,"size":306289},{"id":"cdc91815f0b018d2b06de99f3fd841e75c414657153138b18c2af3a8dbad1856e896150b30d9301c8c7fe629ba30d1575e38790330a6c60b23766cb90687f59d","href":"https://static.observableusercontent.com/files/cdc91815f0b018d2b06de99f3fd841e75c414657153138b18c2af3a8dbad1856e896150b30d9301c8c7fe629ba30d1575e38790330a6c60b23766cb90687f59d","name":"step1@1.png","type":"image/png","lastModified":1615036331763.492,"size":126945}] 2f:{"id":"b504089548cde066","slug":"rita-in-twine","title":"RiTa with Twine","thumbnail":"74c679384d9a4c3436d637b3f83ae0bfeefbe72e4149d57e41fbd1cd1bf88e7b","access_level":"public","create_time":"$D2021-03-06T12:48:22.087Z","update_time":"$D2025-03-20T14:51:21.574Z","view_time":null,"first_public_time":"$D2021-03-06T13:39:26.797Z","fork":false,"stars":3,"starred":false,"owner":{"type":"team","id":"636cf123a07db681","login":"dhowe","name":"Daniel Howe","avatar_url":"https://avatars-next.observableusercontent.com/a5081aaa56ae9990aa27642040dc61de3ce8cea67f6f778a5b864e41111ba7a3","tier":"starter_2024"},"version":307,"publish_version":null,"role":null,"authored":false,"authors":[{"type":"individual","id":"32869872eb6f2f82","login":"dhowe","name":"Daniel Howe","avatar_url":"https://avatars-next.observableusercontent.com/a5081aaa56ae9990aa27642040dc61de3ce8cea67f6f778a5b864e41111ba7a3","tier":null}],"members":[{"type":"individual","id":"32869872eb6f2f82","login":"dhowe","name":"Daniel Howe","avatar_url":"https://avatars-next.observableusercontent.com/a5081aaa56ae9990aa27642040dc61de3ce8cea67f6f778a5b864e41111ba7a3","tier":null,"role":"editor"}],"comments":[],"custom_thumbnail":true,"trashed":false,"subscribed":null,"forks":5,"collection":{"id":"3c04483074fcc200","slug":"rita","title":"RiTa","owner":{"id":"636cf123a07db681","login":"dhowe","name":"Daniel Howe"}},"type":"notebook","body":{"title":"RiTa with Twine","cells":[{"id":162,"value":"md`# RiTa with Twine\n\nHere's a quick hack to enable [RiTa](https://rednoise.org/rita), [RiGrammar](./tut-rita-grammars) and [RiScript](./riscript) tags in your [Twine](http://twinery.org/) stories. It enables you to call RiTa functions from within Twine, including running grammars, and also provides the <<rs>> macro for writing RiScript directly within Twine passages.\n\n

This notebook assumes you're using [SugarCube 2.x](https://www.motoslave.net/sugarcube/2/) as your Twine 2 story format. If you need an introduction to Twine/Sugarcube, try this [excellent tutorial](http://catn.decontextualize.com/twine/) by Allison Parrish. If you're not familiar with RiScript, check [this notebook](./riscript) first. Props to [@real-john-cheung](https://observablehq.com/@real-john-cheung) for the initial implementation!

\n\n${html`

\n ${await FileAttachment(\"twirk.png\").image()}\n

RiScript and RiGrammar in a Twine passage

\n`}\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":0,"value":"md`
\n## Quick Setup\n
\n1️⃣ Create/open your Twine story and select \"Edit Story JavaScript\" \n\n

\n`\n","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":142,"value":"jscode=md`\n2️⃣ Paste the code below into the JavaScript window\n\n${copiable(md`~~~js\nsetup.JSLoaded = false;\nsetup.lockID = LoadScreen.lock();\nimportScripts(\"https://cdn.jsdelivr.net/npm/rita\").then(function () {\n Macro.add('rs', {\n skipArgs: true,\n tags: null,\n handler: function () {\n try {\n $(this.output).wiki(RiTa.evaluate(this.payload[0].contents, State.variables));\n }\n catch (e) {\n return this.error(\\`RiScript error: \\${typeof e === 'object' ? e.message : e}\\`);\n }\n }\n });\n setup.JSLoaded = true;\n Engine.play(passage(), true);\n LoadScreen.unlock(setup.lockID);\n}).catch(function (err) {\n alert(err);\n});\n\n~~~`)}`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":274,"value":"","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":149,"value":"md`\n\n3️⃣ Close it and use the \\`<>...<>\\` macro in your passages as below 💡 \n\n${html`

\n ${await FileAttachment(\"twirk.png\").image()}\n

RiScript and RiGrammar in a Twine passage

\n`}\n\n------------\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":283,"value":"html`\n

Related Resources

The RiTa reference in observable
The RiTa website: examples, docs, gallery, etc.
A tutorial on RiScript, RiTa's micro scripting language
Tools for RiTa in observable, including the rs template
Generating with RiTa grammars and Markov chains
RiTa's Lexicon and Letter-to-Sound engine

\n\n\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":73,"value":"md`-----------\n## Appendix\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":75,"value":"import {copiable, style} from \"@tmcw/copiable\"\n","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":83,"value":"style","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":238,"value":"html``","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"}],"files":"$W31","stdlib":"1","titling":"auto"}} 30:"$2f:body"