TiddlyWiki is a personal wiki and a non-linear notebook for organising and sharing complex information. It is an open-source single page application wiki in the form of a single HTML file that includes CSS, JavaScript, embedded files such as images, and the text content. It is designed to be easy to customize and re-shape depending on application. It facilitates re-use of content by dividing it into small pieces called Tiddlers.

TiddlyWiki
Developer(s)Jeremy Ruston and community members
Initial release30 September 2004; 20 years ago (2004-09-30)
Stable release
5.3.5[1] Edit this on Wikidata / 2024-07-10; 3 months ago
Repository
Written inJavaScript
Operating systemCross-platform
Available inMultilingual, over 30 languages in TiddlyWiki 5.1.23.[2]
TypeWiki
LicenseBSD-3-Clause[3]
Websitetiddlywiki.com Edit this on Wikidata
A standard tiddler edit dialogue box on TiddlyWiki 5.2.0

TiddlyWiki is an unusual example of a practical quine. The idea of producing a copy of its own source code lies at the heart of TiddlyWiki's ability to independently save changes to itself. Quine is also the name of the unofficial TiddlyWiki application for iPhone/iPad.[4]

Applications

edit

TiddlyWiki is designed for customization and to be shaped according to users' specific needs, perhaps comparable to a high-level programming language. As such, it can be used for a wide and knowledge domain-agnostic range of special applications. Examples include niche note-taking applications, to-do lists, presentations, collections, authoring tools, personal databases, recipe collections, etc.

Although there are many TiddlyWiki documents on the Web,[5][6] the majority of TiddlyWikis reside on personal computers or in the cloud, or are exchanged by email, in a manner similar to word processing documents and spreadsheets. As a single HTML file, or saved as an HTA file in Microsoft Windows (allowing corporate IE lockdown to be bypassed), TiddlyWiki can be useful in corporate environments where red tape or IT resources might prevent the use of a wiki that requires a more complicated installation.[7]

TiddlyWiki has been used as a software framework to build specialisations such as the following:

Tiddlers

edit

TiddlyWiki introduces the division of content into its "smallest, semantically meaningful, components", referred to as tiddlers.[citation needed] Each tiddler is stored inside an HTML division that contains the source text and meta data in wiki markup. The purpose with this division is to enable easy re-use of content for different narratives and in different contexts.

For example, this section ("Tiddlers") could be a tiddler. In the TiddlyWiki user interface it would appear as it appears here but as a separate "note" visually distinct from other tiddlers.

The underlying HTML source code (which is not typically directly viewed or modified by end users) would be something like:

<div title="Tiddlers"
    modifier="John Smith"
    created="200811132220"
    modified="200811132225"
    changecount="3"
    tags="Wikipedia section example code">
    <pre>TiddlyWiki introduces the division of...</pre>

This same "tiddler" could then be reused in other contexts in the wiki.

Plugins

edit

In addition to containing text, a tiddler can be a plugin with additional JavaScript and CSS to extend TiddlyWiki. As a result, TiddlyWiki is used in a wide variety of adaptations and uses beyond that of a personal wiki.

Popular community plugins include interactive graph visualization or mind maps with TiddlyMap,[9][10] project management with Projectify,[11] integration with the spaced-repetition-flashcards tool Anki with TiddlyRemember,[12] mathematical typesetting based on KaTeX[13] or MathJax,[14] adding a Disqus-based comment system,[15] and enabling standard Markdown markup.[16]

File saving

edit

TiddlyWiki may be saved as a single html file containing both the data (tiddlers) and the application (wiki), or the data can be saved on a per tiddler basis in text files (via extensions).

A TiddlyWiki opened from a file URI may save changes made back to the original file using one of the following techniques:

  • the Microsoft ActiveX FileSystemObject for Internet Explorer
  • TiddlySaver Java applet to extend Safari, Opera, Chrome/Chromium, and other browsers. Requires the Java runtime.
  • Two techniques were developed for the Firefox browser:
    • Mozilla File I/O under the control of the UniversalXPConnect per-file preferences. That functionality was later removed from Firefox.
    • The TiddlyFox add-on for Firefox uses the Firefox SDK's simple-storage API. The add-on stopped working with Firefox around version 57 in 2017 which does not support the API.[17]

History

edit
  • The first version of TiddlyWiki was released by Jeremy Ruston in September 2004.[18]
  • BT Group bought Osmosoft in 2007[19][20] appointing Ruston as BT's "Head of Open Source Innovation".[21]
  • TiddlyWiki was selected as one of the Top 100 Tools for 2007 and 2008 by the Centre for Learning & Performance Technologies.[22]
  • In November 2011, Jeremy Ruston announced his departure from Osmosoft and commitment to continue development on TiddlyWiki.[23][24]
  • In December 2013 TiddlyWiki5 was released. It is a total rebuild of the original TiddlyWiki, based on HTML5 and with many significant improvements from lessons learnt over the years with the original TiddlyWiki. The original TiddlyWiki has come to be called TiddlyWiki Classic.[25]
  • 2023-08: Release of
    • TWv5.3.0 the newest "Stable release", and
    • TWv.5.3.1 (trivial backward compatibility patches)

License

edit

TiddlyWiki is free and open source software and is distributed under the terms of the BSD-3-Clause license.[3]

The copyright of TiddlyWiki is held in trust by UnaMesa,[26] a non-profit organization.

See also

edit

References

edit
  1. ^ "Release 5.3.5". 10 July 2024. Retrieved 28 July 2024.
  2. ^ "TiddlyWiki Translations". TiddlyWiki Trac Wiki. TiddlyWiki Development team. 2004–2015. Archived from the original on January 24, 2015. Retrieved 20 January 2011.
  3. ^ a b "TiddlyWiki — a non-linear personal web notebook". tiddlywiki.com. Retrieved Jun 24, 2020.
  4. ^ "Quine". tiddlywiki.com. Retrieved 2021-04-17.
  5. ^ "TiddlyWiki — a non-linear personal web notebook". tiddlywiki.com. Retrieved 2018-08-24.
  6. ^ "TiddlyWiki toolmap - Dynalist". dynalist.io. Retrieved 2018-08-24.
  7. ^ "Guerilla wiki". Tech Writer Wiki. Archived from the original on 2012-06-29. Retrieved 2022-02-07.
  8. ^ Farber, Dan. "Socialtext for the sometimes connected". ZDNET. Retrieved 13 March 2024.
  9. ^ "TiddlyWiki — a non-linear personal web notebook". tiddlywiki.com. Retrieved 2018-08-24.
  10. ^ "TiddlyMap - Wiki-Based Concept-Mapping Software". TiddlyMap.org. 2018-08-24.
  11. ^ "Projectify — Manage projects in TiddlyWiki". projectify.wiki. Retrieved 2021-10-04.
  12. ^ "TiddlyRemember — Embed Anki notes in your TiddlyWiki". sobjornstad.github.io. Retrieved 13 March 2024.
  13. ^ "KaTeX Demo — a demo of the KaTeX plugin for TiddlyWiki5". tiddlywiki.com.
  14. ^ "MathJax Plugin by Martin Kantor: TiddlyWiki — a non-linear personal web notebook". tiddlywiki.com. Retrieved 13 March 2024.
  15. ^ "Disqus comments plugin by bimlas: TiddlyWiki — a non-linear personal web notebook". tiddlywiki.com. Retrieved 13 March 2024.
  16. ^ "markdowndemo — a demo of the Markdown plugin for TiddlyWiki5". tiddlywiki.com. Retrieved 13 March 2024.
  17. ^ "Add-ons - simple-storage". MDN Web Docs. Mozilla.org. 2017-01-14. Retrieved 2017-10-20. Starting from Firefox 57, only extensions developed using WebExtensions APIs will be supported on Desktop Firefox and Firefox for Android.
  18. ^ "TiddlyWiki a reusable non-linear personal web notebook".
  19. ^ jermolene (May 29, 2007). "I For One Welcome My New BT Overlords". Treat with Jermolene. Archived from the original on 2011-08-18.
  20. ^ "Telco 2.0: BT Tries To Fix Global Services with Open Source". Telco2.net. Retrieved 2012-05-23.
  21. ^ "Open Source Will Change Enterprises, Says BT Guru". TechWeekEurope UK. Eweekeurope.co.uk. 2009-10-16. Archived from the original on 2010-02-28. Retrieved 2012-05-23.
  22. ^ Hart, Jane (13 August 2011). "Top Tools: Tiddlywiki". Centre for Learning & Performance Technologies. Archived from the original on 2011-12-08. Retrieved February 2, 2017.
  23. ^ "On Leaving BT and Osmosoft - TiddlyWiki | Google Groups". Retrieved 2012-05-23.
  24. ^ Rejali, Cameron. "Jeremy Ruston to leave BT". Osmosoft. Archived from the original on April 19, 2005.
  25. ^ "TiddlyWiki — a non-linear personal web notebook". tiddlywiki.com. Retrieved Jun 24, 2020.
  26. ^ "UnaMesa Association". unamesa.org. Retrieved 2018-08-24.
edit