Harlowe Story Format for Twine
The Harlowe story format for Twine provides a number of built-in features to make it easier to enhance your stories.
Getting Started Formatting Text in Harlowe 3.3.3
This guide was originally written for Harlowe version 3.2.1. Twine and Harlowe were both significantly updated in July and August 2022. This guide is for Harlowe version 3.3.3. Note that Twine doesn’t automatically update itself; you have to download and install the newest version yourself.
Consult the full documentation for Harlowe for much more detail than I will cover in this post. However, I find the official documentation assumes some prior experience and background, rather than being a step-by-step guide.
If you’re just getting started in Twine, you may want to start with my post on how Twine makes branching scenarios easier. After you start with that, you can return to this post for information on styling the story.
If you’re curious about the differences between versions, I also posted my first impressions of Twine 2.4.1.
The Harlowe toolbar gives you access to a number of features without having to know how to code them.
In past versions of Harlowe, a passage appears with a title, tag, and space for the passage text. If your version looks like this, you should download the update.
Formatting text with bold, italics, and strikethrough styles works like other text editing programs. You don’t have to remember the markup language, but it will appear that way in the passage.
If you want to change the overall look and feel of the whole story, it’s a little more complicated than just formatting a short passage of text. For example, the default styling for Harlowe is a black background with white text. I don’t personally like this, plus I think the blue links are hard to read. (WebAIM’s color contrast checker puts it at 4.33:1, so it fails the accessibility check for normal size text.)
Text and background color options
I’d rather have a white background with black text so the links are more readable.
- Create a new passage. This passage doesn’t need to connect to any other passages.
- Add the title “Style” or something easy to identify.
- Select the Colours button on the toolbar.
- Change the text color and background. I used the default black for the text and a slightly off white (#fcfcfc) for the background.
- Set the Affect to “The entire page.” This is what makes the change format the whole page instead of just a passage.
- Select Add.
- Remove the placeholder passage text if needed.
- Add the tag “header” to the passage. This tag adds the style to every passage in the story automatically. (Note: tags are case sensitive. “Header” is not the same as “header.”)
If you follow the steps above, Harlowe will create this enchant: macro. A macro is basically a little code snippet in a Twine passage. The “enchant” macro makes a persistent change to something in a passage (in this case, the text and background colors).
The results of this macro are a story with a white background and black text. I didn’t change the link color (although that is also possible with an enchant macro), but the contrast of the blue against the lighter background makes it easier to read.
Could you accomplish the same thing without using the toolbar? Yes! You could enter the same “enchant” code shown below to make these adjustments. However, if you aren’t used to using Twine, this format may be hard to remember. That’s what Harlowe tries to accomplish; making it easier to generate these codes without consulting the documentation each time.
More in Harlowe
This is just the very beginning of what’s possible in formatting in Harlowe. If you’re interested in learning more about formatting, check out Visual Design for Scenarios in Twine. In that post, I explain step-by-step how to format a story like the one below without needing any CSS (using just a little bit of HTML code for the images).
Read more about Twine
- Twine Makes Branching Scenarios Easier
- Visual Design for Scenarios in Twine
- How to Use Conditional Feedback in Twine Scenarios
- Branching Scenario Prototype in Twine
- Illume Proofing Format for Twine
- How I Built a Chat Simulation in 2 Hours
Originally published 5/4/2021. Updated 12/8/2022.
10 thoughts on “Harlowe Story Format for Twine”
Hey so, here is my thing. Can you please tell me how to open the Harlowe tool bar in 2.4.1 is theres a keyboard shortcut to it. Im tryna look for it but it doesn’t show up. There used to be a arrow that opened the toolbar but since the enw update, idk how to turn the harlow passage toolbar.
Harlowe 2.4 was a significant change to the interface. Not everyone is happy with it, and I expect some more tweaks in the next few versions.
In the new format, in the top menu, select Twine > Story Formats. Can you verify which version of Harlowe you are using? It should be Harlowe 3.3.1. If not, that’s probably the issue.
Personally, in the new layout, the passage opens on the right with the toolbar immediately available. I don’t have an arrow, but all the tools are visible by default.
I have Twine 2.3.14 and Harlowe 3.2.2 but I don’t have the toolbar. Can’t find anything about it online. Do you know if I can fix it somehow?
Two things you can check:
1. On the main page of your Twine application, select Formats. Check if Harlowe 3.2.2 is the default story format or not.
2. Open your story. Select Change Story Format. If you originally created it in an older version of Harlowe or a different format, that’s probably still in use. Change it to Harlowe 3.2.2.
If neither of those work, let me know and I’ll see if I can figure out something else to test. Fingers crossed!
How to add harlowe 3.2.2 to twine2 using add button. Which url should I put there?
Since Harlow is the default format for Twine, the easiest way is probably to update the Twine app. You can download the latest version (2.3.14 as of today) and install it. That will update Twine and load the latest version of Harlowe. http://twinery.org/