Skip to content
A JSON extention plugin for Tiddlywiki
Branch: master
Clone or download
Latest commit 3102406 Mar 12, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
macro
modules v2.0.4 final Mar 11, 2019
patch/core/modules v2.0.4 Mar 10, 2019
patchSource/core/modules
readme v2.0.4 final Mar 11, 2019
skeletons
ui re-init Mar 1, 2019
widgets
icon.svg
icon.svg.meta re-init Mar 1, 2019
license.md
license.md.meta
license.tid re-init Mar 1, 2019
plugin.info
readme.md
readme.md.meta v2.0.4 final Mar 11, 2019
readme.tid readme Mar 12, 2019

readme.md

readme.md

9th March 2019 at 11:20pm

Hello There

TW5-JsonManglerPlugin by Joshua Fontany, v 2.0.4

This plugin changes the methods tiddlywiki uses to retrieve and set values in json data tiddlers. It does so in a way that aims for backwards compatibility.

It introduces new features, widgets, and filter operators to manage, edit, and view json tiddlers:

  • Allows TextReferences to target nested values ("complex json").
  • An automatic alert when calling actions on an invalid json data tiddler, or when plugin tiddlers have been edited.
  • New buttons in the editTemplate for 'application/json' data tiddlers.
  • $jsonmangler, a widget that catches messages to edit json data tiddlers (used in the editTemplate).
  • A new $:/ControlPanel tab, Plugin Management which allows plugin creation and editing using the new json libraries.
  • New filter operators:
    • An updated indexes[] operator that can show all index paths. If given the argument verbose, it will list all paths, including the root path to nested objects and arrays.
    • A new hasindex[] operator that returns only those input tiddlers that have a value at the index path supplied.
    • A new tsort[] operator that uses a tokenized sorting method to resolve pesky sorting problems.
    • A new pair of filter operators: encodeindex[] and decodeindex[]. These are used to "escape" or "unescape" the index path separation character / (and the encoding character ~ ). This can be used to build paths with literal /s in a key name token. This is very useful and must be studied closely.
    • A new encodetiddler[] operator, which returns each tiddler in the input as a full json object. Used with the previous pair of operators, this can be used to pack plugin tiddlers.

Installation

JsonMangler requires the following excellent plugins:

Thanks you two!

Single-file .html wikis / Node served tid files saved to wiki folder

Drag and drop the following links to install the plugins, then restart your server and(or) refresh your wiki.

Node served from TiddlyWiki's plugin folder

Use Git to clone my master repository into a folder in your TiddlyWiki5 repo's plugin folder, ./plugins/joshuafontany/jsonmangler/ .

Alternately, you can use single-file plugin.info versions under node,js, which are found in the Releases tab.

Go to Json Mangler Github Releases and download the latest *.zip file.

Place the *.zip file in your .\TiddlyWiki5 directory, right click and select Extract Here (7zip) or Extract to here (Winzip).

A plugin.info (json) file containing all the tiddlers for each required plugin will then be placed in the right folders within your .\TiddlyWiki5\plugins folder.

Edit any wiki's tiddlywiki.info file to include the following in the plugins array.

"joshuafontany/jsonmangler",
"matabele/action-maketid",
"ebalster/modloader"

Finally, restart your server.

Important Info

Further documentation is available in the example wiki:

https://joshuafontany.github.io/TW5-JsonManglerPlugin/

This plugin is a work in progress; please report any issues on GitHub: https://github.com/joshuafontany/TW5-JsonManglerPlugin/issues

If you find this useful and would care to donate, please use my PayPal: https://paypal.me/JoshuaFontany

You can’t perform that action at this time.