**(show: // ...[[harlowe:HookName|HookName]]//) -> //[[harlowe:Command|Command]]//** Reveals hidden hooks, running the code within. === Example usage: === |fan)[The overhead fan spins lazily.] (link:"Turn on fan")[(show:?fan)] === Rationale: === The purpose of hidden hooks is, of course, to eventually show them - and this macro is how you show them. You can use this [[harlowe:Command|Command]] inside a [[harlowe:link|(link:)]], trigger it in real-time with a [[harlowe:live|(live:)]] macro, or anywhere else. Using (show:) vs [[harlowe:replace|(replace:)]]: There are different reasons for using hidden hooks and (show:) instead of [[harlowe:replace|(replace:)]]. For your stories, think about whether the prose being revealed is part of the "main" text of the passage, or is just an aside. In neatly-coded stories, the main text should appear early in a passage's code, as the focus of the writer's attention. When using [[harlowe:replace|(replace:)]], the replacement prose is written far from its insertion point. This can improve readability when the insertion point is part of a long paragraph or sentence, and the prose is a minor aside or amendment, similar to a footnote or post-script, that would clutter the paragraph were it included inside. Additionally, [[harlowe:replace|(replace:)]] can be used in a "header" or "footer" tagged passage to affect certain named hooks throughout the story. You turn away from her, facing the grandfather clock, its [stern ticking]<1| filling the tense silence. (click-replace: ?1)[echoing, hollow ticking] When using (show:), the hidden hook's position is fixed in the passage prose. This can improve readability when the hidden hook contains a lot of the "main" text of a passage, which provides vital context and meaning for the rest of the text. I don't know where to begin... |1)[The weird state of my birth, the prophecy made centuries ago, my first day of school, the day of the meteors, the day I awoke my friends' powers... so many strands in the tapestry of my tale, and no time to unravel them.] ...so for now I'll start with when we fell down the hole. (link:"Where, indeed?")[(show:?1)] But, there aren't any hard rules for when you should use one or the other. As a passage changes in the writing, you should feel free to change between one or the other, or leave your choice as-is. === Details: === (show:) will reveal every hook with the given name. To only reveal a specific hook, you can use the possessive syntax, as usual: ''%%(show: ?shrub's 1st)%%''. If you provide to (show:) a hook which is already visible, nothing will happen - no error will be produced. === See also: === [[harlowe:hidden|(hidden:)]], [[harlowe:replace|(replace:)]]