Merge pull request #3 from manonamora/edits

did some fixes see update log

Base/base.tw

@@ -37,19 +37,21 @@ SugarCube Guide
 	[[Update Log]]<</if>>
 
 :: StorySubtitle {"position":"2300,300","size":"100,100"}
-<<if tags().includes("sp-demo")>>The bestest of guides!<<else>>Version 1.2.0<</if>>
+<<if tags().includes("sp-demo")>>The bestest of guides!<<else>>Version 1.2.1<</if>>
 
 :: PassageFooter {"position":"2000,200","size":"100,100"}
 <<if tags().includes("sp-demo")>><hr>The Footer in action! included in a horizontal bar<<else>><hr>
-	<center><<link "Lexicon">><<popup 'Lexicon' "Lexicon">><</link>> - [[Index]] - [[Macros List]] - <<link "Credits">><<popup "Credits" "Credits">><</link>> - [[Need More Help?|https://manonamora-if.tumblr.com/ask]]</center>
+	<center><<link "Lexicon">><<popup 'Lexicon' "Lexicon">><</link>> - [[Pages Index|Index]]
+  [[Macros List]] - [[Function/Method List]] - [[API List]]
+  <<link "Credits">><<popup "Credits" "Credits">><</link>> - [[Need More Help?|https://manonamora-if.tumblr.com/ask]]</center>
 <</if>>
 
 :: PassageHeader {"position":"1900,200","size":"100,100"}
 <<if tags().includes("sp-demo")>>The Header in action! included in a horizontal bar<hr><</if>>
 
 
 :: Start [noreturn menu] {"position":"1500,100","size":"200,200"}
-<div style="text-align:right;font-size:85%;">Last Updated: 10 Dec '23</div>
+<div style="text-align:right;font-size:85%;">Last Updated: 24 Jan '24</div>
 <h1>100% Good Twine SugarCube Guide</h1>\
 This guide was created as an ''alternative'' to the SugarCube documentation, including simpler explanations to the macros and with clearer examples when possible. It is meant to make the SugarCube format more accessible to new and learning users.
 
@@ -64,45 +66,45 @@ Knowledge of CSS, JavaScript/jQuery may be required for more complex elements.
 
 > ''The Basics''
 * [[About Twine and SugarCube|About]]
-* [[Starting with SugarCube|Basics]] [ ★ UPDATE ★ ]
+* [[Starting with SugarCube|Basics]] 
 \
 > ''The Basics+''
-* [[SugarCube Markup and Basic Styling|Markup]] [ ★ UPDATE ★ ]
-* [[Going Further with the Basics|Macro-Basic]] [ ★ UPDATE ★ ]
-* [[Adding some Interactivity|Macro-Interact]] [ ★ UPDATE ★ ]
-* [[Basic Special Passages|Special-Passage]] [ ★ UPDATE ★ ]
-* [[About JavaScript and the StyleSheet|Base-JS-CSS]] [ ★ UPDATE ★ ]
-* [[ULRs for Assets and Testing|URL-Types]] [ ★ UPDATE ★ ]
+* [[SugarCube Markup and Basic Styling|Markup]] 
+* [[Going Further with the Basics|Macro-Basic]] 
+* [[Adding some Interactivity|Macro-Interact]] 
+* [[Basic Special Passages|Special-Passage]] 
+* [[About JavaScript and the StyleSheet|Base-JS-CSS]] 
+* [[ULRs for Assets and Testing|URL-Types]] 
 \
 > ''Intermediate Use''
-* [[More SugarCube Markup|Markup-Int]] [ ★ NEW ★ ]
-* [[More Interactivity Macros|Macro-Interact-Adv]] [ ★ UPDATE ★ ]
-* [[Macros of Convenience|Macro-Conv]] [ ★ UPDATE ★ ]
-* [[More Special Passages and Tags|Special-Tags]] [ ★ UPDATE ★ ]
-* [[Harness the Power of Functions|Functions]] [ ★ UPDATE ★ ]
+* [[More SugarCube Markup|Markup-Int]] 
+* [[More Interactivity Macros|Macro-Interact-Adv]] 
+* [[Macros of Convenience|Macro-Conv]] 
+* [[More Special Passages and Tags|Special-Tags]] 
+* [[Harness the Power of Functions|Functions]] 
 * [[Using Methods to change Variables|Methods]] 
 * [[Adding Sound with the Audio Macros|Macro-Audio]]
-* [[Going further in Styling with CSS and JavaScript|Int-JS-CSS]] [ ★ UPDATE ★ ]
-* [[Some Useful Basic APIs|Basic-API]] [ ★ UPDATE ★ ]
+* [[Going further in Styling with CSS and JavaScript|Int-JS-CSS]] 
+* [[Some Useful Basic APIs|Basic-API]] 
 * [[Edit the Built-In Text or Change the Game's Language|Localization]]
 \
 > ''Advanced Mode''
 > ''Note:'' Many of the elements included in the following chapters will require knowledge of JavaScript, jQuery, and understanding of the core processed of SugarCube.
 * [[Advanced Macros|Macro-Adv]]
-* [[More Variable and Interaction Methods|Methods-Adv]] [ ★ NEW ★ ]
-* [[Going Further with Basic APIs and More|API-Adv]] [ ★ NEW ★ ]
-* [[The Settings APIs|Settings]] [ ★ NEW ★ ]
-* [[The Save APIs and Further Saving Configurations|SaveAPI]] [ ★ NEW ★ ]
+* [[More Variable and Interaction Methods|Methods-Adv]] 
+* [[Going Further with Basic APIs and More|API-Adv]] 
+* [[The Settings APIs|Settings]] 
+* [[The Save APIs and Further Saving Configurations|SaveAPI]] 
 * [[Going Further with the Engine API|Engine-API]]
-* [[More Configuration APIs to Customise Interaction|Config-API]] [ ★ NEW ★ ]
-* [[Getting the FullScreen Experience|FullScreen]] [ ★ NEW ★ ]
-* [[Trigger Code with Special Events|Events]] [ ★ UPDATE ★ ]
-* [[Creating your Own Macro|Macro]] [ ★ NEW ★ ]
-* [[Managing Story Elements with APIs|StoryAPI]] [ ★ NEW ★ ]
-* [[Managing Passage Properties with APIs|PassageAPI]] [ ★ NEW ★ ]
-* [[Dealing with the State of Play|StateAPI]] [ ★ NEW ★ ]
+* [[More Configuration APIs to Customise Interaction|Config-API]] 
+* [[Getting the FullScreen Experience|FullScreen]] 
+* [[Trigger Code with Special Events|Events]] 
+* [[Creating your Own Macro|Macro]] 
+* [[Managing Story Elements with APIs|StoryAPI]] 
+* [[Managing Passage Properties with APIs|PassageAPI]] 
+* [[Dealing with the State of Play|StateAPI]] 
 /*
- -> to finish
+[ ★ UPDATE ★ ] - [ ★ NEW ★ ]
 * Key Binding - An Alternative|KeyBinding HIEV SETTING TO FIX
 */
 

Pages-1-Basics/Basics+-Interact.tw

@@ -3,10 +3,10 @@
 Aside from links, there are other macros to make your project a bit more interactive. SugarCube is built with multiple that can help add different kinds of gameplay elements. The macros mentioned in the pages listed below are quite useful for character creation, including puzzles, or even a combat system!
 \
 * [[Multi or Single Option Choices|Macro-CheckRadio]]
-* [[Cycles and Conditional Options|Macro-Cycle]] [ ★ UPDATE ★ ]
+* [[Cycles and Conditional Options|Macro-Cycle]] 
 ** [[Make the Cycle Macro Accessible|Accessibility-Cycle]]
 * [[Revealing Extra Text and Disappearing Links|Macro-Link-AppPreRep]]
-* [[Listboxes and Conditional Options|Macro-Listbox]] [ ★ UPDATE ★ ]
+* [[Listboxes and Conditional Options|Macro-Listbox]] 
 * [[Player Input in three macros|Macro-Input]]
 \
 > ''Note:'' For a concrete example of interactive character creator, see the [[Character Creator Template|https://manonamora.itch.io/twine-sugarcube-templates]].

Pages-1-Basics/Basics+-Macro.tw

@@ -2,10 +2,10 @@
 <h1>Going Further with the Basics</h1>
 After [[linking passages|Macro-Link-Basic]], [[setting variables|Macro-Set-Basic]], and creating some simple [[conditional statements|Macro-If-Basic]], you would have the basis required to make a textual game. You can add onto this base, with more complex use of those macros, as well as including a few more related ones. This chapter is meant to expand the use of the basic macros.
 
-* [[Displaying more than text in Links|Macro-Link]] [ ★ UPDATE ★ ] 
+* [[Displaying more than text in Links|Macro-Link]]  
 * [[Setting and Changing Variables|Macro-Set]]
-* [[Unsetting Variables|Macro-Unset]] [ ★ UPDATE ★ ] 
-* [[More Conditional Statements|Macro-If]]  [ ★ UPDATE ★ ] 
+* [[Unsetting Variables|Macro-Unset]]  
+* [[More Conditional Statements|Macro-If]]   
 * [[Display Variables, the Print Macro and Variants|Macro-Print]]
 
 <div id="link-menu">[[Back to the Start Menu|Start]]</div>

Pages-1-Basics/Basics+-Markup.tw

@@ -3,13 +3,12 @@
 Whether to format text or code in a specific way, SugarCube includes some special markup code, separate from HTML and macros. The ones mentioned in the listed pages below would be most relevant to basic and starting projects. For more advanced Markup, see [[this page|Markup-Int]].
 
 * [[Showing the Value of a Variable|Markup-Variable]]
-* [[Using a Variable inside a Link|Markup-Link]] [ ★ UPDATE ★ ]
-* [[Display an Image, and turn an Image into a Link|Markup-Image]] [ ★ UPDATE ★ ] /*Have examples here for the image! */
+* [[Using a Variable inside a Link|Markup-Link]] 
+* [[Display an Image, and turn an Image into a Link|Markup-Image]]s
 * [[Removing a Line-break|Markup-Nobr]] (Empty space on the page)
-* [[Basic Text Styling|Markup-Styling]] (long) [ ★ UPDATE ★ ]
+* [[Basic Text Styling|Markup-Styling]] (long) 
 
 <div id="link-menu">[[Back to the Start Menu|Start]]</div>
-TODO!!! See Comment
 
 :: Markup-Variable [page] {"position":"800,700","size":"100,100"}
 <h1>Showing the Value of a Variable</h1>
@@ -86,7 +85,8 @@ The URL of the image can also be stored inside a variable. Assuming that {{{$url
 [img[garden.png]]
 }}}
 
-You can also turn the image into a clickable one, sending the player to another passage, like you would have with the [[Link Markup|Markup-Link]].
+You can also turn the image into a clickable one, sending the player to another passage, like you would have with the [[Link Markup|Markup-Link]]. For example, the image below will send you to the Wikipedia website:
+[img[https://upload.wikimedia.org/wikipedia/en/8/80/Wikipedia-logo-v2.svg][https://en.wikipedia.org/wiki/Main_Page]]
 {{{
     [img[URL][PASSAGE]]
 }}}
@@ -96,7 +96,6 @@ You can also turn the image into a clickable one, sending the player to another
     → will work the same way as
 [img[garden.png][Garden]]
 }}}
-
 You can go even further and set a variable inside that Image Link:
 {{{[img[URL][PASSAGE][$var to true]]}}}
 

Pages-1-Basics/Basics+-SP.tw

@@ -6,8 +6,8 @@ To use a Special Passage, create a new passage, change the name of that passage
 > ''Note:'' the names are case-sensitive!
 \
 * [[Headers and Footers|SP-HeaderFooter]]
-* [[Special Passages for the UI Bar|SP-UIBar]] [ ★ UPDATE ★ ]
-* [[Setting Important Variables before Start|SP-Init]] [ ★ UPDATE ★ ]
+* [[Special Passages for the UI Bar|SP-UIBar]] 
+* [[Setting Important Variables before Start|SP-Init]] 
 
 You can click [[here for the demo|SP-Demo]] to see most of the aforementioned Special Passages in action!
 

Pages-1-Basics/Basics.tw

@@ -27,8 +27,8 @@ To do this, you essentially need the 3 following macros: {{{<<link>>}}}, {{{<<se
 
 * [[The Basics of Variables|Variables-Base]]
 * [[The Elements on the Page|Basics-UI]]
-* [[Linking Passages|Macro-Link-Basic]] [ ★ UPDATE ★ ]
-* [[Tracking Information|Macro-Set-Basic]] [ ★ UPDATE ★ ]
+* [[Linking Passages|Macro-Link-Basic]] 
+* [[Tracking Information|Macro-Set-Basic]] 
 * [[Display Variation|Macro-If-Basic]]
 > ''Note:'' Any code on the page will be displayed top to bottom by the program. Code at the top of the passage can affect code further down.
 

Pages-2-Intermediate/API-Adv.tw

@@ -4,10 +4,10 @@ While most of the Basic API were listed [[here|Basic-API]], this chapter will co
 
 Those APIs are JavaScript-based code that should either be included in the JavaScript or within the {{{<<run>>}}} or {{{<<script>>}}} macros to work.
 
-* [[More Popups APIs|API-Dialog]] [ ★ NEW ★ ]
-* [[More UIBar APIs|API-UIBar]] [ ★ NEW ★ ]
-* [[The Template APIs|TemplateAPI]] [ ★ NEW ★ ]
-* [[(Un)Locking the Loading Screen|API-Lock]] [ ★ NEW ★ ]
+* [[More Popups APIs|API-Dialog]] 
+* [[More UIBar APIs|API-UIBar]] 
+* [[The Template APIs|TemplateAPI]] 
+* [[(Un)Locking the Loading Screen|API-Lock]] 
 
 <div id="link-menu">[[Back to the Start Menu|Start]]</div>
 
@@ -187,10 +187,10 @@ This API can tell how many templates exist within the code.
     }
 }}}
 \
-<h4>{{{Template.had()}}}</h4>\
+<h4>{{{Template.has()}}}</h4>\
 This API will check whether a template, for which you need to indicate the name, exists within the code.
 {{{
-    Template.had()
+    Template.has()
 
     if (Template.has('sunrise')) {
 	    /* if ?sunrise is defined, run code */

Pages-2-Intermediate/Basic-API.tw

@@ -5,9 +5,9 @@ Along with macros, there are further APIs to trigger an event in the game, such
 Those APIs are JavaScript-based code that should either be included in the JavaScript or within the {{{<<run>>}}} or {{{<<script>>}}} macros to work.
 
 * [[Moving back and forth in the History|Basic-API-Engine]]
-* [[Create a PopUp|Basic-API-Dialog]] [ ★ UPDATE ★ ]
+* [[Create a PopUp|Basic-API-Dialog]] 
 * [[Handle the SideBar|Basic-API-UIBar]]
-* [[Open the JumpTo, Restart, Saves, and Settings PopUp|Basic-API-UI]] [ ★ UPDATE ★ ]
+* [[Open the JumpTo, Restart, Saves, and Settings PopUp|Basic-API-UI]] 
 * [[Overriding the Navigation to a Passage|Basic-Config-Navig]]
 * [[Some Useful Configuration API for your Project|Basic-API-Config]]
 

Pages-2-Intermediate/Functions.tw

@@ -3,7 +3,7 @@
 Functions are JavaScript blocks of code designed to do a specific task, from importing outside scripts, to save information, or setting variables. While some of the functions explained in this chapter can be used in any passage in combination with SugarCube macros, some should be restricted to the JavaScript passage only.
 
 * [[Cloning Variables, and Random Values Functions|Function-Clone-Random]]
-* [[Using Play, Passage, and Tags information|Function-Pass-Tag]]  [ ★ UPDATE ★ ]
+* [[Using Play, Passage, and Tags information|Function-Pass-Tag]]  
 * [[Memorizing Information and Metadata|Function-Metadata]]
 * [[JavaScript-only Functions|Function-JS]]
 

Pages-2-Intermediate/Int-JS-CSS.tw

@@ -4,16 +4,16 @@ When wanting to change how a page looks or behave, you will need to edit either
 
 While editing the StyleSheet, you may find the Inspect Tool of your browser to be a useful thing. From testing for different screen sizes and accessibility, to view the source code (HTML/CSS) of the displayed passage, or even messing with the CSS rules without going back and forth between the StyleSheet and the file, the tool will let you ensure a great visual for your project.
 
-* [[The Different Targetable Elements|Int-JS-CSS-Elements]] [ ★ UPDATE ★ ]
-** [[The Full List of Targetable Elements|HTML-Full-List]] [ ★ NEW ★ ]
+* [[The Different Targetable Elements|Int-JS-CSS-Elements]] 
+** [[The Full List of Targetable Elements|HTML-Full-List]] 
 * [[Ensuring that Elements Start at the Top when Opened|Int-JS-CSS-Events]]
-* [[Import and Change the Font|Int-JS-CSS-Font]] [ ★ UPDATE ★ ]
-* [[Using the Root and CSS var|Int-JS-CSS-Root]] [ ★ UPDATE ★ ]
-* [[Formating for Different Screen Size|Int-JS-CSS-Media]] [ ★ UPDATE ★ ]
+* [[Import and Change the Font|Int-JS-CSS-Font]] 
+* [[Using the Root and CSS var|Int-JS-CSS-Root]] 
+* [[Formating for Different Screen Size|Int-JS-CSS-Media]] 
 * [[Intro to Animation|Int-JS-CSS-Animation]]
-* [[Creating Stats, Meter, and Progress Bars|Int-JS-CSS-Stat]] (long) [ ★ NEW ★ ]
-* [[Editing the Loading Screen|Int-JS-CSS-LoadingScreen]] [ ★ NEW ★ ]
-* [[A Note on Interface Accessibility|Accessibility]] [ ★ NEW ★ ]
+* [[Creating Stats, Meter, and Progress Bars|Int-JS-CSS-Stat]] (long) 
+* [[Editing the Loading Screen|Int-JS-CSS-LoadingScreen]] 
+* [[A Note on Interface Accessibility|Accessibility]] 
 
 <div id="link-menu">[[Back to the Start Menu|Start]]</div>
 

Pages-2-Intermediate/Interact-Adv.tw

@@ -2,10 +2,10 @@
 <h1>More Interactivity Macros</h1>
 While a previous chapter touched upon the [[Base Interactive Macros|Macro-Interact]], SugarCube also includes more intermediate interactive macros. These will give the project a different kind of interactivity, or more flexibility in said interactivity.
 
-* [[DOM Macros and Revealing Text in Targeted Spots|Macro-ApPreRepCopy]] [ ★ UPDATE ★ ]
+* [[DOM Macros and Revealing Text in Targeted Spots|Macro-ApPreRepCopy]] 
 * [[Single-Use Choice Lists|Macro-Action-Choice]]
 * [[Delaying Displaying Text or Running Code|Macro-Timed]]
-* [[Displaying Text Letter by Letter|Macro-Type]] [ ★ UPDATE ★ ]
+* [[Displaying Text Letter by Letter|Macro-Type]] 
 * [[Using Custom Macro|Custom-Macro]]
 
 <div id="link-menu">[[Back to the Start Menu|Start]]</div>

Pages-2-Intermediate/Macro-Conv.tw

@@ -4,12 +4,12 @@ Whether for a more convinent way to format code and passages, send players to a
 
 * [[An Alternative to Conditional Statements|Macro-Switch]] 
 * [[Removing Blank Space and Hiding Code|Macro-Nobr-Silent]]
-* [[Including a Passage inside another|Macro-Include]] [ ★ UPDATE ★ ]
-* [[Creating and Using a Widget|Macro-Widget]] [ ★ UPDATE ★ ]
+* [[Including a Passage inside another|Macro-Include]] 
+* [[Creating and Using a Widget|Macro-Widget]] 
 * [[Going Back or Returning to a Passage with a Special Link|Macro-Back-Return]]
 ** [[Arbitrarily Long Returns|Long-Return-JS]]
 * [[Sending the Player to a Passage|Macro-Goto]]
-* [[Using JavaScript in the Passage|Macro-Script-Run]]  [ ★ UPDATE ★ ]
+* [[Using JavaScript in the Passage|Macro-Script-Run]]  
 
 <div id="link-menu">[[Back to the Start Menu|Start]]</div>
 

Pages-2-Intermediate/Markup-Int.tw

@@ -2,9 +2,9 @@
 <h1>More SugarCube Markup</h1>
 While [[Markup]] can help format text on the screen, display an image or create a link, it can also be useful in affecting HTML elements on the page (like stats bars), or display small variation (like pronouns).
 
-* [[Special Attributes and Directives|Markup-Attribute]] [ ★ NEW ★ ]
-* [[Displaying Code and Verbatim Text|Markup-Code-Verbatim]] [ ★ NEW ★ ]
-* [[Display Small Variation with Templates|Markup-Template]] [ ★ NEW ★ ]
+* [[Special Attributes and Directives|Markup-Attribute]] 
+* [[Displaying Code and Verbatim Text|Markup-Code-Verbatim]] 
+* [[Display Small Variation with Templates|Markup-Template]] 
 
 <div id="link-menu">[[Back to the Start Menu|Start]]</div>
 

Pages-2-Intermediate/Special-Tags.tw

@@ -6,8 +6,8 @@ Aside from the [[Basic Special Passages|Special-Passage]], your project can be c
 * [[Process Code Before and After Rendering a Passage|SP-PassageReady-Done]]
 * [[Changing the UI of the Project|SP-StoryInterface]]
 * [[Customising Passages with Tags|Tags-CSS]]
-* [[Including Assets with Tags|Tags-Asset]] [ ★ NEW ★ ]
-* [[The Special Variables|SP-Variables]] [ ★ NEW ★ ]
+* [[Including Assets with Tags|Tags-Asset]] 
+* [[The Special Variables|SP-Variables]] 
 
 <div id="link-menu">[[Back to the Start Menu|Start]]</div>
 
@@ -211,11 +211,10 @@ This can be done with either {{{data-passage}}} or {{{data-init-passage}}}.
 > ''Note:'' any text coded inside the elements in {{{StoryInterface}}} will be overriden by the content of the linked passage.
 \
 While these two links seem interchangeable, there is a major difference between the two: {{{data-init-passage}}} will load at the start of the game and ''never'' change, while {{{data-passage}}} will update with every new passage visited (if an update is necessary).
+> ''Note:'' you can also use {{{data-passages}} with [[Special Asset Passages|Tags-Asset]]: {{{<img data-passage="TheCube">}}}
 
 <div id="link-menu">[[Back to the Special Passages and Tags Menu|Special-Tags]] - [[Back to the Start Menu|Start]]</div>
 
-/*TODO -> other use of tada-passage*/
-
 :: Tags-CSS [page] {"position":"2100,1300","size":"100,100"}
 <h1>Customising Passages with Tags</h1>
 Aside from [[creating Special Passages or Functionalities|Tags-Built]], tags can also be used to customise how a passage looks. For example, if multiple passages are set in a forest, one can add a tag called {{{forest}}} to those passages, and use this tag to set an image of a forest in the background of those passages.
@@ -290,9 +289,8 @@ These media passages will support audio, image, video, and VTT elements. Each of
 <div id="link-menu">[[Back to the Special Passages and Tags Menu|Special-Tags]] - [[Back to the Start Menu|Start]]</div>
 
 :: SP-Variables [page] {"position":"2100,1400","size":"100,100"}
-TODO: link
 <h1>The Special Variables</h1>
-SugarCube includes special variables, which can be used in the JavaScript passage or within the {{{<<script>>}}} macro.
+SugarCube includes special variables, which can be used in the JavaScript passage or within the {{{<<script>>}}} [[macro|Macro-Script-Run]].
 \
 <h3>The API Variables</h3>\
 The different APIs included in SugarCube are defined as Special Variables:
@@ -320,4 +318,3 @@ The different APIs included in SugarCube are defined as Special Variables:
 * {{{setup}}} are objects used for static data
 
 <div id="link-menu">[[Back to the Special Passages and Tags Menu|Special-Tags]] - [[Back to the Start Menu|Start]]</div>
-/* TODO *?