abegoExtensions

abegoExtensions News

Thu, 29 Sep 2011 09:10:49 GMT

2011-09-29

Added info on using the IncludePlugin in the Opera or Chrome browser. Thanks to Yakov Litvin for this.

2011-05-23

Release PartTiddlerPlugin v1.0.10
- Adapt to TW 2.6.2 default behaviour when existing tiddlers are opened (don't select text) and fixed Firefox 4 issue. Thanks to dave for reporting the issue.

2011-01-20

Added the ForEachTiddlerPlugin example 'Create a table with one column per tiddler ("Vertical Report")' and 'Create a table with one row per tiddler ("Horizontal Report")'.

2010-02-16

YourSearchPlugin v2.1.5 released
- Fixed problems with CSS and search textfield. Thanks to Guido Glatzel for reporting.

2009-12-29

Added the ForEachTiddlerPlugin example 'List all tasks completed on a journal tiddler's day, as a "Daily Status Report"'. Based on an idea by cmari and Alan Cohen. Thanks.

2009-10-09

Revised the NewTiddlerWithFormMacro documentation

2009-09-04

YourSearchPlugin v2.1.4 released
- Fixed "this command is not supported" error under IE 8. Thanks to rouilj for reporting. (For details see: http://groups.google.com/group/TiddlyWiki/browse_thread/thread/cffee3254381e478)

2008-05-04

Improved TiddlyWiki style for better appearance in Safari

2008-04-16

YourSearchPlugin v2.1.3 released
- Fixed problem with Firefox3. Thanks to Andreas Hoefler for reporting.

2008-03-17

YourSearchPlugin v2.1.2 released
- Bugfix: on IE (6.0) the first letter is dropped from the search string. Thanks to Kashgarinn and Nick Padfield for reporting.

^{For older news see the revision history of the various plugins.}

Troubleshooting the IncludePlugin

Thu, 29 Sep 2011 09:08:08 GMT

If you have problems running the IncludePlugin you may try this:

Have a look at the PluginManager if the IncludePlugin is installed correctly.
If the IncludePlugin is installed correctly go to the AdvancedOptions and look for the checkbox "Include TiddlyWikis". This must be checked.
If "Include TiddlyWikis" is checked click on the IncludeState link next to the checkbox. This reports problems related to every included TiddlyWiki.
Be aware only TiddlyWikis listed in the IncludeList of the "main" TiddlyWiki are included. Any IncludeList of included TiddlyWikis is ignored (i.e. the IncludePlugin does not work "recursively".)
Running IncludePlugin in the Opera or Chrome browser is not officially supported, but people report it also works fine with these browsers. However you may need to "allow file access" through browser specific options, e.g. opera:config#UserPrefs|AllowFileXMLHttpRequest for Opera, and --allow-file-access-from-files for Chrome. For details see: http://groups.google.com/group/tiddlywiki/browse_thread/thread/392be3c984a1fb33

IncludePlugin

Tue, 26 Jul 2011 16:41:00 GMT

Name:	abego.IncludePlugin
Version:	1.0.1 (2007-04-30)
Type:	plugin
Source:	http://tiddlywiki.abego-software.de/#IncludePlugin
Author:	Udo Borkowski (ub [at] abego-software [dot] de)
Documentation:	IncludePlugin Documentation
Community:	(del.icio.us) (Support)
Copyright:	© 2007 abego Software
Licence:	BSD open source license (abego Software)
CoreVersion:	2.1.3
Browser:	Firefox 1.5.0.9 or better; Internet Explorer 6.0

This plugin's source code is compressed (and hidden). Use this link to get the readable source code.

PartTiddlerPlugin

Mon, 23 May 2011 08:05:00 GMT

Name:	PartTiddlerPlugin
Version:	1.0.10 (2011-05-23)
Source:	http://tiddlywiki.abego-software.de/#PartTiddlerPlugin
Author:	UdoBorkowski (ub [at] abego-software [dot] de)
Licence:	BSD open source license
CoreVersion:	2.1.3
Browser:	Firefox 1.0.4+; InternetExplorer 6.0

Table of Content

Description

With the <part aPartName> ... </part> feature you can structure your tiddler text into separate (named) parts.
Each part can be referenced as a "normal" tiddler, using the "tiddlerName/partName" syntax (e.g. "About/Features"). E.g. you may create links to the parts (e.g. [[Quotes/BAX95]] or [[Hobbies|AboutMe/Hobbies]]), use it in <<tiddler...>> or <<tabs...>> macros etc.

Syntax:

<part partName [hidden] > any tiddler content </part>
partName	The name of the part. You may reference a part tiddler with the combined tiddler name "nameOfContainerTidder/partName. If you use a partName containing spaces you need to quote it (e.g. `"Major Overview"` or `[[Shortcut List]]`).
hidden	When defined the content of the part is not displayed in the container tiddler. But when the part is explicitly referenced (e.g. in a `<<tiddler...>>` macro or in a link) the part's content is displayed.
any tiddler content	The content of the part. A part can have any content that a "normal" tiddler may have, e.g. you may use all the formattings and macros defined.
_{Syntax formatting: Keywords in bold, optional parts in [...]. 'or' means that exactly one of the two alternatives must exist.}

_[Top]

Applications

Refering to Paragraphs of a Longer Tiddler

Assume you have written a long description in a tiddler and now you want to refer to the content of a certain paragraph in that tiddler (e.g. some definition.) Just wrap the text with a part block, give it a nice name, create a "pretty link" (like [[Discussion Groups|Introduction/DiscussionGroups]]) and you are done.

Notice this complements the approach to first writing a lot of small tiddlers and combine these tiddlers to one larger tiddler in a second step (e.g. using the <<tiddler...>> macro). Using the part feature you can first write a "classic" (longer) text that can be read "from top to bottom" and later "reuse" parts of this text for some more "non-linear" reading.

_[Top]

Citation Index

Create a tiddler "Citations" that contains your "citations".
Wrap every citation with a part and a proper name.

Example

<part BAX98>Baxter, Ira D. et al: //Clone Detection Using Abstract Syntax Trees.// 
in //Proc. ICSM//, 1998.</part>

<part BEL02>Bellon, Stefan: //Vergleich von Techniken zur Erkennung duplizierten Quellcodes.// 
Thesis, Uni Stuttgart, 2002.</part>

<part DUC99>Ducasse, Stéfane et al: //A Language Independent Approach for Detecting Duplicated Code.// 
in //Proc. ICSM//, 1999.</part>

You may now "cite" them just by using a pretty link like [[Citations/BAX98]] or even more pretty, like this [[BAX98|Citations/BAX98]].

_[Top]

Creating "multi-line" Table Cells

You may have noticed that it is hard to create table cells with "multi-line" content. E.g. if you want to create a bullet list inside a table cell you cannot just write the bullet list

* Item 1
* Item 2
* Item 3

into a table cell (i.e. between the | ... | bars) because every bullet item must start in a new line but all cells of a table row must be in one line.

Using the part feature this problem can be solved. Just create a hidden part that contains the cells content and use a <<tiddler >> macro to include its content in the table's cell.

Example

|!Subject|!Items|
|subject1|<<tiddler ./Cell1>>|
|subject2|<<tiddler ./Cell2>>|

<part Cell1 hidden>
* Item 1
* Item 2
* Item 3
</part>
...

Notice that inside the <<tiddler ...>> macro you may refer to the "current tiddler" using the ".".

BTW: The same approach can be used to create bullet lists with items that contain more than one line.

_[Top]

Creating Tabs

The build-in <<tabs ...>> macro requires that you defined an additional tiddler for every tab it displays. When you want to have "nested" tabs you need to define a tiddler for the "main tab" and one for every tab it contains. I.e. the definition of a set of tabs that is visually displayed at one place is distributed across multiple tiddlers.

With the part feature you can put the complete definition in one tiddler, making it easier to keep an overview and maintain the tab sets.

Example
The standard tabs at the sidebar are defined by the following eight tiddlers:

Instead of these eight tiddlers one could define the following SideBarTabs tiddler that uses the part feature:

<<tabs txtMainTab 
    Timeline Timeline SideBarTabs/Timeline 
    All 'All tiddlers' SideBarTabs/All 
    Tags 'All tags' SideBarTabs/Tags 
    More 'More lists' SideBarTabs/More>>
<part Timeline hidden><<timeline>></part>
<part All hidden><<list all>></part>
<part Tags hidden><<allTags>></part>
<part More hidden><<tabs txtMoreTab 
    Missing 'Missing tiddlers' SideBarTabs/Missing 
    Orphans 'Orphaned tiddlers' SideBarTabs/Orphans 
    Shadowed 'Shadowed tiddlers' SideBarTabs/Shadowed>></part>
<part Missing hidden><<list missing>></part>
<part Orphans hidden><<list orphans>></part>
<part Shadowed hidden><<list shadowed>></part>

Notice that you can easily "overwrite" individual parts in separate tiddlers that have the full name of the part.

E.g. if you don't like the classic timeline tab but only want to see the 100 most recent tiddlers you could create a tiddler "SideBarTabs/Timeline" with the following content:

<<forEachTiddler 
		sortBy 'tiddler.modified' descending 
		write '(index < 100) ? "* [["+tiddler.title+"]]\n":""'>>

_[Top]

Using Sliders

Very similar to the build-in <<tabs ...>> macro (see above) the <<slider ...>> macro requires that you defined an additional tiddler that holds the content "to be slid". You can avoid creating this extra tiddler by using the part feature

Example
In a tiddler "About" we may use the slider to show some details that are documented in the tiddler's "Details" part.

...
<<slider chkAboutDetails About/Details details "Click here to see more details">>
<part Details hidden>
To give you a better overview ...
</part>
...

Notice that putting the content of the slider into the slider's tiddler also has an extra benefit: When you decide you need to edit the content of the slider you can just doubleclick the content, the tiddler opens for editing and you can directly start editing the content (in the part section). In the "old" approach you would doubleclick the tiddler, see that the slider is using tiddler X, have to look for the tiddler X and can finally open it for editing. So using the part approach results in a much short workflow.

_[Top]

Revision history

v1.0.10 (2011-05-23)
- Adapt to TW 2.6.2 default behaviour when existing tiddlers are opened (don't select text) and fixed Firefox 4 issue. Thanks to dave for reporting the issue.
v1.0.9 (2007-07-14)
- Bugfix: Error when using the SideBarTabs example and switching between "More" and "Shadow". Thanks to cmari for reporting the issue.
v1.0.8 (2007-06-16)
- Speeding up display of tiddlers containing multiple pard definitions. Thanks to Paco Rivière for reporting the issue.
- Support "./partName" syntax inside <<tabs ...>> macro
v1.0.7 (2007-03-07)
- Bugfix: does not always render correctly after a refresh (e.g. like it happens when using the "Include" plugin). Thanks to Morris Gray for reporting the bug.
v1.0.6 (2006-11-07)
- Bugfix: cannot edit tiddler when UploadPlugin by Bidix is installed. Thanks to José Luis González Castro for reporting the bug.
v1.0.5 (2006-03-02)
- Bugfix: Example with multi-line table cells does not work in IE6. Thanks to Paulo Soares for reporting the bug.
v1.0.4 (2006-02-28)
- Bugfix: Shadow tiddlers cannot be edited (in TW 2.0.6). Thanks to Torsten Vanek for reporting the bug.
v1.0.3 (2006-02-26)
- Adapt code to newly introduced Tiddler.prototype.isReadOnly() function (in TW 2.0.6). Thanks to Paulo Soares for reporting the problem.
v1.0.2 (2006-02-05)
- Also allow other macros than the "tiddler" macro use the "." in the part reference (to refer to "this" tiddler)
v1.0.1 (2006-01-27)
- Added Table of Content for plugin documentation. Thanks to RichCarrillo for suggesting.
- Bugfix: newReminder plugin does not work when PartTiddler is installed. Thanks to PauloSoares for reporting.
v1.0.0 (2006-01-25)
- initial version

_[Top]

Code

_[Top]

//============================================================================
//                           PartTiddlerPlugin

// Ensure that the PartTiddler Plugin is only installed once.
//
if (!version.extensions.PartTiddlerPlugin) {



version.extensions.PartTiddlerPlugin = {
    major: 1, minor: 0, revision: 10,
    date: new Date(2011, 4, 23), 
    type: 'plugin',
    source: "http://tiddlywiki.abego-software.de/#PartTiddlerPlugin"
};

if (!window.abego) window.abego = {};
if (version.major < 2) alertAndThrow("PartTiddlerPlugin requires TiddlyWiki 2.0 or newer.");

//============================================================================
// Common Helpers

// Looks for the next newline, starting at the index-th char of text. 
//
// If there are only whitespaces between index and the newline 
// the index behind the newline is returned, 
// otherwise (or when no newline is found) index is returned.
//
var skipEmptyEndOfLine = function(text, index) {
	var re = /(\n|[^\s])/g;
	re.lastIndex = index;
	var result = re.exec(text);
	return (result && text.charAt(result.index) == '\n') 
			? result.index+1
			: index;
}


//============================================================================
// Constants

var partEndOrStartTagRE = /(<\/part>)|(<part(?:\s+)((?:[^>])+)>)/mg;
var partEndTagREString = "<\\/part>";
var partEndTagString = "</part>";

//============================================================================
// Plugin Specific Helpers

// Parse the parameters inside a <part ...> tag and return the result.
//
// @return [may be null] {partName: ..., isHidden: ...}
//
var parseStartTagParams = function(paramText) {
	var params = paramText.readMacroParams();
	if (params.length == 0 || params[0].length == 0) return null;
	
	var name = params[0];
	var paramsIndex = 1;
	var hidden = false;
	if (paramsIndex < params.length) {
		hidden = params[paramsIndex] == "hidden";
		paramsIndex++;
	}
	
	return {
		partName: name, 
		isHidden: hidden
	};
}

// Returns the match to the next (end or start) part tag in the text, 
// starting the search at startIndex.
// 
// When no such tag is found null is returned, otherwise a "Match" is returned:
// [0]: full match
// [1]: matched "end" tag (or null when no end tag match)
// [2]: matched "start" tag (or null when no start tag match)
// [3]: content of start tag (or null if no start tag match)
//
var findNextPartEndOrStartTagMatch = function(text, startIndex) {
	var re = new RegExp(partEndOrStartTagRE);
	re.lastIndex = startIndex;
	var match = re.exec(text);
	return match;
}

//============================================================================
// Formatter

// Process the <part ...> ... </part> starting at (w.source, w.matchStart) for formatting.
//
// @return true if a complete part section (including the end tag) could be processed, false otherwise.
//
var handlePartSection = function(w) {
	var tagMatch = findNextPartEndOrStartTagMatch(w.source, w.matchStart);
	if (!tagMatch) return false;
	if (tagMatch.index != w.matchStart || !tagMatch[2]) return false;

	// Parse the start tag parameters
	var arguments = parseStartTagParams(tagMatch[3]);
	if (!arguments) return false;
	
	// Continue processing
	var startTagEndIndex = skipEmptyEndOfLine(w.source, tagMatch.index + tagMatch[0].length);
	var endMatch = findNextPartEndOrStartTagMatch(w.source, startTagEndIndex);
	if (endMatch && endMatch[1]) {
		if (!arguments.isHidden) {
			w.nextMatch = startTagEndIndex;
			w.subWikify(w.output,partEndTagREString);
		}
		w.nextMatch = skipEmptyEndOfLine(w.source, endMatch.index + endMatch[0].length);
		
		return true;
	}
	return false;
}

config.formatters.push( {
    name: "part",
    match: "<part\\s+[^>]+>",
	
	handler: function(w) {
		if (!handlePartSection(w)) {
			w.outputText(w.output,w.matchStart,w.matchStart+w.matchLength);
		}
	}
} )

//============================================================================
// Extend "fetchTiddler" functionality to also recognize "part"s of tiddlers 
// as tiddlers.

var currentParent = null; // used for the "." parent (e.g. in the "tiddler" macro)

// Return the match to the first <part ...> tag of the text that has the
// requrest partName.
//
// @return [may be null]
//
var findPartStartTagByName = function(text, partName) {
	var i = 0;
	
	while (true) {
		var tagMatch = findNextPartEndOrStartTagMatch(text, i);
		if (!tagMatch) return null;

		if (tagMatch[2]) {
			// Is start tag
	
			// Check the name
			var arguments = parseStartTagParams(tagMatch[3]);
			if (arguments && arguments.partName == partName) {
				return tagMatch;
			}
		}
		i = tagMatch.index+tagMatch[0].length;
	}
}

// Return the part "partName" of the given parentTiddler as a "readOnly" Tiddler 
// object, using fullName as the Tiddler's title. 
//
// All remaining properties of the new Tiddler (tags etc.) are inherited from 
// the parentTiddler.
// 
// @return [may be null]
//
var getPart = function(parentTiddler, partName, fullName) {
	var text = parentTiddler.text;
	var startTag = findPartStartTagByName(text, partName);
	if (!startTag) return null;
	
	var endIndexOfStartTag = skipEmptyEndOfLine(text, startTag.index+startTag[0].length);
	var indexOfEndTag = text.indexOf(partEndTagString, endIndexOfStartTag);

	if (indexOfEndTag >= 0) {
		var partTiddlerText = text.substring(endIndexOfStartTag,indexOfEndTag);
		var partTiddler = new Tiddler();
		partTiddler.set(
						fullName,
						partTiddlerText,
						parentTiddler.modifier,
						parentTiddler.modified,
						parentTiddler.tags,
						parentTiddler.created);
		partTiddler.abegoIsPartTiddler = true;
		return partTiddler;
	}
	
	return null;
}

// Hijack the store.fetchTiddler to recognize the "part" addresses.
//
var hijackFetchTiddler = function() {
	var oldFetchTiddler = store.fetchTiddler ;
	store.fetchTiddler = function(title) {
		var result = oldFetchTiddler.apply(this, arguments);
		if (!result && title) {
			var i = title.lastIndexOf('/');
			if (i > 0) {
				var parentName = title.substring(0, i);
				var partName = title.substring(i+1);
				var parent = (parentName == ".") 
						? store.resolveTiddler(currentParent)
						: oldFetchTiddler.apply(this, [parentName]);
				if (parent) {
					return getPart(parent, partName, parent.title+"/"+partName);
				}
			}
		}
		return result;	
	};
};

// for debugging the plugin is not loaded through the systemConfig mechanism but via a script tag. 
// At that point in the "store" is not yet defined. In that case hijackFetchTiddler through the restart function.
// Otherwise hijack now.
if (!store) {
	var oldRestartFunc = restart;
	window.restart = function() {
		hijackFetchTiddler();
		oldRestartFunc.apply(this,arguments);
	};
} else
	hijackFetchTiddler();




// The user must not edit a readOnly/partTiddler
//

config.commands.editTiddler.oldIsReadOnlyFunction = Tiddler.prototype.isReadOnly;

Tiddler.prototype.isReadOnly = function() {
	// Tiddler.isReadOnly was introduced with TW 2.0.6.
	// For older version we explicitly check the global readOnly flag
	if (config.commands.editTiddler.oldIsReadOnlyFunction) {
		if (config.commands.editTiddler.oldIsReadOnlyFunction.apply(this, arguments)) return true;
	} else {
		if (readOnly) return true;
	}

	return this.abegoIsPartTiddler;
}

config.commands.editTiddler.handler_PartTiddlerPlugin = config.commands.editTiddler.handler;

config.commands.editTiddler.handler = function(event,src,title)
{
	var t = store.getTiddler(title);
	// Edit the tiddler if it either is not a tiddler (but a shadowTiddler)
	// or the tiddler is not readOnly
	if(!t || !t.abegoIsPartTiddler)
		{
		return config.commands.editTiddler.handler_PartTiddlerPlugin(event,src,title);
		}
	return false;
}

// To allow the "./partName" syntax in macros we need to hijack 
// the invokeMacro to define the "currentParent" while it is running.
// 
var oldInvokeMacro = window.invokeMacro;
function myInvokeMacro(place,macro,params,wikifier,tiddler) {
	var oldCurrentParent = currentParent;
	if (tiddler) currentParent = tiddler;
	try {
		oldInvokeMacro.apply(this, arguments);
	} finally {
		currentParent = oldCurrentParent;
	}
}
window.invokeMacro = myInvokeMacro;

// To correctly support the "./partName" syntax while refreshing we need to hijack 
// the config.refreshers.tiddlers to define the "currentParent" while it is running.
// 
(function() {
	var oldTiddlerRefresher= config.refreshers.tiddler;
	config.refreshers.tiddler = function(e,changeList) {
		var oldCurrentParent = currentParent;
		try {
			currentParent = e.getAttribute("tiddler");
			return oldTiddlerRefresher.apply(this,arguments);
		} finally {
			currentParent = oldCurrentParent;
		}
	};
})();

// Support "./partName" syntax inside <<tabs ...>> macro
(function() {
	var extendRelativeNames = function(e, title) {
		var nodes = e.getElementsByTagName("a");
		for(var i=0; i<nodes.length; i++) {
			var node = nodes[i];
			var s = node.getAttribute("content");
			if (s && s.indexOf("./") == 0)
				node.setAttribute("content",title+s.substr(1));
		}
	};
	var oldHandler = config.macros.tabs.handler;
	config.macros.tabs.handler = function(place,macroName,params,wikifier,paramString,tiddler) {
		var result = oldHandler.apply(this,arguments);
		if (tiddler)
			extendRelativeNames(place, tiddler.title);
		return result;
	};
})();

// Scroll the anchor anchorName in the viewer of the given tiddler visible.
// When no tiddler is defined use the tiddler of the target given event is used.
window.scrollAnchorVisible = function(anchorName, tiddler, evt) {
	var tiddlerElem = null;
	if (tiddler) {
		tiddlerElem = document.getElementById(story.idPrefix + tiddler);
	}
	if (!tiddlerElem && evt) {
		var target = resolveTarget(evt);
		tiddlerElem = story.findContainingTiddler(target);
	}
	if (!tiddlerElem) return;

	var children = tiddlerElem.getElementsByTagName("a");
	for (var i = 0; i < children.length; i++) {
		var child = children[i];
		var name = child.getAttribute("name");
		if (name == anchorName) {
			var y = findPosY(child);
			window.scrollTo(0,y);
			return;
		}
	}
}

} // of "install only once"

_[Top]

Licence and Copyright

Copyright (c) abego Software GmbH, 2011 (www.abego-software.de)

Redistribution and use in source and binary forms, with or without modification,
are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this
list of conditions and the following disclaimer.

Redistributions in binary form must reproduce the above copyright notice, this
list of conditions and the following disclaimer in the documentation and/or other
materials provided with the distribution.

Neither the name of abego Software nor the names of its contributors may be
used to endorse or promote products derived from this software without specific
prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
DAMAGE.

_[Top]

MainMenu

Thu, 20 Jan 2011 14:09:00 GMT

About
TiddlyWiki
abego Software
News

Plugins
Installing Plugins

Download
Archive
Donations

^{© 2005-2011
abego Software}

Sample 2

Thu, 20 Jan 2011 14:08:00 GMT

SectionA:Text 2 A
SectionB:Text 2 B

Sample 1

Thu, 20 Jan 2011 14:08:00 GMT

SectionA:Text 1 A
SectionB:Text 1 B

Create a table with one row per tiddler ("Horizontal Report")

Thu, 20 Jan 2011 14:05:00 GMT

Tiddler	SectionA	SectionB
Sample 1	Text 1 A	Text 1 B
Sample 2	Text 2 A	Text 2 B

Create a table with one column per tiddler ("Vertical Report")

Thu, 20 Jan 2011 14:05:00 GMT

Tiddler	Sample 1	Sample 2
SectionA	Text 1 A	Text 2 A
SectionB	Text 1 B	Text 2 B

PageTemplate

Tue, 16 Feb 2010 16:31:00 GMT

<div class='header' macro='gradient vert #ff8000 #ffb200'>
<div class='headerForeground'>
<span class='siteTitle'><b>abego</b>Extensions
</span>
<table width="99%"><tr><td>

<span class='siteSubtitle' refresh='content' tiddler='SiteSubtitle'></span></td><td align="right"><span macro='search "" buttonAtRight:1'></span></td></tr></table>
</div>
</div>
<div id='mainMenu' refresh='content' tiddler='MainMenu'></div>
<div id='sidebar'>
<div id='sidebarOptions' refresh='content' tiddler='SideBarOptions'></div>
<div id='sidebarTabs' refresh='content' force='true' tiddler='SideBarTabs'></div>
</div>
<div id='displayArea'>
<div id='messageArea'></div>
<div id='tiddlerDisplay'></div>
</div>

StyleSheet

Tue, 16 Feb 2010 16:29:00 GMT

Colors Used

#ffb200 - Primary Color
#ffcc66 - Primary Color Light
#ff8000- Primary Color Bright
#b75b00 - Primary Color Dark
#666666 - Text Color Light
#703 - Title Color

.header {
	background: #ffb200;
}
.headerForeground {
	color: #000;
}
.headerForeground a {
	color: #000;
}

a {
	color: #666666;
}

a:hover{
	color: #666666;
}

#sidebarOptions input {
	border: 1px solid #ff8000;
}

#sidebarOptions .sliderPanel {
	background: #ffcc66;
}

#sidebarOptions .sliderPanel a {
	color: #b75b00;
}

#sidebarOptions .sliderPanel a:hover {
	color: #ff8000;
}

#sidebarOptions .sliderPanel a:active {
	color: #ff8000;
	background: #fff;
}
h1,h2,h3,h4,h5 {
	margin-top: 1em;
	color: #703;
	background: #ffcc66;
}

Other Styling

.headerForeground {
	position:relative; 
	padding:0.3em 0em 1em 1em; 
	left:-1px; top:-1px;
}

.headerForeground table {
	width: 100%;
}

a {
	font-family: Arial, Helvetica, sans-serif;
	text-decoration: none;
}

a:hover{
	text-decoration: underline;
	background: none;
}

.button:hover {
	text-decoration: none;
}

.abegoLink .externalLink {
	font-weight: bold;
	text-decoration: none;
}

.abegoLink .externalLink:hover {
	font-weight: bold;
	text-decoration: underline;
}

#mainMenu .tiddlyLinkExisting, 
#mainMenu .tiddlyLinkNonExisting{
	font-weight: bold;
	font-style: normal;
}

#sidebarOptions .sliderPanel a {
	color: #b75b00;
}

#sidebarOptions .sliderPanel a:hover {
	background:none;
}
.optionsBlock {
	padding: 0.5em;
	margin-left: 0.5em;
	overflow: auto;
	border: 1px solid #b75b00;
}
.txtOptionInput {width:30em;}

YourSearchPlugin

Tue, 16 Feb 2010 16:23:00 GMT

Name:	YourSearchPlugin
Version:	2.1.5 (2010-02-16)
Source:	http://tiddlywiki.abego-software.de/#YourSearchPlugin
Author:	UdoBorkowski (ub [at] abego-software [dot] de)
Licence:	BSD open source license (abego Software)
Copyright:	© 2005-2010 abego Software
CoreVersion:	2.1.0
Community:	del.icio.us
Browser:	Firefox 1.0.4+; Firefox 1.5; InternetExplorer 6.0

About YourSearch

YourSearch gives you a bunch of new features to simplify and speed up your daily searches in TiddlyWiki. It seamlessly integrates into the standard TiddlyWiki search: just start typing into the 'search' field and explore!

For more information see Help.

Compatibility

This plugin requires TiddlyWiki 2.1.
Check the archive for YourSearchPlugins supporting older versions of TiddlyWiki.

Source Code

This plugin's source code is compressed (and hidden). Use this link to get the readable source code.

List all tasks completed on a journal tiddler's day, as a "Daily Status Report"

Tue, 29 Dec 2009 14:36:00 GMT

Assume in a "journal" tiddler you want to see all tasks you completed that day. For every task you have tiddler with its details. When it is completed you add the date to the title (make sure to spell the date exactly as in the journal tiddler title).

Then you can add the following forEachTiddler macro to the journal tiddler to list all these tasks:

<<forEachTiddler 
 where 
 'tiddler.title.contains(context.viewerTiddler.title) && tiddler.title != context.viewerTiddler.title' 
 sortBy 
 'tiddler.title' 
write '"!![["+tiddler.title+"]]\n"+tiddler.tags+"\n"+tiddler.text+"\n"'
>>

Instead of copying this long statement to each journal tiddler you better create a helper tiddler with just the forEachTiddler macro call. Later you can "include" the helper tiddler in each journal tiddler.

E.g. have a look at the tiddler DailyStatusReport. You can now add a line like:

<<tiddler DailyStatusReport>>

into the journal tiddlers (e.g. as in journal tiddler "29 December 2009") to get the daily status report for that day.

(Based on code suggested by cmari and Alan Cohen. Thanks)

DailyStatusReport

Tue, 29 Dec 2009 14:36:00 GMT

Daily Status Report

<<forEachTiddler ...>>: TypeError: 'null' is not an object (evaluating 'context.viewerTiddler.title')

29 December 2009

Tue, 29 Dec 2009 14:36:00 GMT

Daily Status Report

<<forEachTiddler ...>>: TypeError: 'null' is not an object (evaluating 'context.viewerTiddler.title')

Published new abegoExtensions revision (29 December 2009)

Tue, 29 Dec 2009 14:35:00 GMT

[ ... Here goes the detailed documentation for the tiddler ... ]

Added sample tiddlers for "Daily Status Report" example (29 December 2009)

Tue, 29 Dec 2009 14:35:00 GMT

[ ... Here goes the detailed documentation for the tiddler ... ]

Added "Daily Status Report" example (29 December 2009)

Tue, 29 Dec 2009 14:34:00 GMT

[ ... Here goes the detailed documentation for the tiddler ... ]

NewTiddlerWithFormMacro

Fri, 09 Oct 2009 15:03:00 GMT

The newTiddlerWithForm Macro

To create tiddlers that are referencing FormTemplates you may use the <<newTiddlerWithForm...>> macro.

The <<newTiddlerWithForm...>> macro displays a button. When pressed the button creates the requested tiddler and displays it.

If no title is given in the macro (or a tiddler with the given name already exists) the user can enter the tiddlers name in a dialog.

Syntax:

`<<`newTiddlerWithForm formTemplateName buttonLabel [titleExpression [askUser]] `>>`
formTemplateName	The name of the tiddler that defines the form the new tiddler should use.
buttonLabel	The label of the button
titleExpression	A (quoted) JavaScript String expression that defines the title (/name) of the new tiddler.
askUser	Typically the user is not asked for the title when a title is specified (and not yet used). When askUser is given the user will be asked in any case. This may be used when the calculated title is just a suggestion that must be confirmed by the user
_{Syntax formatting: Keywords in bold, optional parts in [...]. 'or' means that exactly one of the two alternatives must exist.}

Examples

Ask the user for a bug report name and create a bugreport.

<<newTiddlerWithForm BugReportTemplate "New Bugreport">>

New Bugreport

Create a blog entry tiddler. Let the user confirm the automatically generated title (that contains the current date) or change it.

<<newTiddlerWithForm 
 BlogTemplate 
 "New Blog" 
 '"Blog: "+(new Date()).formatString("YYYY-MM-DD")' askUser
>>

New Blog

Using the build-in newTiddler macro

Instead of the <<newTiddlerWithForm>> macro you may also use the build-in <<newTiddler>> macro to create tiddlers referencing FormTemplates. E.g. you may use the <<newTiddler>> macro to create a tiddler with tags .

In the "text" you need to call the formTiddler macro and in the tagparameters you specify your tags. E.g.:

<<newTiddler
        label:"Button Label"
        text:{{"<<formTiddler [[MyTemplateTiddler]]>"+">"}}
        tag:"MyTag1"
        tag:"Three Word Tag" 
>>

For details on newTiddler see http://tiddlywiki.org/wiki/NewTiddler_%28macro%29

AdvancedOptions

Thu, 16 Jul 2009 08:30:00 GMT

Tweak advanced options

These options are saved in cookies in your browser

Option	Description	Name
	Enable animations	chkAnimate
	Automatically save changes	chkAutoSave
	Name of folder to use for backups	txtBackupFolder
	Case-sensitive searching	chkCaseSensitiveSearch
	Require confirmation before deleting tiddlers	chkConfirmDelete
	Default character set for saving changes (Firefox/Mozilla only)	txtFileSystemCharSet
	Don't update modifier username and date when editing tiddlers	chkForceMinorUpdate
	Generate an RSS feed when saving changes	chkGenerateAnRssFeed
	Hide editing features when viewed over HTTP	chkHttpReadOnly
	Use the tab key to insert tab characters instead of moving between fields	chkInsertTabs
	Maximum number of rows in edit boxes	txtMaxEditRows
	Open external links in a new window	chkOpenInNewWindow
	Enable regular expressions for searches	chkRegExpSearch
	Keep backup file when saving changes	chkSaveBackups
	Generate an empty template when saving changes	chkSaveEmptyTemplate
	Clicking on links to open tiddlers causes them to close	chkToggleLinks
	Username for signing your edits	txtUserName

Show unknown options

Include TiddlyWikis (IncludeList | IncludeState | help)
^{(Reload this TiddlyWiki to make changes become effective)}
Private Settings: Use private settings. Make setting private when changed. Show Settings.
^{(Private settings are stored in this TiddlyWiki, shared settings are stored as cookies. For more information see the Settings documentation.)}
Use 'Your Search' (more options) (help)
Sort 'Your Search' result by Date