Exporting to Twee from 2.1.3 Illume seems unstable -- Need help for my students

Question

My students have had trouble installing illume for a proofing format in 2.1.3. It installed but did not show up as a proofing format. One of my awesome students deleted Entweedle and reinstalled illume and that seemed to work for most. One student is still having trouble and another tries to add and just ends up waiting.

Is there a fix to this chaos or, even better, a way to easily get Twee from Twine?

The problem is that I need a fully copy-paste-able, printable copy of the source to read and mark and grade and paperwhite does not allow copying the passage headers or printing directly from proofing. Losing consistency with illume is a big deal. Any suggestions? Thanks so much

Answer 1

You didn't state which of the three releases (not the same as version) of the Twine 2 application you (or your students) are using, and that can make a difference on the answers given.
eg. was it the
a. Download & Install-able Executable release.
b. The Hosted Web-browser based release.
c. The Downloadable Local Web-browser based release.
d. Some combination of a,b & c.

 

...had trouble installing illume...

After looking at both Illume and Entweedle I believe that this issue (#421) is the cause of your problem, because both of those story formats have the same version number (1.0.3). While the cause of that issue has been fix in the Twine 2 application's repository, that fix won't be available to the public until the next release of the application.
note: I don't know when the next release will be but I do know that a new beta build of the application appeared on the application's repository on the 31-oct-2017, so the next release date may not be that far away although that date may depend on how long the testing phase takes.

 

Is there a fix to this chaos...

If you were running the install-able executable release of the Twine 2 application (or even the local web-browser based one) then I would suggest editing the related format.js file of one of the two story formats in question and change it's version number to something other than 1.0.3 (eg. 1.0.3a) so that the two didn't have the same value, that way the 2.1.3 version of Twine 2 would correctly accept that the two story formats aren't the same one.

note: This can also be done with the Hosted Web-browser based release but that requires editing information within the local storage of each user's web-browser, which is a more advanced activity.

Another possible quick fix is to contact the developer of the relevant two story formats and asking them to change the version number of one of two to something other than 1.0.3 (eg. 1.0.3a), that would also cause the v2.1.3 version of Twine 2 to consider them two different story formats.

 

...a way to easily get Twee from Twine 2

Unfortunately unlike the (semi-unrelated) Twine 1 project the Twine 2 project currently has no official support for TWEE notation (neither the importing nor exporting of it), and I don't know of any current intent to add such support. There is also no easy way to convert between a Twine 2 and a Twine 1 project, so you can't use Twine 1's built-in Import/Export TWEE features.

note: Programmatically it would be a fairly simple task to create some sort of script/utility to convert the story project file of the Install-able Executable release of the Twine 2 application into a TWEE notation file, because the data of a story project file is a very simple HTML like structure although some care is needed to convert some of the Passage encoded content back into plain text.

Comments

note: Programmatically it would be a fairly simple task to create some sort of script/utility to convert the story project file of the Install-able Executable release of the Twine 2 application into a TWEE notation file, because the data of a story project file is a very simple HTML like structure although some care is needed to convert some of the Passage encoded content back into plain text.

Both Tweego, which is a single static binary, and Twee2, which requires Ruby and various gems to be installed, can convert Twine 2 data (in the form of compiled files or single story archives from the executable release) to Twee code.

---

Thank you Greyelf and TheMadExile! All I really need is to be able to have students give me a formatted printout that includes the passage names. Paperwhite does not allow the passage names to be copied and pasted along with the rest of the text, and there seems to be no way to print from the proofing format. A readable document that can be commented and marked up can be really important for teachers. It certainly is for me so I can comment on style and grammatical problems, and also review the whole structure efficiently. If you know a way to accomplish this without Twee, I would be very grateful to know it.

---

If you know about Illume, maybe you've tried Entweedle?  (It's at version 1.0.3, which may or may not work.)  I have a similar format called Entwee that's at 1.0.1, which I think will work as far as version number goes; you can install it here and see if it does what you need: https://www.mcdemarco.net/tools/entwee/format.js

They both create twee-style output, which should include text, headers, and raw links.

---

Entwee is absolutely perfect! Even better than Entweedle and Illume (I don't quite know where one begins and the other ends) because it cuts the extra step and goes straight to an exportable textfile that can be printed. I will have my students try it on Monday. If it works for them, it will be my new solution not only for my classes but teachers I spread Twine to. Thank you so very much!!

Jeremiah