Docs for switching layouts (#5109)

editions/tw5.com/tiddlers/concepts/SystemTags.tid

@@ -1,5 +1,6 @@
 created: 20130822080600000
-modified: 20180927080631239
+list: [[SystemTag: $:/tags/AboveStory]] [[SystemTag: $:/tags/AdvancedSearch]] [[SystemTag: $:/tags/AdvancedSearch/FilterButton]] [[SystemTag: $:/tags/Alert]] [[SystemTag: $:/tags/BelowStory]] [[SystemTag: $:/tags/ControlPanel]] [[SystemTag: $:/tags/ControlPanel/Advanced]] [[SystemTag: $:/tags/ControlPanel/Appearance]] [[SystemTag: $:/tags/ControlPanel/Info]] [[SystemTag: $:/tags/ControlPanel/Saving]] [[SystemTag: $:/tags/ControlPanel/Settings]] [[SystemTag: $:/tags/ControlPanel/Toolbars]] [[SystemTag: $:/tags/EditorToolbar]] [[SystemTag: $:/tags/EditPreview]] [[SystemTag: $:/tags/EditTemplate]] [[SystemTag: $:/tags/EditToolbar]] [[SystemTag: $:/tags/Exporter]] [[SystemTag: $:/tags/Filter]] [[SystemTag: $:/tags/Image]] [[SystemTag: $:/tags/ImportPreview]] [[SystemTag: $:/tags/KeyboardShortcut]] [[SystemTag: $:/tags/Layout]] [[SystemTag: $:/tags/Macro]] [[SystemTag: $:/tags/Macro/View]] [[SystemTag: $:/tags/Manager/ItemMain]] [[SystemTag: $:/tags/Manager/ItemSidebar]] [[SystemTag: $:/tags/MoreSideBar]] [[SystemTag: $:/tags/MoreSideBar/Plugins]] [[SystemTag: $:/tags/PageControls]] [[SystemTag: $:/tags/PageTemplate]] [[SystemTag: $:/tags/Palette]] [[SystemTag: $:/tags/PluginLibrary]] [[SystemTag: $:/tags/RawMarkup]] [[SystemTag: $:/tags/RawMarkupWikified]] [[SystemTag: $:/tags/RawMarkupWikified/BottomBody]] [[SystemTag: $:/tags/RawMarkupWikified/TopBody]] [[SystemTag: $:/tags/RawMarkupWikified/TopHead]] [[SystemTag: $:/tags/RawStaticContent]] [[SystemTag: $:/tags/RemoteAssetInfo]] [[SystemTag: $:/tags/SearchResults]] [[SystemTag: $:/tags/ServerConnection]] [[SystemTag: $:/tags/SideBar]] [[SystemTag: $:/tags/SideBarSegment]] [[SystemTag: $:/tags/StartupAction]] [[SystemTag: $:/tags/StartupAction/Browser]] [[SystemTag: $:/tags/StartupAction/Node]] [[SystemTag: $:/tags/Stylesheet]] [[SystemTag: $:/tags/TagDropdown]] [[SystemTag: $:/tags/TextEditor/Snippet]] [[SystemTag: $:/tags/TiddlerInfo]] [[SystemTag: $:/tags/TiddlerInfo/Advanced]] [[SystemTag: $:/tags/TiddlerInfoSegment]] [[SystemTag: $:/tags/ToolbarButtonStyle]] [[SystemTag: $:/tags/TopLeftBar]] [[SystemTag: $:/tags/TopRightBar]] [[SystemTag: $:/tags/ViewTemplate]] [[SystemTag: $:/tags/ViewToolbar]]
+modified: 20201123192434277
 tags: Reference Concepts
 title: SystemTags
 type: text/vnd.tiddlywiki

editions/tw5.com/tiddlers/customising/Alternative page layouts.tid

@@ -0,0 +1,15 @@
+created: 20201123172925848
+modified: 20201123192845498
+tags: [[Customise TiddlyWiki]]
+title: Alternative page layouts
+type: text/vnd.tiddlywiki
+
+<<.from-version "5.1.23">> You can have multiple alternative page layouts and switch between them. To see a list of available layouts and switch between them, use the keyboard shortcut <kbd><<displayshortcuts ((layout-switcher))>></kbd>.
+
+! Creating an alternative page layout
+
+Creating an alternative layout goes beyond [[adding or removing features|Page and tiddler layout customisation]] from the default interface and allows you to create an entirely new layout from scratch.
+
+To create an alternative page layout and have the ability to switch to it, you need to create an alternative page template tiddler with the [[SystemTag: $:/tags/Layout]].
+
+This alternative page template can either be a tweaked and modified version of the [[default page template|$:/core/ui/PageTemplate]], or something entirely different. The layout switching mechanism requires that your page template tiddler has the fields `name` and `description`, which are used in the listing in the switching user interface.

editions/tw5.com/tiddlers/customising/Customise TiddlyWiki.tid

@@ -1,8 +1,9 @@
-title: Customise TiddlyWiki
+created: 20140904101600000
+list: [[Adding a table of contents to the sidebar]] [[Configuring startup tiddlers]] [[Configuring the default TiddlerInfo tab]] [[Creating a custom export format]] [[Creating a splash screen]] [[Customising search results]] [[Hidden Settings]] [[How to add a new tab to the sidebar]] [[How to apply custom styles]] [[How to create keyboard shortcuts]] [[How to turn off camel case linking]] [[How to widen tiddlers (aka storyriver)]] [[Making a custom journal button]] [[Page and tiddler layout customisation]] [[Alternative page layouts]] [[Preserving open tiddlers at startup]] [[Setting a favicon]] [[Setting a page background image]] [[Using Stylesheets]]
+modified: 20201123173044437
 tags: TableOfContents
-created: 201409041016
+title: Customise TiddlyWiki
-modified: 201409041016
+type: text/vnd.tiddlywiki
-list: [[Initial customisation]]
 
 Information about customising TiddlyWiki
 

editions/tw5.com/tiddlers/customising/Page and tiddler layout customisation.tid

@@ -1,7 +1,8 @@
-title: Page and tiddler layout customisation
+created: 20141120125300000
+modified: 20201123173002935
 tags: [[Customise TiddlyWiki]]
-created: 201411201253
+title: Page and tiddler layout customisation
-modified: 201411201253
+type: text/vnd.tiddlywiki
 
 One major feature of TiddlyWiki that many new users are unaware of is the degree to which TiddlyWiki can be customised, just by adding or removing SystemTags in key shadow tiddlers or in your own custom tiddlers. 
 
@@ -11,6 +12,8 @@ One major feature of TiddlyWiki that many new users are unaware of is the degree
 
 Once you know what you are doing, all of these things are actually pretty easy to do.
 
+<<.from-version "5.1.23">> You can also create [[alternative page layouts|Alternative page layouts]] and switch between them.
+
 ! Adding custom-made tiddlers to the user interface
 
 You can also create any tiddler you want and tag it with the appropriate SystemTag, and it will appear in that place. For example, if you create a tiddler 'Reminder to self', add the text 'This is a reminder' and tag it `$:/tags/EditTemplate`, the words 'This is a reminder' will appear inside every tiddler when you edit it.

editions/tw5.com/tiddlers/systemtags/SystemTag_ $__tags_Layout.tid

@@ -0,0 +1,9 @@
+caption: $:/tags/Layout
+created: 20201123191935978
+description: marks alternative page layouts
+modified: 20201123192158739
+tags: SystemTags
+title: SystemTag: $:/tags/Layout
+type: text/vnd.tiddlywiki
+
+The [[system tag|SystemTags]] `$:/tags/Layout` marks [[alternative page layouts|Alternative page layouts]] that can be switched to.

editions/tw5.com/tiddlers/widgets/EventCatcherWidget.tid

@@ -1,11 +1,12 @@
 created: 20201123113532200
-modified: 20201123143104394
+modified: 20201123172753436
 tags: Widgets
 title: EventCatcherWidget
 type: text/vnd.tiddlywiki
 
 ! Introduction
 
+<<.from-version "5.1.23">>
 The event catcher widget traps JavaScript events dispatched within its child content, and allows invoking a series of ActionWidgets in response to the events. 
 
 In order for the events to be trapped they must: