24:null 25:["$","title",null,{"children":"RiScript and RiGrammar in Twine | John C | Observable"}] 2a:T426,md` 2️⃣ Paste the code below into the JavaScript window ${copiable(md`~~~js setup.JSLoaded = false; setup.lockID = LoadScreen.lock(); function parseObject (obj) { return Function('"use strict";return (' + obj + ')')(); } importScripts("https://unpkg.com/rita").then(function () { Macro.add('rg',{ skipArgs: false, tags: null, handler: function () { let s = this.payload[0].contents.trim(); let o; try { o = JSON.parse(s); } catch(e) { } if (!o) { try { o = parseObject(s); } catch { } } if (!o && /^\$[A-Za-z0-9$_]+$/.test(s)){ s = s.replace('$',''); o = State.variables[s] ? State.variables[s] : undefined; } if (!o) throw Error("fail to parse grammar, " + s + " is not a vaild object."); $(this.output).wiki(RiTa.grammar(o).expand(this.args[0],State.variables)); } }); setup.JSLoaded = true; Engine.play(passage(), true); LoadScreen.unlock(setup.lockID); }).catch(function (err) { alert(err); }); ~~~`)}`2b:[{"id":"cdc91815f0b018d2b06de99f3fd841e75c414657153138b18c2af3a8dbad1856e896150b30d9301c8c7fe629ba30d1575e38790330a6c60b23766cb90687f59d","href":"https://static.observableusercontent.com/files/cdc91815f0b018d2b06de99f3fd841e75c414657153138b18c2af3a8dbad1856e896150b30d9301c8c7fe629ba30d1575e38790330a6c60b23766cb90687f59d","name":"step1@1.png","type":"image/png","lastModified":1615049427420.958,"size":126945},{"id":"88f3d0328951c418f384e87bff3dcea51a8cbaf10f1307cb479f737317cd680858e0e1f1a4d2297ed5aad9e3b28fea0bcddaa8272e22a232965316fe757dff1d","href":"https://static.observableusercontent.com/files/88f3d0328951c418f384e87bff3dcea51a8cbaf10f1307cb479f737317cd680858e0e1f1a4d2297ed5aad9e3b28fea0bcddaa8272e22a232965316fe757dff1d","name":"step3.png","type":"image/png","lastModified":1615049427420.958,"size":75087},{"id":"f57552ec39280a844d73e850809945dd69ac14a87817318d350a20f34345eaddabdd0c1436369189894e4590688658aed64eeef6a771f0fb4d0aaf3882bab851","href":"https://static.observableusercontent.com/files/f57552ec39280a844d73e850809945dd69ac14a87817318d350a20f34345eaddabdd0c1436369189894e4590688658aed64eeef6a771f0fb4d0aaf3882bab851","name":"example.png","type":"image/png","lastModified":1616506131920.515,"size":83423},{"id":"001345fbaec6df07369e2f74252c6c101d1e1b04ebe9dfd059212b6f96c18ddb9a6d72ea493b4279e5262791a5900454e130c2059cc645cae5b27053b9b5ee2c","href":"https://static.observableusercontent.com/files/001345fbaec6df07369e2f74252c6c101d1e1b04ebe9dfd059212b6f96c18ddb9a6d72ea493b4279e5262791a5900454e130c2059cc645cae5b27053b9b5ee2c","name":"output.png","type":"image/png","lastModified":1616506142292.618,"size":61510},{"id":"47cddbef800e987167cffb1f920358e77dd315421b0ab254c2f453179447e149bb94205f814ae1dbd7fe093282149ff61060383bf7c84058974ac2900bb1a4bf","href":"https://static.observableusercontent.com/files/47cddbef800e987167cffb1f920358e77dd315421b0ab254c2f453179447e149bb94205f814ae1dbd7fe093282149ff61060383bf7c84058974ac2900bb1a4bf","name":"rgoutput.png","type":"image/png","lastModified":1615135986726.557,"size":121330},{"id":"bd22271406751f934b7caf72493c9e52d5d5ed619a5c7132c2e7c6f4a9f11a825ec83d005509acbe1f6af9fefcc3b1cdd33ac6e025c40dc44f1772234836792e","href":"https://static.observableusercontent.com/files/bd22271406751f934b7caf72493c9e52d5d5ed619a5c7132c2e7c6f4a9f11a825ec83d005509acbe1f6af9fefcc3b1cdd33ac6e025c40dc44f1772234836792e","name":"rgexam@1.png","type":"image/png","lastModified":1615304862981.362,"size":198008}] 28:{"id":"61eb92d1b0fd0e6e","slug":"riscript-and-rigrammar-in-twine","title":"RiScript and RiGrammar in Twine","thumbnail":"a735941e14d71490b81a5b0063391b5caccdace78d2576da2d2799dba0c1e5f0","access_level":"public","create_time":"$D2021-03-06T16:50:27.420Z","update_time":"$D2023-10-31T14:54:15.662Z","view_time":null,"first_public_time":"$D2021-03-06T17:09:29.600Z","fork":{"id":"b504089548cde066","slug":"rita-in-twine","title":"RiTa with Twine","owner":{"id":"636cf123a07db681","login":"dhowe","name":"Daniel Howe"}},"stars":2,"starred":false,"owner":{"type":"team","id":"b2e9840be7b1b607","login":"real-john-cheung","name":"John C","avatar_url":"https://avatars-next.observableusercontent.com/1d9ef6121a0bbd1a75fab479f9891fe1d78cc65f76c394585ae1a7dad0d3abf6","tier":"starter_2024"},"version":250,"publish_version":null,"role":null,"authored":false,"authors":[{"type":"individual","id":"e8e99acdbe3aebfb","login":"real-john-cheung","name":"John C","avatar_url":"https://avatars-next.observableusercontent.com/1d9ef6121a0bbd1a75fab479f9891fe1d78cc65f76c394585ae1a7dad0d3abf6","tier":null}],"members":[{"type":"individual","id":"e8e99acdbe3aebfb","login":"real-john-cheung","name":"John C","avatar_url":"https://avatars-next.observableusercontent.com/1d9ef6121a0bbd1a75fab479f9891fe1d78cc65f76c394585ae1a7dad0d3abf6","tier":null,"role":"editor"}],"comments":[{"id":"ea02577f6f4f3281","reply_to_id":null,"content":"Why JSON rather than a simple JS object ?\n\nWhat is the most twine/sugarcube way to write a grammar of keys and values ?","create_time":"$D2021-03-06T22:07:48.503Z","update_time":"$D2021-03-06T22:08:45.217Z","resolved":false,"user":{"type":"individual","id":"32869872eb6f2f82","login":"dhowe","name":"Daniel Howe","avatar_url":"https://avatars-next.observableusercontent.com/a5081aaa56ae9990aa27642040dc61de3ce8cea67f6f778a5b864e41111ba7a3","tier":null}},{"id":"4a4701ae727bfa1d","reply_to_id":"ea02577f6f4f3281","content":"Perhaps by <>ing a list of key-values...\n\nFor example, this works:\n\n<>\n\n<<= RiTa.grammar($rules).expand()>>","create_time":"$D2021-03-06T22:28:19.847Z","update_time":null,"resolved":false,"user":{"type":"individual","id":"32869872eb6f2f82","login":"dhowe","name":"Daniel Howe","avatar_url":"https://avatars-next.observableusercontent.com/a5081aaa56ae9990aa27642040dc61de3ce8cea67f6f778a5b864e41111ba7a3","tier":null}},{"id":"75582845dae208f5","reply_to_id":null,"content":"I wonder if the <> tag might still be useful - what do you think?","create_time":"$D2021-03-07T16:54:51.925Z","update_time":null,"resolved":false,"user":{"type":"individual","id":"32869872eb6f2f82","login":"dhowe","name":"Daniel Howe","avatar_url":"https://avatars-next.observableusercontent.com/a5081aaa56ae9990aa27642040dc61de3ce8cea67f6f778a5b864e41111ba7a3","tier":null}},{"id":"e6763a95f4a70229","reply_to_id":"ea02577f6f4f3281","content":"this's cool, but seems that the set value can't be put in the content like this:\n<>\n$rules\n<>\nI have made a little change for the macro to be able to take in JSON object, js object and also set value (need to be pass in args)","create_time":"$D2021-03-07T16:56:25.497Z","update_time":null,"resolved":false,"user":{"type":"individual","id":"e8e99acdbe3aebfb","login":"real-john-cheung","name":"John C","avatar_url":"https://avatars-next.observableusercontent.com/1d9ef6121a0bbd1a75fab479f9891fe1d78cc65f76c394585ae1a7dad0d3abf6","tier":null}},{"id":"421750091b44dc95","reply_to_id":"ea02577f6f4f3281","content":"Interesting -- I wonder what the most user-friendly option is...\n\nThe other thing that would be nice is to pass the Twine context to RiTa.grammar so that Twine-declared variables can be used inside the grammar","create_time":"$D2021-03-07T17:01:54.070Z","update_time":"$D2021-03-07T17:03:16.542Z","resolved":false,"user":{"type":"individual","id":"32869872eb6f2f82","login":"dhowe","name":"Daniel Howe","avatar_url":"https://avatars-next.observableusercontent.com/a5081aaa56ae9990aa27642040dc61de3ce8cea67f6f778a5b864e41111ba7a3","tier":null}},{"id":"272bb28f616b21f4","reply_to_id":"75582845dae208f5","content":"hmm personally I think yes, I would use it like this in my work\n<>\n{\n ...rules\n}\n<>\n\nI think for me this is a better way to organise text, and I don't need to use dynamic symbols (just a personal preference)","create_time":"$D2021-03-07T17:08:24.636Z","update_time":null,"resolved":false,"user":{"type":"individual","id":"e8e99acdbe3aebfb","login":"real-john-cheung","name":"John C","avatar_url":"https://avatars-next.observableusercontent.com/1d9ef6121a0bbd1a75fab479f9891fe1d78cc65f76c394585ae1a7dad0d3abf6","tier":null}},{"id":"dbeaebce06b8bab6","reply_to_id":"ea02577f6f4f3281","content":"yeah that will be nice, would look into it later","create_time":"$D2021-03-07T17:08:50.477Z","update_time":null,"resolved":false,"user":{"type":"individual","id":"e8e99acdbe3aebfb","login":"real-john-cheung","name":"John C","avatar_url":"https://avatars-next.observableusercontent.com/1d9ef6121a0bbd1a75fab479f9891fe1d78cc65f76c394585ae1a7dad0d3abf6","tier":null}},{"id":"09485328798c3b75","reply_to_id":"ea02577f6f4f3281","content":"Can do this with State.variables (see https://observablehq.com/@dhowe/rita-in-twine#jscode)\n\nIn your code above, why put the optional variable first?","create_time":"$D2021-03-09T11:30:43.931Z","update_time":"$D2021-03-09T11:32:19.629Z","resolved":false,"user":{"type":"individual","id":"32869872eb6f2f82","login":"dhowe","name":"Daniel Howe","avatar_url":"https://avatars-next.observableusercontent.com/a5081aaa56ae9990aa27642040dc61de3ce8cea67f6f778a5b864e41111ba7a3","tier":null}},{"id":"8c6a3dce12cc525f","reply_to_id":"ea02577f6f4f3281","content":"hmm, actually the parameters are all optional (can use<>{grammar}<>), but you are right, <> makes more sense.","create_time":"$D2021-03-09T15:42:08.686Z","update_time":null,"resolved":false,"user":{"type":"individual","id":"e8e99acdbe3aebfb","login":"real-john-cheung","name":"John C","avatar_url":"https://avatars-next.observableusercontent.com/1d9ef6121a0bbd1a75fab479f9891fe1d78cc65f76c394585ae1a7dad0d3abf6","tier":null}}],"custom_thumbnail":false,"trashed":false,"subscribed":null,"forks":2,"collection":{"id":"aac27ce630a2ebd4","slug":"posts","title":"Posts","owner":{"id":"b2e9840be7b1b607","login":"real-john-cheung","name":"John C"}},"type":"notebook","body":{"title":"RiScript and RiGrammar in Twine","cells":[{"id":162,"value":"md`# RiScript and RiGrammar in Twine\n\nHere's a quick script to enable [RiScript](./riscript) and [RiGrammar](../@real-john-cheung/generating-with-rita-grammars) tags in your [Twine](http://twinery.org/) story.\n\n\n*This notebook assumes you're using [SugarCube 2.x](https://www.motoslave.net/sugarcube/2/) as your Twine 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. For more info about RiGrammar, check [this](../@real-john-cheung/generating-with-rita-grammars) tutorial. Props to [@real-john-cheung](https://observablehq.com/@real-john-cheung) for the initial implementation!*\n\n

\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":0,"value":"md`
\n## RiScript\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":"md`\n2️⃣ Paste the code below into the JavaScript window\n\n${copiable(md`~~~js\nsetup.JSLoaded = false;\nsetup.lockID = LoadScreen.lock();\nimportScripts(\"https://unpkg.com/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 (ex) {\n return this.error(\\`RiScript error: \\${typeof ex === 'object' ? ex.message : ex}\\`);\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~~~`)}\n`","pinned":false,"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

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

`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":187,"value":"$2a","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":193,"value":"md`\n\n3️⃣ Close it and use the \\`<>...<>\\` macro in your passages as below 💡 \n\n

\n
And the output looks like this\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":215,"value":"html``","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"}],"files":"$W2b","stdlib":"1","titling":"auto"}} 29:"$28:body"