From 06cc8ed5ef9adc05ea2a67fc4cca25c83fd075ff Mon Sep 17 00:00:00 2001 From: Jermolene Date: Fri, 19 Sep 2014 17:18:25 +0100 Subject: [PATCH] Lots of documentation cleanup --- ...ying tiddlers between TiddlyWiki files.tid | 4 +- .../tiddlers/about/Philosophy of Tiddlers.tid | 8 +- .../tw5.com/tiddlers/concepts/TiddlerTags.tid | 46 ----------- .../tw5.com/tiddlers/concepts/TiddlyWiki.tid | 4 +- .../tw5.com/tiddlers/definitions/MathML.tid | 4 +- .../demonstrations/ImageGallery Example.tid | 4 +- .../Tasks/TaskManagementExample.tid | 4 +- .../tiddlers/features/ImportTiddlers.tid | 4 +- .../tw5.com/tiddlers/features/Searching.tid | 17 ++-- .../tw5.com/tiddlers/fields/ListField.tid | 4 +- .../filters/Introduction to Filters.tid | 4 +- .../howtos/Adding a Twitter Follow button.tid | 4 +- .../tiddlers/howtos/Creating SubStories.tid | 4 +- .../howtos/Editing Tiddlers with Emacs.tid | 4 +- .../howtos/Making curved text with SVG.tid | 4 +- .../Sharing a TiddlyWiki on Dropbox.tid | 4 +- .../howtos/Structuring TiddlyWiki.tid | 4 +- editions/tw5.com/tiddlers/howtos/Tagging.tid | 16 ++-- .../The First Rule of Using TiddlyWiki.tid | 4 +- .../tw5.com/tiddlers/howtos/Upgrading.tid | 12 ++- .../tiddlers/howtos/Video Tutorials.tid | 25 ------ .../tw5.com/tiddlers/learning/Learning.tid | 4 +- .../tiddlers/macros/TableOfContentsMacro.tid | 10 ++- .../saving/Saving with Encryption.tid | 14 ++-- .../Navigating between open tiddlers.tid | 28 ++++--- .../tocproject/Using links to navigate.tid | 77 ++++++++++++------- .../tocproject/Working with TiddlyWiki.tid | 5 +- .../tiddlers/videos/Getting Started Video.tid | 8 +- editions/tw5.com/tiddlers/videos/Videos.tid | 6 +- .../Sharing tiddlers with others.tid | 9 ++- 30 files changed, 162 insertions(+), 183 deletions(-) delete mode 100644 editions/tw5.com/tiddlers/concepts/TiddlerTags.tid delete mode 100644 editions/tw5.com/tiddlers/howtos/Video Tutorials.tid diff --git a/editions/tw5.com/tiddlers/Copying tiddlers between TiddlyWiki files.tid b/editions/tw5.com/tiddlers/Copying tiddlers between TiddlyWiki files.tid index 0c0ac5933..3e06f5d40 100644 --- a/editions/tw5.com/tiddlers/Copying tiddlers between TiddlyWiki files.tid +++ b/editions/tw5.com/tiddlers/Copying tiddlers between TiddlyWiki files.tid @@ -1,6 +1,6 @@ created: 20140908131700000 -modified: 20140916130327516 -tags: [[Working with TiddlyWiki]] +modified: 20140919161524603 +tags: Learning title: Copying tiddlers between TiddlyWiki files type: text/vnd.tiddlywiki diff --git a/editions/tw5.com/tiddlers/about/Philosophy of Tiddlers.tid b/editions/tw5.com/tiddlers/about/Philosophy of Tiddlers.tid index d42921631..bef0dfd6a 100644 --- a/editions/tw5.com/tiddlers/about/Philosophy of Tiddlers.tid +++ b/editions/tw5.com/tiddlers/about/Philosophy of Tiddlers.tid @@ -1,13 +1,11 @@ created: 20131128075743966 -modified: 20140912145958621 -tags: [[Working with TiddlyWiki]] +modified: 20140919160655340 +tags: Learning title: Philosophy of Tiddlers type: text/vnd.tiddlywiki -TiddlyWiki is an opinionated tool, but the opinions are in the domain of philosophy rather than of implementation, where it is infinitely customisable. - The purpose of recording and organising information is so that it can be used again. The value of recorded information is directly proportional to the ease with which it can be re-used. -The philosophy of [[tiddlers|Tiddlers]] is that we do this by slicing information up into the smallest semantically meaningful units with [[rich modelling of relationships between them|Structuring TiddlyWiki]]. Then we use aggregation and composition to weave the fragments together to present narrative stories. +The philosophy of [[tiddlers|Tiddlers]] is that we maximise the possibilities for re-use by slicing information up into the smallest semantically meaningful units with [[rich modelling of relationships between them|Structuring TiddlyWiki]]. Then we use aggregation and composition to weave the fragments together to present narrative stories. TiddlyWiki aspires to provide an algebra for tiddlers, a concise way of expressing and exploring the relationships between items of information. diff --git a/editions/tw5.com/tiddlers/concepts/TiddlerTags.tid b/editions/tw5.com/tiddlers/concepts/TiddlerTags.tid deleted file mode 100644 index 7916dbab0..000000000 --- a/editions/tw5.com/tiddlers/concepts/TiddlerTags.tid +++ /dev/null @@ -1,46 +0,0 @@ -created: 20140312124037773 -modified: 20140312124106267 -tags: Concepts -title: TiddlerTags -type: text/vnd.tiddlywiki - -! Introduction - -Tiddlers can be assigned categories by assigning one or more tags. For example, tiddlers representing individuals might be tagged ''friend'', ''family'', ''colleague'' etc to indicate the relationship to the author. - -Multiple tags can be applied to the same tiddler. Used effectively they provide a powerful way to explore content related to a tiddler. - -TiddlyWiki offers several useful features based on the convention that a tag itself can be interpreted as the title of a tiddler. - -! Using Tags - -Tags are displayed at the top of the tiddler as coloured pills. Clicking on a tag pill drops down a menu showing links to all the tiddlers that carry that tag, along with a link to the tiddler representing the tag itself. - -When editing a tiddler, the tags pills have a small ''x'' icon that allows them to be removed individually. There is also a text box to type the name of a new tag to be added, and a dropdown autocomplete list that shows matching tags that are in use. - -! Tag Manager - -The tag manager is available via a button at the top of the sidebar tab "Tabs", or you can link directly to [[$:/TagManager]]. - -! Assigning Colours and Icons to Tag - -The colour used to draw a tag pill is taken from the ''color'' field of the tiddler titled with the tag. The colour can be specified as any CSS value (more modern browsers show a colour picker for the ''color'' field). - -An icon can be associated with a tag by placing the title of the tiddler containing the image into the ''icon'' field of the tiddler titled with the tag. - -See the tag {{done||$:/core/ui/TagTemplate}} for an example. - -! Tag Ordering - -The ordering used to return a list of the tiddlers with a particular tag is determined by the following rules: - -* First, any tiddlers that are listed in the ListField of the tag tiddler are placed into a new list in the same order -* Second, any unplaced tiddlers that have the field ''list-before'' are placed before the tiddler specified in the field -** (if the ''list-before'' field is empty then the unplaced tiddler is placed at the start of the list) -* Third, if any unplaced tiddlers have the field ''list-after'' then they placed immediately after the tiddler specified in the field -* Finally, any remaining unplaced tiddlers are placed at the end of the list - -! System Tags - -See SystemTags for information about the special system tags that TiddlyWiki uses for configuration. - diff --git a/editions/tw5.com/tiddlers/concepts/TiddlyWiki.tid b/editions/tw5.com/tiddlers/concepts/TiddlyWiki.tid index 7f29954db..1f3e6a5b1 100644 --- a/editions/tw5.com/tiddlers/concepts/TiddlyWiki.tid +++ b/editions/tw5.com/tiddlers/concepts/TiddlyWiki.tid @@ -1,11 +1,11 @@ created: 20130822170700000 -modified: 20140312190357281 +modified: 20140919155804225 tags: Concepts title: TiddlyWiki type: text/vnd.tiddlywiki ~TiddlyWiki is a rich, interactive tool for manipulating complex data with structure that doesn't easily fit into conventional tools like spreadsheets or wordprocessors. -~TiddlyWiki is designed to fit around your brain, helping you deal with the things that won't fit. The [[fundamental idea|Philosophy of Tiddlers]] is that information is more useful and reusable if we cut it up into the smallest semantically meaningful chunks -- [[tiddlers|Tiddlers]] -- and give them titles so that they can be [[structured|Structuring TiddlyWiki]] with [[links|TiddlerLinks]], [[tags|TiddlerTags]], [[lists|ListField]] and [[macros|Macros]]. Tiddlers use a WikiText notation that concisely represents a wide range of text formatting and hypertext features. ~TiddlyWiki aims to provide a fluid interface for working with tiddlers, allowing them to be aggregated and composed into longer narratives. +~TiddlyWiki is designed to fit around your brain, helping you deal with the things that won't fit. The [[fundamental idea|Philosophy of Tiddlers]] is that information is more useful and reusable if we cut it up into the smallest semantically meaningful chunks -- [[tiddlers|Tiddlers]] -- and give them titles so that they can be [[structured|Structuring TiddlyWiki]] with [[links|TiddlerLinks]], [[tags|Tagging]], [[lists|ListField]] and [[macros|Macros]]. Tiddlers use a WikiText notation that concisely represents a wide range of text formatting and hypertext features. ~TiddlyWiki aims to provide a fluid interface for working with tiddlers, allowing them to be aggregated and composed into longer narratives. People [[love using|Raves]] ~TiddlyWiki. Because it can be used without any complicated server infrastructure, and because it is [[open source|OpenSource]], it has bought unprecedented freedom to people to keep their precious information under their own control. ~TiddlyWiki was originally created by JeremyRuston and is now a thriving open source project with a busy [[Community]] of independent developers. diff --git a/editions/tw5.com/tiddlers/definitions/MathML.tid b/editions/tw5.com/tiddlers/definitions/MathML.tid index 7677d8514..7b350041b 100644 --- a/editions/tw5.com/tiddlers/definitions/MathML.tid +++ b/editions/tw5.com/tiddlers/definitions/MathML.tid @@ -1,6 +1,6 @@ created: 20130901213100000 -modified: 20140912145419929 -tags: Definitions [[Learning TiddlyWiki]] +modified: 20140919161635814 +tags: Definitions Features title: MathML type: text/vnd.tiddlywiki diff --git a/editions/tw5.com/tiddlers/demonstrations/ImageGallery Example.tid b/editions/tw5.com/tiddlers/demonstrations/ImageGallery Example.tid index d41ec6307..98f847ee6 100644 --- a/editions/tw5.com/tiddlers/demonstrations/ImageGallery Example.tid +++ b/editions/tw5.com/tiddlers/demonstrations/ImageGallery Example.tid @@ -1,6 +1,6 @@ created: 20140809113603449 -modified: 20140912142407524 -tags: [[Learning TiddlyWiki]] +modified: 20140919161451179 +tags: Learning title: ImageGallery Example type: text/vnd.tiddlywiki diff --git a/editions/tw5.com/tiddlers/demonstrations/Tasks/TaskManagementExample.tid b/editions/tw5.com/tiddlers/demonstrations/Tasks/TaskManagementExample.tid index efb9af52b..3197a0daf 100644 --- a/editions/tw5.com/tiddlers/demonstrations/Tasks/TaskManagementExample.tid +++ b/editions/tw5.com/tiddlers/demonstrations/Tasks/TaskManagementExample.tid @@ -1,6 +1,6 @@ created: 20130825213300000 -modified: 20140912142106777 -tags: [[Learning TiddlyWiki]] +modified: 20140919161411400 +tags: Learning title: TaskManagementExample type: text/vnd.tiddlywiki diff --git a/editions/tw5.com/tiddlers/features/ImportTiddlers.tid b/editions/tw5.com/tiddlers/features/ImportTiddlers.tid index bcb9b2a31..f8d082b0a 100644 --- a/editions/tw5.com/tiddlers/features/ImportTiddlers.tid +++ b/editions/tw5.com/tiddlers/features/ImportTiddlers.tid @@ -1,6 +1,6 @@ created: 20130825162000000 -modified: 20140912141331091 -tags: Features [[Working with TiddlyWiki]] +modified: 20140919160801832 +tags: Features title: ImportTiddlers type: text/vnd.tiddlywiki diff --git a/editions/tw5.com/tiddlers/features/Searching.tid b/editions/tw5.com/tiddlers/features/Searching.tid index 572396651..899bbf3b7 100644 --- a/editions/tw5.com/tiddlers/features/Searching.tid +++ b/editions/tw5.com/tiddlers/features/Searching.tid @@ -1,5 +1,5 @@ created: 20140210160125905 -modified: 20140210162127052 +modified: 20140919155139513 tags: [[Working with TiddlyWiki]] title: Searching in TiddlyWiki type: text/vnd.tiddlywiki @@ -10,13 +10,16 @@ Searching is fast and flexible in ~TiddlyWiki. Typing text into the search box in the sidebar will turn up a list of all the tiddlers that contain that text. -://(Note that the sidebar tabs will be hidden by the search results until you click the 'x' to the right of the search box to delete the search results)// +://(Note that the sidebar tabs will be hidden by the search results until you click the 'x' to the right of the search box to remove the search results)// ''Advanced searching'' -To the right of the search box, when there are no search results displayed below it, you will find an ellipsis (...). Clicking on the ellipsis will open $:/AdvancedSearch. This tiddler contains four tabs. +To the right of the search box, when there are no search results displayed below it, you will find an ellipsis (...). Clicking on the ellipsis will open [[$:/AdvancedSearch]]. This tiddler contains four tabs. -*The ''standard'' tab contains another instance of the search box found in the sidebar. -*The ''system'' tab allows you to limit your search to system tiddlers. -*The ''shadows'' tab allows you to limit your search to shadow tiddlers. -*The ''filter'' tab is not a search box, per se, but a way to obtain a list of all tiddlers that meet the specific criteria described by that filter, for example, "All tags except system tags". +* The ''standard'' tab contains another instance of the search box found in the sidebar. + +* The ''system'' tab allows you to limit your search to system tiddlers. + +* The ''shadows'' tab allows you to limit your search to shadow tiddlers. + +* The ''filter'' tab is not a search box, per se, but a way to obtain a list of all tiddlers that meet the specific criteria described by that filter, for example, "All tags except system tags". diff --git a/editions/tw5.com/tiddlers/fields/ListField.tid b/editions/tw5.com/tiddlers/fields/ListField.tid index b7a03e7c3..43d4a6d76 100644 --- a/editions/tw5.com/tiddlers/fields/ListField.tid +++ b/editions/tw5.com/tiddlers/fields/ListField.tid @@ -1,12 +1,12 @@ created: 20130830092500000 -modified: 20140912145833212 +modified: 20140919155816993 tags: Fields title: ListField type: text/vnd.tiddlywiki The `list` [[field of a tiddler|TiddlerFields]] is an optional feature that can be used to help structure your content. It is defined as an ordered sequence of tiddler titles, and it can be used in several ways: -* The `list` field of a tiddler that is being used as a tag determines the ordering of the tiddlers that carry that tag - see TiddlerTags for details +* The `list` field of a tiddler that is being used as a tag determines the ordering of the tiddlers that carry that tag - see [[Tagging]] for details * The `list` [[filter|Filters]] selects the entries from a list * The `listed` [[filter|Filters]] selects the tiddlers that list the selected tiddler(s) * The NavigatorWidget manipulates a StoryList tiddler containing a `list` field of the tiddlers that are displayed in the main story column diff --git a/editions/tw5.com/tiddlers/filters/Introduction to Filters.tid b/editions/tw5.com/tiddlers/filters/Introduction to Filters.tid index 54e6db70e..257cb7a5e 100644 --- a/editions/tw5.com/tiddlers/filters/Introduction to Filters.tid +++ b/editions/tw5.com/tiddlers/filters/Introduction to Filters.tid @@ -1,6 +1,6 @@ created: 20140410101941871 -modified: 20140912150037750 -tags: Learning [[Working with TiddlyWiki]] +modified: 20140919160749349 +tags: Learning title: Introduction to Filters type: text/vnd.tiddlywiki diff --git a/editions/tw5.com/tiddlers/howtos/Adding a Twitter Follow button.tid b/editions/tw5.com/tiddlers/howtos/Adding a Twitter Follow button.tid index 42f84d641..d652bbe93 100644 --- a/editions/tw5.com/tiddlers/howtos/Adding a Twitter Follow button.tid +++ b/editions/tw5.com/tiddlers/howtos/Adding a Twitter Follow button.tid @@ -1,6 +1,6 @@ created: 20140103091348509 -modified: 20140912142524779 -tags: [[Learning TiddlyWiki]] +modified: 20140919161534259 +tags: Learning title: Adding a Twitter Follow button type: text/vnd.tiddlywiki diff --git a/editions/tw5.com/tiddlers/howtos/Creating SubStories.tid b/editions/tw5.com/tiddlers/howtos/Creating SubStories.tid index 69414b328..d23f0278b 100644 --- a/editions/tw5.com/tiddlers/howtos/Creating SubStories.tid +++ b/editions/tw5.com/tiddlers/howtos/Creating SubStories.tid @@ -1,6 +1,6 @@ created: 20140214215718317 -modified: 20140912142509875 -tags: [[Learning TiddlyWiki]] +modified: 20140919161514318 +tags: Learning title: Creating SubStories type: text/vnd.tiddlywiki diff --git a/editions/tw5.com/tiddlers/howtos/Editing Tiddlers with Emacs.tid b/editions/tw5.com/tiddlers/howtos/Editing Tiddlers with Emacs.tid index c1bc20cec..70397fe06 100644 --- a/editions/tw5.com/tiddlers/howtos/Editing Tiddlers with Emacs.tid +++ b/editions/tw5.com/tiddlers/howtos/Editing Tiddlers with Emacs.tid @@ -1,6 +1,6 @@ created: 20140406210404245 -modified: 20140916132156895 -tags: [[Learning TiddlyWiki]] +modified: 20140919161501896 +tags: Learning title: Editing Tiddlers with Emacs type: text/vnd.tiddlywiki diff --git a/editions/tw5.com/tiddlers/howtos/Making curved text with SVG.tid b/editions/tw5.com/tiddlers/howtos/Making curved text with SVG.tid index de95a563e..db74a7852 100644 --- a/editions/tw5.com/tiddlers/howtos/Making curved text with SVG.tid +++ b/editions/tw5.com/tiddlers/howtos/Making curved text with SVG.tid @@ -1,6 +1,6 @@ created: 20140324223413403 -modified: 20140912142355174 -tags: [[Learning TiddlyWiki]] +modified: 20140919161431562 +tags: Learning title: Making curved text with SVG type: text/vnd.tiddlywiki diff --git a/editions/tw5.com/tiddlers/howtos/Sharing a TiddlyWiki on Dropbox.tid b/editions/tw5.com/tiddlers/howtos/Sharing a TiddlyWiki on Dropbox.tid index 649228b8d..0edf77874 100644 --- a/editions/tw5.com/tiddlers/howtos/Sharing a TiddlyWiki on Dropbox.tid +++ b/editions/tw5.com/tiddlers/howtos/Sharing a TiddlyWiki on Dropbox.tid @@ -1,6 +1,6 @@ created: 20140122085818089 -modified: 20140912142156868 -tags: [[Working with TiddlyWiki]] +modified: 20140919160722247 +tags: Learning title: Sharing a TiddlyWiki on Dropbox type: text/vnd.tiddlywiki diff --git a/editions/tw5.com/tiddlers/howtos/Structuring TiddlyWiki.tid b/editions/tw5.com/tiddlers/howtos/Structuring TiddlyWiki.tid index b563ae395..e4b292cb1 100644 --- a/editions/tw5.com/tiddlers/howtos/Structuring TiddlyWiki.tid +++ b/editions/tw5.com/tiddlers/howtos/Structuring TiddlyWiki.tid @@ -1,5 +1,5 @@ created: 20131128090536894 -modified: 20140912145938292 +modified: 20140919155834905 tags: [[Working with TiddlyWiki]] title: Structuring TiddlyWiki type: text/vnd.tiddlywiki @@ -7,6 +7,6 @@ type: text/vnd.tiddlywiki TiddlyWiki5 provides several features to help you structure information as [[tiddlers|Tiddlers]], and model the relationships between them: * TiddlerLinks -* TiddlerTags +* [[Tagging]] * TiddlerLists * DataTiddlers diff --git a/editions/tw5.com/tiddlers/howtos/Tagging.tid b/editions/tw5.com/tiddlers/howtos/Tagging.tid index 3506be9f5..f6c8c9b53 100644 --- a/editions/tw5.com/tiddlers/howtos/Tagging.tid +++ b/editions/tw5.com/tiddlers/howtos/Tagging.tid @@ -1,16 +1,20 @@ +created: 20140904075400000 +modified: 20140919155913046 +tags: [[Working with TiddlyWiki]] Concepts title: Tagging -tags: [[Working with TiddlyWiki]] -created: 201409040754 -modified: 201409040754 +type: text/vnd.tiddlywiki Tagging a tiddler assigns a tiddler to a category of your choosing (see [[Creating and editing tiddlers]] for instructions on how to tag). For example, tiddlers representing individuals might be tagged ''friend'', ''family'', ''colleague'' etc to indicate the relationship to the author. Multiple tags can be applied to the same tiddler. Tagging tiddlers gives you numerous additional ways to view, navigate and organise your information: * The coloured tag pills on a tagged tiddler gives you links to all the other tiddlers with the same tag, as well as to the tiddler representing the tag itself. -* The tagging tab in the TiddlerInfo area (accessed by clicking the {{$:/core/images/info-button}} button) gives you links to all the tiddlers tagged with the title of the current tiddler. +* The tagging tab in the tiddler info panel (accessed by clicking the {{$:/core/images/info-button}} button) gives you links to all the tiddlers tagged with the title of the current tiddler. + * You can use the tags tab in the 'More' sidebar tab to view all your tags and access your tagged tiddlers. -* You can use ListFilters to create lists of tiddlers based on tags, then display whichever combination of tiddler fields you wish. For example, you can create a list that shows both the title and the text of all tiddlers tagged 'Glossary.' Such lists can be formatted however you wish: for example: bulleted, numbered, or comma-separated. + +* You can use [[filters|Filters]] to create lists of tiddlers based on tags, then display whichever combination of tiddler fields you wish. For example, you can create a list that shows both the title and the text of all tiddlers tagged 'Glossary.' Such lists can be formatted however you wish: for example: bulleted, numbered, or comma-separated. + * System tags can be used to customise the layout of tiddlers and the entire ~TiddlyWiki page. See [[Page and tiddler layout customisation]] for instructions. There are two more things you can do with tags: @@ -24,7 +28,7 @@ You can use the [[tag manager|$:/TagManager]], found in the 'Tags' tab of the 'M ! Use list fields to adjust the ordering of tag lists -* If you want to create a list of tagged tiddlers with a ListFilter, but want the tiddlers to be listed in a special order rather than the default alphabetical order, you can create a field called 'list' in the tag tiddler, and add the titles of the tiddlers to the field in the order you wish. ~TiddlyWiki will order lists of tagged tiddlers in the following order of priority: +* If you want to create a list of tagged tiddlers with a [[filter|Filters]], but want the tiddlers to be listed in a special order rather than the default alphabetical order, you can create a field called 'list' in the tag tiddler, and add the titles of the tiddlers to the field in the order you wish. ~TiddlyWiki will order lists of tagged tiddlers in the following order of priority: ** First, any tiddlers that are listed in the ListField of the tag tiddler are placed into a new list in the same order ** Second, any unplaced tiddlers that have the field ''list-before'' are placed before the tiddler specified in the field *** (if the ''list-before'' field is empty then the unplaced tiddler is placed at the start of the list) diff --git a/editions/tw5.com/tiddlers/howtos/The First Rule of Using TiddlyWiki.tid b/editions/tw5.com/tiddlers/howtos/The First Rule of Using TiddlyWiki.tid index b54b26e91..7e98ea502 100644 --- a/editions/tw5.com/tiddlers/howtos/The First Rule of Using TiddlyWiki.tid +++ b/editions/tw5.com/tiddlers/howtos/The First Rule of Using TiddlyWiki.tid @@ -1,5 +1,5 @@ created: 20140419132828051 -modified: 20140530124201033 +modified: 20140919154434409 tags: [[Working with TiddlyWiki]] title: The First Rule of Using TiddlyWiki type: text/vnd.tiddlywiki @@ -28,7 +28,7 @@ TiddlyWiki is a very flexible, customisable system that puts you firmly in charg The best way to make sure that your data is safe is to practice a rigorous system of backups: -* Consider using services like Dropbox to continuously back up your personal data to the cloud +* Consider using services like Dropbox to continuously back up your personal data to the cloud. (Dropbox [[has a neat feature|https://www.dropbox.com/help/11]] whereby they keep track of previous versions of files) * Retain backups before upgrading to a new version of TiddlyWiki * Figure out and protect yourself from the worst case scenarios: what if your USB stick or hard drive fails? What if your computer is hit by a ransomeware virus? * Be defensive and redundant: for example, take multiple backups and keep them in separate physical locations diff --git a/editions/tw5.com/tiddlers/howtos/Upgrading.tid b/editions/tw5.com/tiddlers/howtos/Upgrading.tid index b5c82957f..db04fd0b2 100644 --- a/editions/tw5.com/tiddlers/howtos/Upgrading.tid +++ b/editions/tw5.com/tiddlers/howtos/Upgrading.tid @@ -1,9 +1,13 @@ created: 20131202102427114 -modified: 20140912141217736 +modified: 20140919154634754 tags: Features [[Working with TiddlyWiki]] title: Upgrading type: text/vnd.tiddlywiki +There are regular releases of TiddlyWiki with bug fixes and improvements. It's a good idea to keep up to date by regularly upgrading to the latest version. + +! Introduction + The process described here is for upgrading standalone TiddlyWiki files. There is a [[different procedure|Upgrading TiddlyWiki on Node.js]] for upgrading [[TiddlyWiki on Node.js]]. <<< @@ -12,8 +16,6 @@ When upgrading, please remember the [[The First Rule of Using TiddlyWiki]]: //You are responsible for looking after your own data; take care to make backups, especially when upgrading the ~TiddlyWiki core// <<< -Remember that TiddlyWiki version 5 is not fully backwards compatible with the older TiddlyWikiClassic. - ! Online upgrading This process will work on most desktop browsers. Note that none of your personal data leaves your browser with this process. @@ -34,7 +36,9 @@ You can also download http://tiddlywiki.com/upgrade.html locally and perform the ! Problems with Upgrades -Particularly during the beta, it is possible for a customisation applied in a previous version to break when upgraded to the latest version. There are two techniques you can use to help track down issues: +It is possible for a customisation applied in a previous version to break when upgraded to the latest version. There are two techniques you can use to help track down issues: * Try repeating the upgrade having selectively unchecked any tiddlers that may be applying customisations to TiddlyWiki * Use SafeMode to disable all customisations of shadow tiddlers + +You can see which shadow tiddlers have been overridden in the ''Filter'' tab of [[advanced search|$:/AdvancedSearch]]. Select "Overridden shadow tiddlers" from the dropdown. diff --git a/editions/tw5.com/tiddlers/howtos/Video Tutorials.tid b/editions/tw5.com/tiddlers/howtos/Video Tutorials.tid deleted file mode 100644 index 51ab83806..000000000 --- a/editions/tw5.com/tiddlers/howtos/Video Tutorials.tid +++ /dev/null @@ -1,25 +0,0 @@ -created: 20131206172428247 -modified: 20140912140340663 -tags: Learning -title: Video Tutorials -type: text/vnd.tiddlywiki - -The aim is to curate a series of videos to guide people through getting up and running with TiddlyWiki. [[Contributions|HelpingTiddlyWiki]] are welcome. - -! Getting Started - -{{Getting Started Video}} - -! Using TiddlyWiki on Firefox for Android - -{{TiddlyWiki on Firefox for Android Video}} - -! Introduction to TiddlyDesktop - -{{Introducing TiddlyDesktop Video}} - -! OXTWIG - -This video of the second [[OXTWIG]] meeting starts with a tutorial overview demonstrating how to use ~TiddlyWiki in different scenarios: - - diff --git a/editions/tw5.com/tiddlers/learning/Learning.tid b/editions/tw5.com/tiddlers/learning/Learning.tid index d31597084..0318a2f3b 100644 --- a/editions/tw5.com/tiddlers/learning/Learning.tid +++ b/editions/tw5.com/tiddlers/learning/Learning.tid @@ -1,6 +1,7 @@ caption: Learning TiddlyWiki created: 20140912140047779 -modified: 20140912140144905 +list: Videos [[Introduction to Filters]] [[Sharing a TiddlyWiki on Dropbox]] [[Sharing your tiddlers with others]] [[Copying tiddlers between TiddlyWiki files]] [[Creating SubStories]] [[Editing Tiddlers with Emacs]] [[ImageGallery Example]] [[Making curved text with SVG]] TaskManagementExample [[Adding a Twitter Follow button]] [[Philosophy of Tiddlers]] [[Adopt a Titles Policy]] +modified: 20140919161721584 tags: TableOfContents title: Learning type: text/vnd.tiddlywiki @@ -8,3 +9,4 @@ type: text/vnd.tiddlywiki Learn more about using TiddlyWiki: <> + diff --git a/editions/tw5.com/tiddlers/macros/TableOfContentsMacro.tid b/editions/tw5.com/tiddlers/macros/TableOfContentsMacro.tid index 17c6583a4..080ad788f 100644 --- a/editions/tw5.com/tiddlers/macros/TableOfContentsMacro.tid +++ b/editions/tw5.com/tiddlers/macros/TableOfContentsMacro.tid @@ -1,11 +1,13 @@ -title: TableOfContentsMacro -tags: Macros -modified: 20140905084423561 caption: toc +created: 20140919155729620 +modified: 20140919155735567 +tags: Macros +title: TableOfContentsMacro +type: text/vnd.tiddlywiki The table of contents macro produces a hierarchical tree of tiddlers based on their tags. -The top level entries of the table of contents are defined by a root tag. The subentries under each of those entries are tagged with the title of the entry. Entries can be ordered using the `list` field of the tag tiddler as described in TiddlerTags. +The top level entries of the table of contents are defined by a root tag. The subentries under each of those entries are tagged with the title of the entry. Entries can be ordered using the `list` field of the tag tiddler as described in [[Tagging]]. The text for each entry is taken from the ''caption'' field if it is present, otherwise the ''title'' is used. diff --git a/editions/tw5.com/tiddlers/saving/Saving with Encryption.tid b/editions/tw5.com/tiddlers/saving/Saving with Encryption.tid index 4a37f8ee6..1d97b8768 100644 --- a/editions/tw5.com/tiddlers/saving/Saving with Encryption.tid +++ b/editions/tw5.com/tiddlers/saving/Saving with Encryption.tid @@ -1,15 +1,17 @@ created: 20130825160900000 -modified: 20140912140822643 +modified: 20140919160407215 tags: Features [[Working with TiddlyWiki]] title: Encryption type: text/vnd.tiddlywiki When used as a single HTML file, TiddlyWiki5 allows content to be encrypted using the [[Stanford JavaScript Crypto Library]]. -# Switch to the ''Tools'' tab in the sidebar and look for the words //This wiki is not encrypted// and a button labelled ''Set password'' -# Click ''Set password'' -# Type a password and click the ''Set'' button (or use the enter key) -# The control panel should now say //This wiki is encrypted// with buttons for changing and clearing the password -# Save the wiki using the button in the sidebar +# Switch to the ''Tools'' tab in the sidebar and look for the button with a padlock icon + +# If the button is labelled "set password" then the current wiki is not encrypted. Clicking the button will prompt for a password that will be used to encrypt subsequent saves + +# If the button is labelled "clear password" then the current wiki is already encrypted. Clicking the button will remove the password so that subsequent saves will be unencrypted + # Optionally, open the saved file in a text editor and verify that your data is encrypted + # Open the file in your browser. You will be prompted for a password before the content is displayed diff --git a/editions/tw5.com/tiddlers/tocproject/Navigating between open tiddlers.tid b/editions/tw5.com/tiddlers/tocproject/Navigating between open tiddlers.tid index 508479503..e9b02099b 100644 --- a/editions/tw5.com/tiddlers/tocproject/Navigating between open tiddlers.tid +++ b/editions/tw5.com/tiddlers/tocproject/Navigating between open tiddlers.tid @@ -1,15 +1,21 @@ -title: Navigating between open tiddlers +created: 20140908092600000 +modified: 20140919154732676 tags: [[Working with TiddlyWiki]] -created: 201409080926 -modified: 201409080926 +title: Navigating between open tiddlers +type: text/vnd.tiddlywiki In the default 'classic' storyview mode, open tiddlers are displayed in a vertical column called the 'story river.' There are a number of ways you can 'navigate the story river' - that is, how you can jump back and forth between the open tiddlers. -*One obvious way is to ''scroll the page up and down'' using the story river scrollbar to the right. -**Note that when both the story river and the sidebar extend below the visible screen, there will be //two// scrollbars. The outer or far-right scrollbar controls the story river. The inner scrollbar controls the sidebar. -*One clunky way that many new users attempt is to ''close tiddlers one by one'' until they get to the tiddler they are looking for. -**Closing any tiddler at the top or in the middle of the story river will cause all the tiddlers below it to slide up the river. The tiddler immediately below the tiddler you closed will slide up to take its place. -**Closing the bottom tiddler will close it and the bottom of the tiddler above it will come into view. -**Closing a tiddler in the middle of the story river will cause -*The best approach is to ''use the open tab'' in the sidebar to click on the open tiddler to which you wish to navigate. -**The 'Open' tab contains a list of all the open tiddlers. You can click on any tiddler in the list to jump to it, or click the 'x' next to a tiddler link to close it. There is also a handy 'close all' button at the bottom of the list of open tiddlers. +* One obvious way is to ''scroll the page up and down'' using the story river scrollbar to the right. + +** Note that when both the story river and the sidebar extend below the visible screen, there will be //two// scrollbars. The outer or far-right scrollbar controls the story river. The inner scrollbar controls the sidebar. + +* One clunky way that many new users attempt is to ''close tiddlers one by one'' until they get to the tiddler they are looking for. + +** Closing any tiddler at the top or in the middle of the story river will cause all the tiddlers below it to slide up the river. The tiddler immediately below the tiddler you closed will slide up to take its place. + +** Closing the bottom tiddler will close it and the bottom of the tiddler above it will come into view. + +* The best approach is to ''use the open tab'' in the sidebar to click on the open tiddler to which you wish to navigate. + +** The 'Open' tab contains a list of all the open tiddlers. You can click on any tiddler in the list to jump to it, or click the 'x' next to a tiddler link to close it. There is also a handy 'close all' button at the bottom of the list of open tiddlers. diff --git a/editions/tw5.com/tiddlers/tocproject/Using links to navigate.tid b/editions/tw5.com/tiddlers/tocproject/Using links to navigate.tid index dc1e34588..390ab1b35 100644 --- a/editions/tw5.com/tiddlers/tocproject/Using links to navigate.tid +++ b/editions/tw5.com/tiddlers/tocproject/Using links to navigate.tid @@ -1,30 +1,53 @@ -title: Using links to navigate between tiddlers +created: 20140908093600000 +modified: 20140919155030759 tags: [[Working with TiddlyWiki]] -created: 201409080936 -modified: 201409080936 +title: Using links to navigate between tiddlers +type: text/vnd.tiddlywiki -You can use internal hyperlinks (links between tiddlers, normally displayed in blue text) to navigate between your tiddlers. Clicking on the link to any tiddler will take you to that tiddler. If the tiddler is closed, it will be opened. The wonderful thing about ~Tiddlywiki is that it has made links to tiddlers as accessible as possible. There are links everywhere! Here are the key places where you can find links to tiddlers in ~TiddlyWiki: +You can use internal hyperlinks (links between tiddlers, normally displayed in blue text) to navigate between your tiddlers. Clicking on a link to any tiddler will take you to that tiddler. If the tiddler is closed, it will be opened. The wonderful thing about ~Tiddlywiki is that it has made links to tiddlers as accessible as possible. There are links everywhere! Here are the key places where you can find links to tiddlers in ~TiddlyWiki: -*You can ''create a link'' to a tiddler, whether it exists yet or not, in the body of any tiddler. See [[Linking in Wikitext]] to see the various, easy ways to create links between tiddlers. -*Each ''tag pill'' found in your tiddler (such as the 'Working with TiddlyWiki' tag pill under the title of this tiddler) contains a link to that tag tiddler, as well a lists of all the tiddlers tagged with that tag. This allows you to go to any of those tiddlers. -*The ''~TiddlerInfo section'' of each tiddler, accessed by clicking the {{$:/core/images/info-button}} button at the top of the tiddler, gives you access to four additional lists of tiddlers related to your tiddler: -**The ''References'' tab lists all the tiddlers that contain links back to the current tiddler. -**The ''Tagging'' tab lists all the tiddlers which are tagged with the current tiddler's title. -**The ''List'' tab lists all the tiddlers or potential tiddlers contained in the list field of the current tiddler. See [[ListField]] for more on list fields. -**The ''Listed'' tab lists all the tiddlers which contain the current tiddler in their list fields. -*The ''sidebar tabs'' contain numerous lists of links to tiddlers: -**The ''Open'' tab lists all currently open tiddlers. -**The ''Recent'' tab lists the 100 most recently modified tiddlers, beginning with the most recently modified. -**The ''More'' tab contains eight additional lists of tiddlers: -***''All'' lists all tiddlers, ordered alphabetically. -***''Tags'' lists all the tags. You can click on the pill for any tag to access a list of the tiddlers tagged with that tag. -***''Missing'' lists all the hyperlinks found in tiddler text for which no tiddler currently exists. This is helpful for finding tiddlers you at some point expected to create, but never got around to creating. -***''Drafts'' lists all unfinished tiddlers still in edit mode. A tiddler draft is considered a separate tiddler by ~TiddlyWiki until it is closed, so if you edit a tiddler entitled "Australia," there will then be two tiddlers, 'Australia' and 'Draft of "Australia."' When you save or cancel your changes to close the draft, it will apply those changes to the 'Australia' tiddler. So treat the Drafts tab as a way of finding any unfinished drafts you started. -***''Orphans'' lists all the tiddlers which are not related to any other tiddler by links, tags or lists. This is a helpful aid to editing your file - it shows you the tiddlers that need to be integrated more carefully with the other tiddlers. -***''Types'' lists tiddlers by special content types, such as images. -***''System'' lists all SystemTiddlers. -***''Shadows'' lists all ShadowTiddlers. -*''Search results'' are lists of tiddlers that match the text you enter into the search window. -*Finally, you can create your own custom lists of tiddlers by various methods. These -**You can transclude a TiddlerFilter (see [[Transclusion in WikiText]]). For example, adding `{{ [tag[mountain]] }}` to a tiddler will insert a list of all tiddlers tagged with 'mountain.' -**You can create a ListWidget. This is more complicated than transcluding a ~TiddlerFilter, but in return allows you more flexibility in designing and displaying the list exactly as you want it to appear. +* You can ''create a link'' to a tiddler, whether it exists yet or not, in the body of any tiddler. See [[Linking in Wikitext]] to see the various, easy ways to create links between tiddlers. + +* Each ''tag pill'' found in your tiddler (such as the 'Working with ~TiddlyWiki' tag pill under the title of this tiddler) contains a link to that tag tiddler, as well a lists of all the tiddlers tagged with that tag. This allows you to go to any of those tiddlers. + +* The ''~TiddlerInfo section'' of each tiddler, accessed by clicking the {{$:/core/images/info-button}} button at the top of the tiddler, gives you access to four additional lists of tiddlers related to your tiddler: + +** The ''References'' tab lists all the tiddlers that contain links back to the current tiddler. + +** The ''Tagging'' tab lists all the tiddlers which are tagged with the current tiddler's title. + +** The ''List'' tab lists all the tiddlers or potential tiddlers contained in the list field of the current tiddler. See [[ListField]] for more on list fields. + +** The ''Listed'' tab lists all the tiddlers which contain the current tiddler in their list fields. + +* The ''sidebar tabs'' contain numerous lists of links to tiddlers: + +** The ''Open'' tab lists all currently open tiddlers. + +** The ''Recent'' tab lists the 100 most recently modified tiddlers, beginning with the most recently modified. + +** The ''More'' tab contains eight additional lists of tiddlers: + +*** ''All'' lists all tiddlers, ordered alphabetically. + +*** ''Tags'' lists all the tags. You can click on the pill for any tag to access a list of the tiddlers tagged with that tag. + +*** ''Missing'' lists all the hyperlinks found in tiddler text for which no tiddler currently exists. This is helpful for finding tiddlers you at some point expected to create, but never got around to creating. + +*** ''Drafts'' lists all unfinished tiddlers still in edit mode. A tiddler draft is considered a separate tiddler by ~TiddlyWiki until it is closed, so if you edit a tiddler entitled "Australia," there will then be two tiddlers, 'Australia' and 'Draft of "Australia."' When you save or cancel your changes to close the draft, it will apply those changes to the 'Australia' tiddler. So treat the Drafts tab as a way of finding any unfinished drafts you started. + +*** ''Orphans'' lists all the tiddlers which are not related to any other tiddler by links, tags or lists. This is a helpful aid to editing your file - it shows you the tiddlers that need to be integrated more carefully with the other tiddlers. + +*** ''Types'' lists tiddlers by special content types, such as images. + +*** ''System'' lists all SystemTiddlers. + +*** ''Shadows'' lists all ShadowTiddlers. + +* ''Search results'' are lists of tiddlers that match the text you enter into the search window. + +* Finally, you can create your own custom lists of tiddlers by various methods: + +** You can transclude a TiddlerFilter (see [[Transclusion in WikiText]]). For example, adding `{{ [tag[mountain]] }}` to a tiddler will insert a list of all tiddlers tagged with 'mountain'. + +** You can use the ListWidget. This is more complicated than transcluding a ~TiddlerFilter, but in return allows you more flexibility in designing and displaying the list exactly as you want it to appear. diff --git a/editions/tw5.com/tiddlers/tocproject/Working with TiddlyWiki.tid b/editions/tw5.com/tiddlers/tocproject/Working with TiddlyWiki.tid index 85315b93c..34bb2bd22 100644 --- a/editions/tw5.com/tiddlers/tocproject/Working with TiddlyWiki.tid +++ b/editions/tw5.com/tiddlers/tocproject/Working with TiddlyWiki.tid @@ -1,6 +1,6 @@ created: 20140904101100000 -list: [[The First Rule of Using TiddlyWiki]] GettingStarted [[Getting Started Video]] Upgrading [[Navigating between open tiddlers]] [[Using links to navigate between tiddlers]] [[Searching in TiddlyWiki]] [[Creating and editing tiddlers]] [[Formatting text in TiddlyWiki]] [[Structuring TiddlyWiki]] Tagging [[Images in TiddlyWiki]] ImportTiddlers [[Copying tiddlers between TiddlyWiki files]] [[Introduction to Filters]] KeyboardShortcuts Saving [[Encryption]] [[Sharing a TiddlyWiki on Dropbox]] [[Sharing your tiddlers with others]] [[Philosophy of Tiddlers]] -modified: 20140916132815529 +list: [[The First Rule of Using TiddlyWiki]] GettingStarted [[Getting Started Video]] Upgrading [[Navigating between open tiddlers]] [[Using links to navigate between tiddlers]] [[Searching in TiddlyWiki]] [[Creating and editing tiddlers]] Saving [[Formatting text in TiddlyWiki]] [[Structuring TiddlyWiki]] Tagging [[Images in TiddlyWiki]] KeyboardShortcuts Encryption +modified: 20140919160930853 tags: TableOfContents title: Working with TiddlyWiki type: text/vnd.tiddlywiki @@ -8,3 +8,4 @@ type: text/vnd.tiddlywiki Information to help you get started using TiddlyWiki: <> + diff --git a/editions/tw5.com/tiddlers/videos/Getting Started Video.tid b/editions/tw5.com/tiddlers/videos/Getting Started Video.tid index 6b86f2c2b..03d430b61 100644 --- a/editions/tw5.com/tiddlers/videos/Getting Started Video.tid +++ b/editions/tw5.com/tiddlers/videos/Getting Started Video.tid @@ -1,9 +1,11 @@ created: 20140104134911101 -modified: 20140916132657350 -tags: Learning Videos [[Working with TiddlyWiki]] +modified: 20140919161039197 +tags: Videos [[Working with TiddlyWiki]] title: Getting Started Video type: text/vnd.tiddlywiki -This brief tutorial takes you through the basics of saving changes with a standalone TiddlyWiki5 file. +This brief tutorial takes you through the basics of saving changes with a standalone TiddlyWiki file. + +//Note that the video is a bit out of date, and will be updated soon!// \ No newline at end of file diff --git a/editions/tw5.com/tiddlers/videos/Videos.tid b/editions/tw5.com/tiddlers/videos/Videos.tid index 41f2c1e75..b6d59ea34 100644 --- a/editions/tw5.com/tiddlers/videos/Videos.tid +++ b/editions/tw5.com/tiddlers/videos/Videos.tid @@ -1,9 +1,11 @@ created: 20140912150153512 -modified: 20140912150242763 +modified: 20140919161220608 tags: Learning title: Videos type: text/vnd.tiddlywiki -The following TiddlyWiki videos are available +The following TiddlyWiki videos are available. <> + +The aim is to curate a series of videos to guide people through getting up and running with TiddlyWiki. [[Contributions|Contributing]] are welcome. \ No newline at end of file diff --git a/editions/tw5.com/tiddlers/workingwithtw/Sharing tiddlers with others.tid b/editions/tw5.com/tiddlers/workingwithtw/Sharing tiddlers with others.tid index e4de2ce5f..a9fadb223 100644 --- a/editions/tw5.com/tiddlers/workingwithtw/Sharing tiddlers with others.tid +++ b/editions/tw5.com/tiddlers/workingwithtw/Sharing tiddlers with others.tid @@ -1,7 +1,8 @@ +created: 20140908163900000 +modified: 20140919160707386 +tags: Learning title: Sharing your tiddlers with others -tags: [[Working with TiddlyWiki]] -created: 201409081639 -modified: 201409081639 +type: text/vnd.tiddlywiki There are a number of ways that people can share tiddlers back and forth: @@ -11,4 +12,4 @@ There are a number of ways that people can share tiddlers back and forth: **A permalink to a specific tiddler (see [[PermaLinks]]) **A permaview link of all the currently open tiddlers (see [[PermaView]]) *You can grab tiddlers from ~TiddlyWikis that others have published online by clicking on a link to the tiddler within their file, and then dragging and dropping the link into your own file. An import tiddler will appear, and you can click to import the tiddler or tiddlers to your file. -*You can share a link on Twitter. See [[Adding a Twitter Follow button]]. +* You can [[share a Dropbox link to your TiddlyWiki|Sharing a TiddlyWiki on Dropbox]]