This section lists all changes made to Grok TiddlyWiki since the previous released version.

The full source and all changes for Grok TiddlyWiki is publicly available on GitHub.

Grok TiddlyWiki 2.0.0

Changes in approach

• The largest change in TiddlyWiki recently has been the replacement of macros with procedures for general use. Version 2.0 moves Macros, along with several more advanced topics in wikitext rendering, to a new chapter 6, and changes chapter 4 to focus on variables, procedures, and field transclusions of all kinds. Exercises, takeaways, and other content have been updated throughout the book to align with this new approach.
• We now treat the idea of “transclusion” as fully including procedures, variables, functions, etc., as first-class elements, rather than tending to call only field transclusions transclusions and using different names for the other objects. Given how much more unified the two things have become (field transclusions can be parameterized, and you now use the $transclude widget for all of them), this seems like a better way to think about it.
• The “Common Misunderstandings” chapter has been removed, since the items in it are all no longer easily misunderstood with the advent of new features.

New sections

Each of these except for “Much More Than You Wanted to Know About Scopes” is aligned with a new feature since the last release of TiddlyWiki covered by a Grok TiddlyWiki edition:

• Using Variables as Attributes
• Procedures
• Parameterizing Field Transclusions
• Conditional Expressions
• Functions
• Much More Than You Wanted to Know About Scopes
• Custom Widgets
• Overriding Built-In Widgets

The Macros section is also new – while there was a section called “Macros” before, the “Procedures” section is much more closely related to the old “Macros” section than the new “Macros” section is. The new “Macros” section is rewritten from scratch, assuming that you already grok procedures and explaining the differences between macros and procedures (mostly text substitution).

General

• All of the internal code of Grok TiddlyWiki has been refactored to use the new features to the greatest extent possible, so if you poke around there you will be shown modern good practices.
• The whole book has gotten a polish pass with minor revisions for improved clarity.
• We now recommend starting with TiddlyHost as a saving and hosting solution, rather than TiddlyDesktop.
• I've read through the entire book and corrected a number of things that had gotten slightly out of date over the years or could be explained better.

Fixes

• The “mentions of” display in the related tiddlers drop-down at the bottom of many sections was broken and displaying the same two tiddlers.
• Normalize indentation in code examples to two spaces per level (no tabs) across the wiki.
• Address a wide variety of miscellaneous items of feedback and errors spotted by readers over the past year or so.

Upgrading

If you'd like, you can upgrade a current edition of Grok TiddlyWiki to 2.0 just like you can with any other edition. You should keep in mind, however, that when you have worked through or edited exercises and takeaways in older versions, you've made copies of their shadow tiddlers, so the upgraded version won't show any updates to those exercises and takeaways. This is a minor to nonexistent issue in most releases of GTW, but in a major release like this one where many of these have changed considerably, it may be more confusing or problematic than normal.

Therefore, we recommend that if you don't have significant exercise or takeaway review history you'd like to keep, you start out working on Grok TiddlyWiki 2.0 by making a fresh copy. If you do have such history, upgrading may make more sense for you – just be on the lookout as you proceed and delete any exercises or takeaways that look like they aren't up to date to grab the latest versions.

(If there are any sections or chapters you've modified directly, you'll be asked to merge the changes and delete them during the upgrade process, so all of your actual text will be fully up to date after completing an upgrade. This is impractical for exercises or takeaways given that there are so many of them and it's normal to modify them.)

Grok TiddlyWiki 1.2.2

• The TiddlyRemember plugin has been updated to version 1.3.2.
• TiddlyWiki has been updated to version 5.2.1.
• Scheduling information maintained by TakeAway will now be exported to Anki when you start studying with Anki.
• The $let widget is now used instead of the $vars widget, now that it's available in 5.2.1 and pretty much strictly superior.
• Fixed several typos, wording mistakes, and other minor errors.

Grok TiddlyWiki 1.2.1

• Fixed the Takeaway Export List showing an ID of “Preview” for all takeaways under certain circumstances, resulting in broken syncing to Anki.
• Fixed several typos and minor wording mistakes.

Grok TiddlyWiki 1.2.0

This version of Grok TiddlyWiki contains content updates to align the text with the following improvements in TiddlyWiki 5.2.0:

• Field names no longer have character restrictions.
• Images can now be directly inserted into tiddlers.
• HTML comments can now appear before and between pragmas.
• The $edit-text widget can now edit the tiddler it's contained in.
• :map and :sort filter run prefixes were added.
• Macro calls with parameters can now be transcluded into a filter.

Grok TiddlyWiki 1.1.0

I have bumped the minor version number because the interface has improved significantly in several places. Changes to the content are mostly incremental. I've made updates for TiddlyWiki 5.2.0, but they aren't included in this edition since 5.2.0 is still in prerelease at this time.

Text

• Added a back-matter section on Common Misunderstandings and started it with several items. I'll add more as I encounter them in the forums and elsewhere.
• Broke out the instructions for installing TiddlyWiki by operating system, and give sample instructions for a Linux install.
• Added an appendix on ways to support Grok TiddlyWiki and TiddlyWiki itself.
• Added an explanation of why all[tiddlers+shadows] appears in so many live examples.
• Improved accuracy and completeness of the description of what makes a title CamelCase.
• Applied various minor wording and formatting tweaks; thanks to everyone who has pointed out typographical errors and made suggestions!

Interface

• If you study takeaways in-text on the web, you'll now receive a warning when you finish the section that you should create your own copy of GTW if you want to preserve your progress.
• Improved the interface for adding your own takeaways. The interface for Q&A and cloze is now clearly separated, usage guidance is attached to each, and it's no longer possible to accidentally create a blank takeaway by pressing the button without typing anything.
• Added contextual help throughout the interface, where a small Tip box appears the first time you use a new feature.
• Improved the Changes appendix so it shows the date and commit hash of each release.
• Changed the arrow symbols used to enter the first/last section of a chapter in the navigation bar, as the symbols we were using weren't in the embedded font and could be missing on some devices.

Miscellaneous

• Added an upgrader tool that guides you through the process of deleting any takeaways or other tiddlers that have become out of date in the new version.
• Created a static version of the book for search engines and people on low-bandwidth connections; most of the interactive features are missing, but it's enough for a quick check of a page. A large banner explains this and provides a permalink to the tiddler within the wiki version. The <noscript> element in the wiki version also points to the static version.

Grok TiddlyWiki 1.0.2

• Deleting any bookmark was causing all bookmarks to be deleted. This has been fixed and you can now safely delete bookmarks.
• Fixed instructions for embedding a font in TW (if you're poking around in the system tiddlers wondering how I did it, you can now find the correct forum thread for reference).
• Expanded the prompt for Ex:AlphabeticallyLastDescription to incorporate user feedback.
• Fixed several more incorrect filters on live examples in Sn:RubberDucking.
• Fixed several more typos and confusingly worded sentences.

Grok TiddlyWiki 1.0.1

• The Takeaways tab of the sidebar search box was mistakenly finding only collected takeaways; this has been fixed.
• Corrected the filter on several live examples in Wr:Transclusions so that they show output as intended.
• Evened out the spacing at the bottom of the in-text takeaway reviewer once all cards have been collected.
• Fixed several typos and confusingly worded sentences.