Merge pull request #1199 from klembot/develop

2.4.1

.github/workflows/prs.yml

@@ -20,4 +20,4 @@ jobs:
       - name: Lint
         run: npm run lint
       - name: Test
-        run: npm run test:coverage
+        run: npm run test:coverage -- --maxWorkers=2

docs/en/src/README.md

@@ -44,16 +44,16 @@ done with Twine--but you might be better-served using a different tool.
   [Inform](http://inform7.com) or [Bitsy](http://www.bitsy.org), for example,
   might be better fits for these.
 
-See [Limitations] for more details on some of the above and some possible ways
+See [Limitations](../limitations/index.md) for more details on some of the above and some possible ways
 to work around these issues.
 
 ## See Also...
 
-In order to use Twine most effectively, you should spend some time reading the documentation for the story format you're using. ([Wait, what's a story format?](whats-a-story-format)) 
+In order to use Twine most effectively, you should spend some time reading the documentation for the story format you're using. ([Wait, what's a story format?](getting-started/basic-concepts.html#story-formats)) 
 
 - [Chapbook](http://klembot.github.io/chapbook/guide/)
 - [Harlowe](https://twine2.neocities.org)
 - [Snowman](https://videlais.github.io/snowman/2/)
 - [SugarCube](http://www.motoslave.net/sugarcube/2/)
 
-You might also find the [Twine Cookbook](cookbook) useful to read. It contains example code and explanations for things Twine authors often want to do.
+You might also find the [Twine Cookbook](https://twinery.org/cookbook) useful to read. It contains example code and explanations for things Twine authors often want to do.

docs/en/src/SUMMARY.md

@@ -7,6 +7,7 @@
 	- [Getting Around in Twine](getting-started/getting-around.md)
 	- [Updating Twine](getting-started/updating.md)
 	- [Uninstalling Twine](getting-started/uninstalling.md)
+	- [Using an Older Version of Twine](getting-started/downgrading.md)
 - [Using the Story Library](story-library/index.md)
 	- [Viewing Stories](story-library/viewing.md)
 	- [Creating, Copying and Importing Stories](story-library/creating.md)

docs/en/src/editing-stories/linking-passages.md

@@ -6,7 +6,7 @@ square brackets around text in a passage.
 
 - Writing `[[A passage]]` makes a link to a passage named "A passage".
 
-- Writing `[[A label->A passage]]`` also makes a link to a passage named "A
+- Writing `[[A label->A passage]]` also makes a link to a passage named "A
   passage", but the text that is displayed onscreen is "A label".
 
 - You can also reverse the arrow direction and write `[[A passage<-A label]]`,

docs/en/src/getting-started/downgrading.md

@@ -0,0 +1,44 @@
+# Using an Older Version of Twine
+
+Switching from a newer version of Twine to an older one can be done, though you
+may experience odd behavior in the transition. Old versions of Twine of course
+aren't aware of any new capabilities that the newer version has added.
+
+Twine follows [semantic versioning](https://semver.org). This means that the
+first version number of Twine only changes when a backwards-incompatible change
+is made, either to how it saves stories or how it interacts with story format
+extensions. This means that going from (using hypothetical versions for the sake
+of argument) Twine 15.0.0 to Twine 14.3.6 will likely be tricky, but going from
+Twine 14.3.6 to Twine 14.2.0 will not be.
+
+What exactly you experience will depend on the particulars of the versions you
+are moving between. **You may lose data in the transition.** Switching from a
+newer version of Twine to an older one, generally speaking, is not well-tested.
+
+## Before You Switch Versions
+
+Regardless of whether you are using browser Twine or app Twine, you should [save
+an archive](../story-library/exporting.md) of your work. This will ensure that
+even if the absolute worst happens, you have a safe copy of your work.
+
+## Using an Older Browser Twine
+
+Each version of Twine since 2.0 is available by visiting
+`https://twinery.org/[version number]` in your browser. For example, you can use
+Twine 2.1.1 by going to `https://twinery.org/2.1.1`.
+
+## Using an Older App Twine
+
+Older releases are available on the [Twine GitHub
+repository](https://github.com/klembot/twinejs/releases).
+
+## After Switching Versions
+
+If you are using a built-in story format (Chapbook, Harlowe, Snowman, or
+SugarCube), then you will almost certainly need to either install a newer
+version of the story format separately, or change the story format your work
+uses.
+
+You may also need to [reset your preferences](../troubleshooting/wont-start.md).
+Although the instructions linked are for the most recent version of Twine, they
+will probably work with most older versions of Twine as well.

electron-builder.config.js

@@ -1,6 +1,7 @@
 const pkg = require('./package.json');
 
-const isPreview = /alpha|beta|pre/.test(pkg.version);
+const isPreview =
+	/alpha|beta|pre/.test(pkg.version) || process.env.FORCE_PREVIEW;
 
 module.exports = {
 	directories: {

package.json

@@ -82,7 +82,7 @@
 		"cpy": "^8.1.2",
 		"cpy-cli": "^3.1.1",
 		"cross-var": "^1.1.0",
-		"electron": "^17.1.0",
+		"electron": "^17.4.10",
 		"electron-builder": "^23.0.2",
 		"faker": "^5.4.0",
 		"history": "^5.1.0",