diff --git a/Makefile.am b/Makefile.am index 236a67f8b..bf7ebec19 100644 --- a/Makefile.am +++ b/Makefile.am @@ -29,8 +29,12 @@ SUBDIRS = # Only use subdirs if really needed, prefer the include scheme below #SUBDIRS += +# administrative tools +include $(top_srcdir)/admin/Makefile.am + # core include $(top_srcdir)/src/lib/Makefile.am +include $(top_srcdir)/src/backend/Makefile.am # plugins #include $(top_srcdir)/src... diff --git a/SConstruct b/SConstruct index 4d2f2ee9c..31278e22b 100644 --- a/SConstruct +++ b/SConstruct @@ -179,7 +179,7 @@ def configurePlatform(env): if not conf.CheckLibWithHeader('pthread', 'pthread.h', 'C'): print 'Did not find the pthread lib or pthread.h, exiting.' else: - conf.env.Append(CPPFLAGS = ' -DHAVE_PTHREAD_H') + conf.env.Append(CPPFLAGS = ' -DHAVE_PTHREAD') conf.env.Append(CCFLAGS = ' -pthread') if conf.CheckCHeader('execinfo.h'): diff --git a/acinclude.m4 b/acinclude.m4 new file mode 100644 index 000000000..06af84275 --- /dev/null +++ b/acinclude.m4 @@ -0,0 +1,238 @@ +dnl @synopsis ACX_PTHREAD([ACTION-IF-FOUND[, ACTION-IF-NOT-FOUND]]) +dnl +dnl @summary figure out how to build C programs using POSIX threads +dnl +dnl This macro figures out how to build C programs using POSIX threads. +dnl It sets the PTHREAD_LIBS output variable to the threads library and +dnl linker flags, and the PTHREAD_CFLAGS output variable to any special +dnl C compiler flags that are needed. (The user can also force certain +dnl compiler flags/libs to be tested by setting these environment +dnl variables.) +dnl +dnl Also sets PTHREAD_CC to any special C compiler that is needed for +dnl multi-threaded programs (defaults to the value of CC otherwise). +dnl (This is necessary on AIX to use the special cc_r compiler alias.) +dnl +dnl NOTE: You are assumed to not only compile your program with these +dnl flags, but also link it with them as well. e.g. you should link +dnl with $PTHREAD_CC $CFLAGS $PTHREAD_CFLAGS $LDFLAGS ... $PTHREAD_LIBS +dnl $LIBS +dnl +dnl If you are only building threads programs, you may wish to use +dnl these variables in your default LIBS, CFLAGS, and CC: +dnl +dnl LIBS="$PTHREAD_LIBS $LIBS" +dnl CFLAGS="$CFLAGS $PTHREAD_CFLAGS" +dnl CC="$PTHREAD_CC" +dnl +dnl In addition, if the PTHREAD_CREATE_JOINABLE thread-attribute +dnl constant has a nonstandard name, defines PTHREAD_CREATE_JOINABLE to +dnl that name (e.g. PTHREAD_CREATE_UNDETACHED on AIX). +dnl +dnl ACTION-IF-FOUND is a list of shell commands to run if a threads +dnl library is found, and ACTION-IF-NOT-FOUND is a list of commands to +dnl run it if it is not found. If ACTION-IF-FOUND is not specified, the +dnl default action will define HAVE_PTHREAD. +dnl +dnl Please let the authors know if this macro fails on any platform, or +dnl if you have any other suggestions or comments. This macro was based +dnl on work by SGJ on autoconf scripts for FFTW (www.fftw.org) (with +dnl help from M. Frigo), as well as ac_pthread and hb_pthread macros +dnl posted by Alejandro Forero Cuervo to the autoconf macro repository. +dnl We are also grateful for the helpful feedback of numerous users. +dnl +dnl @category InstalledPackages +dnl @author Steven G. Johnson +dnl @version 2005-06-15 +dnl @license GPLWithACException + +AC_DEFUN([ACX_PTHREAD], [ +AC_REQUIRE([AC_CANONICAL_HOST]) +AC_LANG_SAVE +AC_LANG_C +acx_pthread_ok=no + +# We used to check for pthread.h first, but this fails if pthread.h +# requires special compiler flags (e.g. on True64 or Sequent). +# It gets checked for in the link test anyway. + +# First of all, check if the user has set any of the PTHREAD_LIBS, +# etcetera environment variables, and if threads linking works using +# them: +if test x"$PTHREAD_LIBS$PTHREAD_CFLAGS" != x; then + save_CFLAGS="$CFLAGS" + CFLAGS="$CFLAGS $PTHREAD_CFLAGS" + save_LIBS="$LIBS" + LIBS="$PTHREAD_LIBS $LIBS" + AC_MSG_CHECKING([for pthread_join in LIBS=$PTHREAD_LIBS with CFLAGS=$PTHREAD_CFLAGS]) + AC_TRY_LINK_FUNC(pthread_join, acx_pthread_ok=yes) + AC_MSG_RESULT($acx_pthread_ok) + if test x"$acx_pthread_ok" = xno; then + PTHREAD_LIBS="" + PTHREAD_CFLAGS="" + fi + LIBS="$save_LIBS" + CFLAGS="$save_CFLAGS" +fi + +# We must check for the threads library under a number of different +# names; the ordering is very important because some systems +# (e.g. DEC) have both -lpthread and -lpthreads, where one of the +# libraries is broken (non-POSIX). + +# Create a list of thread flags to try. Items starting with a "-" are +# C compiler flags, and other items are library names, except for "none" +# which indicates that we try without any flags at all, and "pthread-config" +# which is a program returning the flags for the Pth emulation library. + +acx_pthread_flags="pthreads none -Kthread -kthread lthread -pthread -pthreads -mthreads pthread --thread-safe -mt pthread-config" + +# The ordering *is* (sometimes) important. Some notes on the +# individual items follow: + +# pthreads: AIX (must check this before -lpthread) +# none: in case threads are in libc; should be tried before -Kthread and +# other compiler flags to prevent continual compiler warnings +# -Kthread: Sequent (threads in libc, but -Kthread needed for pthread.h) +# -kthread: FreeBSD kernel threads (preferred to -pthread since SMP-able) +# lthread: LinuxThreads port on FreeBSD (also preferred to -pthread) +# -pthread: Linux/gcc (kernel threads), BSD/gcc (userland threads) +# -pthreads: Solaris/gcc +# -mthreads: Mingw32/gcc, Lynx/gcc +# -mt: Sun Workshop C (may only link SunOS threads [-lthread], but it +# doesn't hurt to check since this sometimes defines pthreads too; +# also defines -D_REENTRANT) +# ... -mt is also the pthreads flag for HP/aCC +# pthread: Linux, etcetera +# --thread-safe: KAI C++ +# pthread-config: use pthread-config program (for GNU Pth library) + +case "${host_cpu}-${host_os}" in + *solaris*) + + # On Solaris (at least, for some versions), libc contains stubbed + # (non-functional) versions of the pthreads routines, so link-based + # tests will erroneously succeed. (We need to link with -pthreads/-mt/ + # -lpthread.) (The stubs are missing pthread_cleanup_push, or rather + # a function called by this macro, so we could check for that, but + # who knows whether they'll stub that too in a future libc.) So, + # we'll just look for -pthreads and -lpthread first: + + acx_pthread_flags="-pthreads pthread -mt -pthread $acx_pthread_flags" + ;; +esac + +if test x"$acx_pthread_ok" = xno; then +for flag in $acx_pthread_flags; do + + case $flag in + none) + AC_MSG_CHECKING([whether pthreads work without any flags]) + ;; + + -*) + AC_MSG_CHECKING([whether pthreads work with $flag]) + PTHREAD_CFLAGS="$flag" + ;; + + pthread-config) + AC_CHECK_PROG(acx_pthread_config, pthread-config, yes, no) + if test x"$acx_pthread_config" = xno; then continue; fi + PTHREAD_CFLAGS="`pthread-config --cflags`" + PTHREAD_LIBS="`pthread-config --ldflags` `pthread-config --libs`" + ;; + + *) + AC_MSG_CHECKING([for the pthreads library -l$flag]) + PTHREAD_LIBS="-l$flag" + ;; + esac + + save_LIBS="$LIBS" + save_CFLAGS="$CFLAGS" + LIBS="$PTHREAD_LIBS $LIBS" + CFLAGS="$CFLAGS $PTHREAD_CFLAGS" + + # Check for various functions. We must include pthread.h, + # since some functions may be macros. (On the Sequent, we + # need a special flag -Kthread to make this header compile.) + # We check for pthread_join because it is in -lpthread on IRIX + # while pthread_create is in libc. We check for pthread_attr_init + # due to DEC craziness with -lpthreads. We check for + # pthread_cleanup_push because it is one of the few pthread + # functions on Solaris that doesn't have a non-functional libc stub. + # We try pthread_create on general principles. + AC_TRY_LINK([#include ], + [pthread_t th; pthread_join(th, 0); + pthread_attr_init(0); pthread_cleanup_push(0, 0); + pthread_create(0,0,0,0); pthread_cleanup_pop(0); ], + [acx_pthread_ok=yes]) + + LIBS="$save_LIBS" + CFLAGS="$save_CFLAGS" + + AC_MSG_RESULT($acx_pthread_ok) + if test "x$acx_pthread_ok" = xyes; then + break; + fi + + PTHREAD_LIBS="" + PTHREAD_CFLAGS="" +done +fi + +# Various other checks: +if test "x$acx_pthread_ok" = xyes; then + save_LIBS="$LIBS" + LIBS="$PTHREAD_LIBS $LIBS" + save_CFLAGS="$CFLAGS" + CFLAGS="$CFLAGS $PTHREAD_CFLAGS" + + # Detect AIX lossage: JOINABLE attribute is called UNDETACHED. + AC_MSG_CHECKING([for joinable pthread attribute]) + attr_name=unknown + for attr in PTHREAD_CREATE_JOINABLE PTHREAD_CREATE_UNDETACHED; do + AC_TRY_LINK([#include ], [int attr=$attr; return attr;], + [attr_name=$attr; break]) + done + AC_MSG_RESULT($attr_name) + if test "$attr_name" != PTHREAD_CREATE_JOINABLE; then + AC_DEFINE_UNQUOTED(PTHREAD_CREATE_JOINABLE, $attr_name, + [Define to necessary symbol if this constant + uses a non-standard name on your system.]) + fi + + AC_MSG_CHECKING([if more special flags are required for pthreads]) + flag=no + case "${host_cpu}-${host_os}" in + *-aix* | *-freebsd* | *-darwin*) flag="-D_THREAD_SAFE";; + *solaris* | *-osf* | *-hpux*) flag="-D_REENTRANT";; + esac + AC_MSG_RESULT(${flag}) + if test "x$flag" != xno; then + PTHREAD_CFLAGS="$flag $PTHREAD_CFLAGS" + fi + + LIBS="$save_LIBS" + CFLAGS="$save_CFLAGS" + + # More AIX lossage: must compile with cc_r + AC_CHECK_PROG(PTHREAD_CC, cc_r, cc_r, ${CC}) +else + PTHREAD_CC="$CC" +fi + +AC_SUBST(PTHREAD_LIBS) +AC_SUBST(PTHREAD_CFLAGS) +AC_SUBST(PTHREAD_CC) + +# Finally, execute ACTION-IF-FOUND/ACTION-IF-NOT-FOUND: +if test x"$acx_pthread_ok" = xyes; then + ifelse([$1],,AC_DEFINE(HAVE_PTHREAD,1,[Define if you have POSIX threads libraries and header files.]),[$1]) + : +else + acx_pthread_ok=no + $2 +fi +AC_LANG_RESTORE +])dnl ACX_PTHREAD diff --git a/admin/Makefile.am b/admin/Makefile.am new file mode 100644 index 000000000..6385eb910 --- /dev/null +++ b/admin/Makefile.am @@ -0,0 +1,24 @@ +# Copyright (C) Lumiera.org +# 2008, Christian Thaeter +# +# This program is free software; you can redistribute it and/or +# modify it under the terms of the GNU General Public License as +# published by the Free Software Foundation; either version 2 of the +# License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program; if not, write to the Free Software +# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. + +admin_srcdir = $(top_srcdir)/admin + +noinst_PROGRAMS += vgsuppression +vgsuppression_SOURCES = $(admin_srcdir)/vgsuppression.c +vgsuppression_CPPFLAGS = $(AM_CPPFLAGS) -std=gnu99 -Wall -Werror -I$(top_srcdir)/src/ +vgsuppression_LDADD = liblumi.a -lnobugmt -lpthread -ldl + diff --git a/admin/headercheck b/admin/headercheck new file mode 100755 index 000000000..ada5e1e53 --- /dev/null +++ b/admin/headercheck @@ -0,0 +1,25 @@ +#!/bin/bash + +# This is a small tool which checks that all headers are sufficiently standalone +# and include anything they need. +# In future we might extend this to find out bogus includes by predefining (-D) +# headerguards they include, effectively disableing this include for a test. + +find src -name '*.h' | while read header; do + echo -e "testing $header" + awk 'BEGIN {print "#include \""ARGV[1]"\"\nint main(){"} + /^(struct|enum|class).*[^;]$/{print "\t" $0 " test_" NR "; (void) test_"NR";" } + END {print "\treturn 0;\n}"}' $header >,headertest.c + gcc -D_GNU_SOURCE -DEBUG_ALPHA -std=gnu99 -Werror -Wall -I src -c ,headertest.c + echo +done + +find src -name '*.hpp' | while read header; do + echo -e "testing $header" + awk 'BEGIN {print "#include \""ARGV[1]"\"\nint main(){"} + /^(struct|enum|class).*[^;]$/{print "\t" $0 " test_" NR "; (void) test_"NR";" } + END {print "\treturn 0;\n}"}' $header >,headertest.cpp + g++ -D_GNU_SOURCE -DEBUG_ALPHA -Werror -Wall -I src -c ,headertest.cpp + echo +done + diff --git a/admin/lumiera_c_skeleton b/admin/lumiera_c_skeleton new file mode 100755 index 000000000..fa8e1c1e3 --- /dev/null +++ b/admin/lumiera_c_skeleton @@ -0,0 +1,135 @@ +#!/bin/bash + +if test $# -lt 2; then +cat <${NAME}.h < + + This program is free software; you can redistribute it and/or + modify it under the terms of the GNU General Public License as + published by the Free Software Foundation; either version 2 of the + License, or (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program; if not, write to the Free Software + Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. +*/ + +#ifndef LUMIERA_${NAME_UPPER}_H +#define LUMIERA_${NAME_UPPER}_H + +//TODO: Support library includes// + + +//TODO: Forward declarations// + + +//TODO: Lumiera header includes// + + +//TODO: System includes// +#include + + +/** + * @file + * + */ + +//TODO: declarations go here// + + +#endif +/* +// Local Variables: +// mode: C +// c-file-style: "gnu" +// indent-tabs-mode: nil +// End: +*/ +EOF + +test -f ${NAME}.c || cat >${NAME}.c < + + This program is free software; you can redistribute it and/or + modify it under the terms of the GNU General Public License as + published by the Free Software Foundation; either version 2 of the + License, or (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program; if not, write to the Free Software + Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. +*/ + +//TODO: Support library includes// + + +//TODO: Lumiera header includes// +#include "${PWD##*/}/${NAME}.h" + +//TODO: internal/static forward declarations// + + +//TODO: System includes// + + +/** + * @file + * + */ + +NOBUG_DEFINE_FLAG_PARENT (${NAME}, /*TODO insert parent flag here */); + + +//code goes here// + + + +/* +// Local Variables: +// mode: C +// c-file-style: "gnu" +// indent-tabs-mode: nil +// End: +*/ +EOF + +test -f Makefile.am && ed Makefile.am >/dev/null < @@ -18,13 +18,21 @@ along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */ +#define _GNU_SOURCE -#include "lib/error.h" +/* + just place any problematic calls where valgrind whines about in main (with comments please) +*/ -/** - * @file Framerate calculations. - */ +#include "lib/safeclib.h" -LUMIERA_ERROR_DEFINE(FRAMERATE_ILLEGAL_TIME, "invalid time given"); -LUMIERA_ERROR_DEFINE(FRAMERATE_ILLEGAL_FRAME, "invalid frame given"); +int +main () +{ + /* debian etch glibc is lazy about cleaning up TLS */ + lumiera_tmpbuf_provide (100); + lumiera_tmpbuf_freeall (); + + return 0; +} diff --git a/admin/vgsuppression_gen.sh b/admin/vgsuppression_gen.sh new file mode 100755 index 000000000..08814afaa --- /dev/null +++ b/admin/vgsuppression_gen.sh @@ -0,0 +1,3 @@ +#!/bin/sh + +valgrind --leak-check=yes --show-reachable=yes --gen-suppressions=all ./vgsuppression 2>&1 | sed '/==[0-9]*==/d;' diff --git a/configure.ac b/configure.ac index 386bd94b0..78d76c136 100644 --- a/configure.ac +++ b/configure.ac @@ -37,11 +37,15 @@ AC_PROG_LIBTOOL # test for headers # AC_STDC_HEADERS -AC_CHECK_HEADER([pthread.h], AC_DEFINE(HAVE_PTHREAD_H)) AC_CHECK_HEADER([nobug.h], AC_DEFINE(HAVE_NOBUG_H)) AC_CHECK_HEADER([execinfo.h], AC_DEFINE(HAVE_EXECINFO_H)) # there is a warning in nobug, disabled til fixed AC_CHECK_HEADER([valgrind/valgrind.h], AC_DEFINE(HAVE_VALGRIND_VALGRIND_H)) +ACX_PTHREAD +##AM_CONDITIONAL([HAVE_THREADING], [test x"$acx_pthread_ok" = xyes]) + + + # # user options # diff --git a/doc/devel/Doxyfile b/doc/devel/Doxyfile index 2f90301f0..1d6c5f87c 100644 --- a/doc/devel/Doxyfile +++ b/doc/devel/Doxyfile @@ -44,7 +44,7 @@ SUBGROUPING = YES #--------------------------------------------------------------------------- # Build related configuration options #--------------------------------------------------------------------------- -EXTRACT_ALL = YES +EXTRACT_ALL = NO EXTRACT_PRIVATE = YES EXTRACT_STATIC = YES EXTRACT_LOCAL_CLASSES = YES diff --git a/doc/devel/nobug_flags.txt b/doc/devel/nobug_flags.txt new file mode 100644 index 000000000..325141acb --- /dev/null +++ b/doc/devel/nobug_flags.txt @@ -0,0 +1,57 @@ + +NoBug debugging flags hierachy +============================== + +NoBug logging is controlled by flags which can be configured with the +NOBUG_LOG environment variable. This flags can be hierachically +organized. + +The documentation about this hierachy is maintained here: + + (PLANNED, not all are implemented yet) + +all # global logging + lumiera # standard + library # all support library + plugin # plugin loader + backend # all backend + file_all # filehandling subsystem + file # file access + filedescriptor # internal filedescriptors + filehandle # posix filehandles + filehandlecache # mrucache for filehandles + map_all # file mapping subsystem + cache_all # caching subsystem + scheduler_all # all scheduler + threads # threadpool management + tasks # work requests + hard # high priority queue + idle # low priority queue + proc # all proc + gui # all gui + detail # highly expensive logging + profiler # performance stats + +event # controling events + ui # by user interface + script # by script + +Explanation +----------- + +We have 2 main log flag hierachies, 'all' and 'event'. + * 'all' reflects the application progress and will be used for + debugging the application by the programmers. This is exposed in 2 + subgroups: 'lumiera' which is used for normal application logging + and, 'detail' which contains logging which might be time critical, + expensive or of very high volume. + * 'event' logs user actions like GUI clicking, menu selections giving + an idea how a bug was triggered. + +Later on this main hierachies will run in different ringbuffers. + +In Short +-------- + +use NOBUG_LOG=lumiera + diff --git a/src/backend/Makefile.am b/src/backend/Makefile.am new file mode 100644 index 000000000..5f693f8bf --- /dev/null +++ b/src/backend/Makefile.am @@ -0,0 +1,37 @@ +# Copyright (C) Lumiera.org +# 2008, Christian Thaeter +# +# This program is free software; you can redistribute it and/or +# modify it under the terms of the GNU General Public License as +# published by the Free Software Foundation; either version 2 of the +# License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program; if not, write to the Free Software +# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. + +liblumibackend_a_srcdir = $(top_srcdir)/src/backend +noinst_LIBRARIES += liblumibackend.a + +liblumibackend_a_CFLAGS = $(CFLAGS) -std=gnu99 -Wall -Werror +liblumibackend_a_CPPFLAGS = -I$(top_srcdir)/src/ + +liblumibackend_a_SOURCES = \ + $(liblumibackend_a_srcdir)/backend.c \ + $(liblumibackend_a_srcdir)/file.c \ + $(liblumibackend_a_srcdir)/filehandle.c \ + $(liblumibackend_a_srcdir)/filedescriptor.c \ + $(liblumibackend_a_srcdir)/filehandlecache.c + +noinst_HEADERS += \ + $(liblumibackend_a_srcdir)/backend.h \ + $(liblumibackend_a_srcdir)/file.h \ + $(liblumibackend_a_srcdir)/filehandle.h \ + $(liblumibackend_a_srcdir)/filedescriptor.h \ + $(liblumibackend_a_srcdir)/filehandlecache.h + diff --git a/tests/00test.tests b/tests/00test.tests index 0b894982b..4d8781629 100644 --- a/tests/00test.tests +++ b/tests/00test.tests @@ -1,4 +1,4 @@ -TESTING "test system selftest" cat +TESTING "test system selftest" /bin/cat TEST "test cat'ing stdin to stdout" < - - This program is free software; you can redistribute it and/or - modify it under the terms of the GNU General Public License as - published by the Free Software Foundation; either version 2 of the - License, or (at your option) any later version. - - This program is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - GNU General Public License for more details. - - You should have received a copy of the GNU General Public License - along with this program; if not, write to the Free Software - Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. -*/ - -#include -#include - -#include "lib/condition.h" - -LUMIERA_ERROR_DEFINE(TEST, "test error"); - -#if 0 -waiting_thread() -{ - lock; - wait; - unlock; -} - - -signaling_thread() -{ - signal(); -} -#endif - - -int -main (int argc, char** argv) -{ - NOBUG_INIT; - - if (argc == 1) - return 0; - - if (!strcmp(argv[1], "conditionforgotunlock")) - { - lumiera_condition c; - lumiera_condition_init (&c); - - lumiera_conditionlock NOBUG_CLEANUP(lumiera_conditionlock_ensureunlocked) l; - lumiera_conditionlock_init (&l, &c, LUMIERA_LOCKED); - } - else - return 1; - - return 0; -} diff --git a/tests/test.sh b/tests/test.sh index b692b3959..77bac66bf 100755 --- a/tests/test.sh +++ b/tests/test.sh @@ -29,7 +29,7 @@ export LC_ALL=C arg0="$0" -srcdir=$(dirname "$arg0") +srcdir="$(dirname "$arg0")" ulimit -S -t 1 -v 524288 valgrind="" @@ -45,7 +45,7 @@ else fi echo -echo ================ ${0##*/} ================ +echo "================ ${0##*/} ================" TESTCNT=0 SKIPCNT=0 @@ -84,7 +84,7 @@ function TEST() echo "$arg" >>,expect_stderr ;; 'return') - expect_return=$arg + expect_return="$arg" ;; *) echo "UNKOWN TEST COMMAND '$cmd'" 1>&2 @@ -95,7 +95,7 @@ function TEST() echo -n "TEST $name: " echo -en "\nTEST $name: $* " >>,testlog - case $TESTMODE in + case "$TESTMODE" in *FAST*) if grep "^TEST $name: .* FAILED" ,testlog.pre >&/dev/null; then MSGOK=" (fixed)" @@ -121,39 +121,45 @@ function TEST() fails=0 - - if test -f ,send_stdin; then - cat ,send_stdin | $valgrind $TESTBIN "$@" 2>,stderr >,stdout - else - $valgrind $TESTBIN "$@" 2>,stderr >,stdout - fi &>/dev/null - return=$? - echo -n >,testtmp - if test -f ,expect_stdout; then - if ! cmp ,expect_stdout ,stdout &>/dev/null; then - echo "unexpected data on stdout" >>,testtmp - grep -v ': \(TRACE\|INFO\|NOTICE\|WARNING\|ERR\):' <,stdout >,tmp - diff -ua ,expect_stdout ,tmp >>,testtmp - rm ,tmp - ((fails+=1)) - fi - fi - - if test -f ,expect_stderr; then - if ! cmp ,expect_stderr ,stderr &>/dev/null; then - echo "unexpected data on stderr" >>,testtmp - grep -v ': \(TRACE\|INFO\|NOTICE\|WARNING\|ERR\):' <,stderr >,tmp - diff -ua ,expect_stderr ,tmp >>,testtmp - rm ,tmp - ((fails+=1)) - fi - fi - - if test $expect_return != $return; then - echo "unexpected return value $return" >>,testtmp + if ! test -x $TESTBIN; then + echo -n >,stdout + echo "test binary '$TESTBIN' not found" >,stderr ((fails+=1)) + + else + if test -f ,send_stdin; then + cat ,send_stdin | $valgrind $TESTBIN "$@" 2>,stderr >,stdout + else + $valgrind $TESTBIN "$@" 2>,stderr >,stdout + fi &>/dev/null + return=$? + + if test -f ,expect_stdout; then + if ! cmp ,expect_stdout ,stdout &>/dev/null; then + echo "unexpected data on stdout" >>,testtmp + grep -v ': \(TRACE\|INFO\|NOTICE\|WARNING\|ERR\):' <,stdout >,tmp + diff -ua ,expect_stdout ,tmp >>,testtmp + rm ,tmp + ((fails+=1)) + fi + fi + + if test -f ,expect_stderr; then + if ! cmp ,expect_stderr ,stderr &>/dev/null; then + echo "unexpected data on stderr" >>,testtmp + grep -v ': \(TRACE\|INFO\|NOTICE\|WARNING\|ERR\):' <,stderr >,tmp + diff -ua ,expect_stderr ,tmp >>,testtmp + rm ,tmp + ((fails+=1)) + fi + fi + + if test "$expect_return" != "$return"; then + echo "unexpected return value $return" >>,testtmp + ((fails+=1)) + fi fi if test $fails -eq 0; then @@ -191,7 +197,7 @@ function RUNTESTS() if test \( ! "${TESTSUITES/*,*/}" \) -a "$TESTSUITES"; then TESTSUITES="{$TESTSUITES}" fi - for t in $(eval echo $srcdir/*$TESTSUITES*.tests); do + for t in $(eval echo "$srcdir/*$TESTSUITES*.tests"); do echo "$t" done | sort | uniq | { while read i; do diff --git a/tests/time/DIR_INFO b/tests/time/DIR_INFO deleted file mode 100644 index 20a92392c..000000000 --- a/tests/time/DIR_INFO +++ /dev/null @@ -1 +0,0 @@ -test time and frame calculations diff --git a/wiki/backend.html b/wiki/backend.html index 3cdee6a96..49bfb6727 100644 --- a/wiki/backend.html +++ b/wiki/backend.html @@ -789,20 +789,19 @@ Look at [[Overview]] for the current design proposal 
DataBackend
-
-
'File' is the superclass of all possible filetypes, it has a weak reference to a FileHandle which is managed in FileHandleCache, on creation only the existence (when reading) or access for write for new files are checked. 'File' stores some generic metadata about the underlying file and intended use. But actual opening is done on demand.
+

+
[[File]] associates a filename with the underlying FileDescriptor. This allows [[File]]s which have serveral names (hardlinks) to share a underlying backend.

+

+

+
'FileDescriptor' is the superclass of all possible filetypes, it has a weak reference to a FileHandle which is managed in FilehandleCache, on creation only the existence (when reading) or access for write for new files are checked. 'FileDescriptor' stores some generic metadata about the underlying file and intended use. But actual opening is done on demand.
 
-Files content is memory mapped into the process address space, this is managed by FileMap objects and a FileMapCache.
+The content is memory mapped into the process address space, this is managed by FileMap objects and a FileMapCache.
 

 

 

 
'FileHandle's are managed by the FileHandleCache, they are just storing the underlying OS file handles and managed in a lazy/weak way, (re)opened when needed and aging in the cache when not needed, since the amount of open file handles is limited aged ones will be closed and reused when the system needs to open another file.
 

 

-

-
'FileHandleCache' storing a finite maximum number of [[FileHandle]]s as a list. As long the configured maximum of open files is not reached new file handles are stored at the begin of the list. Whenever a filehandle is accessed it is moved to the begin of the list too. Unused filehandles propagate towards the end of the list. When the maximum of open filehandles is reached, aged filehandles are closed and taken from the end.
-

-

 

 
Each 'FileMap' object contains many [[Frame]]s. The actual layout depends on the type of the [[File]]. Mappings need to be page aligned while [[Frame]]s can be anywhere within a file and dynamically sized.
 
@@ -816,6 +815,10 @@ FileMap objects are transparent to the application. It will only requests [[Fram
 Whenever a FileMap is in use, it is checked out into an in-use list where it is not subject to aging.
 

 

+

+
'FilehandleCache' storing a finite maximum number of [[FileHandle]]s as a list. As long the configured maximum of open files is not reached new file handles are stored at the begin of the list. Whenever a filehandle is accessed it is moved to the begin of the list too. Unused filehandles propagate towards the end of the list. When the maximum of open filehandles is reached, aged filehandles are closed and taken from the end.
+

+

 

 
'Frames' are the smallest datablocks handled by the Backend. The application tells the Backend to make [[File]]s available and then only requests Frames from the Backend. All other datastructures of the backend are private.
 
@@ -1254,7 +1257,7 @@ Storage and logging of EDL's, unlimited undo, database,...
 When to Cache and when not to cache, aka instant [[Frame]] reuse
 

 

-

+

 
Whenever Lumiera needs to access data this is done through the DataBackend described here. 
 
 There are two main kinds how data is handled:
@@ -1263,7 +1266,7 @@ There are two main kinds how data is handled:
 
 The backend uses memory mapping to make data available to the program. This is little different to more common open/read/write/close file access while giving superior performance and much better memory utilization.
 
-The data backend must be capable to handle more data than will fit into the memory or even address space on 32 bit architectures.  Moreover a project may access more files than the OS can handle at a time, thus the for [[File]]s used by the Backend it needs a FileHandleCache to manage filehandles dynamically.
+The data backend must be capable to handle more data than will fit into the memory or even address space on 32 bit architectures.  Moreover a project may access more files than the OS can handle at a time, thus the for [[File]]s used by the Backend it needs a FilehandleCache to manage filehandles dynamically.
 
 Which parts of a File are actually mapped to physical RAM is managed by the kernel, it keeps a FileMapCache to manage the [[FileMap]]s we've set up.
 
diff --git a/wiki/compatibility.html b/wiki/compatibility.html
new file mode 100644
index 000000000..ad54ca4e8
--- /dev/null
+++ b/wiki/compatibility.html
@@ -0,0 +1,11615 @@
+
+
+
+
+
+
+
+
+
+
+
+
My TiddlyWiki is loading ...

Requires Javascript.

+
+ Compatibility - Dependencies and Style 
+
+
+
+
+
+
+
+
+
+
+
+

+

+

+

+

+	

+

+

+

+

+

+
Background: #fff
+Foreground: #000
+PrimaryPale: #8cf
+PrimaryLight: #18f
+PrimaryMid: #04b
+PrimaryDark: #014
+SecondaryPale: #ffc
+SecondaryLight: #fe8
+SecondaryMid: #db4
+SecondaryDark: #841
+TertiaryPale: #eee
+TertiaryLight: #ccc
+TertiaryMid: #999
+TertiaryDark: #666
+Error: #f88

+

+

+
/*{{{*/
+body {background:[[ColorPalette::Background]]; color:[[ColorPalette::Foreground]];}
+
+a {color:[[ColorPalette::PrimaryMid]];}
+a:hover {background-color:[[ColorPalette::PrimaryMid]]; color:[[ColorPalette::Background]];}
+a img {border:0;}
+
+h1,h2,h3,h4,h5,h6 {color:[[ColorPalette::SecondaryDark]]; background:transparent;}
+h1 {border-bottom:2px solid [[ColorPalette::TertiaryLight]];}
+h2,h3 {border-bottom:1px solid [[ColorPalette::TertiaryLight]];}
+
+.button {color:[[ColorPalette::PrimaryDark]]; border:1px solid [[ColorPalette::Background]];}
+.button:hover {color:[[ColorPalette::PrimaryDark]]; background:[[ColorPalette::SecondaryLight]]; border-color:[[ColorPalette::SecondaryMid]];}
+.button:active {color:[[ColorPalette::Background]]; background:[[ColorPalette::SecondaryMid]]; border:1px solid [[ColorPalette::SecondaryDark]];}
+
+.header {background:[[ColorPalette::PrimaryMid]];}
+.headerShadow {color:[[ColorPalette::Foreground]];}
+.headerShadow a {font-weight:normal; color:[[ColorPalette::Foreground]];}
+.headerForeground {color:[[ColorPalette::Background]];}
+.headerForeground a {font-weight:normal; color:[[ColorPalette::PrimaryPale]];}
+
+.tabSelected{color:[[ColorPalette::PrimaryDark]];
+	background:[[ColorPalette::TertiaryPale]];
+	border-left:1px solid [[ColorPalette::TertiaryLight]];
+	border-top:1px solid [[ColorPalette::TertiaryLight]];
+	border-right:1px solid [[ColorPalette::TertiaryLight]];
+}
+.tabUnselected {color:[[ColorPalette::Background]]; background:[[ColorPalette::TertiaryMid]];}
+.tabContents {color:[[ColorPalette::PrimaryDark]]; background:[[ColorPalette::TertiaryPale]]; border:1px solid [[ColorPalette::TertiaryLight]];}
+.tabContents .button {border:0;}
+
+#sidebar {}
+#sidebarOptions input {border:1px solid [[ColorPalette::PrimaryMid]];}
+#sidebarOptions .sliderPanel {background:[[ColorPalette::PrimaryPale]];}
+#sidebarOptions .sliderPanel a {border:none;color:[[ColorPalette::PrimaryMid]];}
+#sidebarOptions .sliderPanel a:hover {color:[[ColorPalette::Background]]; background:[[ColorPalette::PrimaryMid]];}
+#sidebarOptions .sliderPanel a:active {color:[[ColorPalette::PrimaryMid]]; background:[[ColorPalette::Background]];}
+
+.wizard {background:[[ColorPalette::PrimaryPale]]; border:1px solid [[ColorPalette::PrimaryMid]];}
+.wizard h1 {color:[[ColorPalette::PrimaryDark]]; border:none;}
+.wizard h2 {color:[[ColorPalette::Foreground]]; border:none;}
+.wizardStep {background:[[ColorPalette::Background]]; color:[[ColorPalette::Foreground]];
+	border:1px solid [[ColorPalette::PrimaryMid]];}
+.wizardStep.wizardStepDone {background::[[ColorPalette::TertiaryLight]];}
+.wizardFooter {background:[[ColorPalette::PrimaryPale]];}
+.wizardFooter .status {background:[[ColorPalette::PrimaryDark]]; color:[[ColorPalette::Background]];}
+.wizard .button {color:[[ColorPalette::Foreground]]; background:[[ColorPalette::SecondaryLight]]; border: 1px solid;
+	border-color:[[ColorPalette::SecondaryPale]] [[ColorPalette::SecondaryDark]] [[ColorPalette::SecondaryDark]] [[ColorPalette::SecondaryPale]];}
+.wizard .button:hover {color:[[ColorPalette::Foreground]]; background:[[ColorPalette::Background]];}
+.wizard .button:active {color:[[ColorPalette::Background]]; background:[[ColorPalette::Foreground]]; border: 1px solid;
+	border-color:[[ColorPalette::PrimaryDark]] [[ColorPalette::PrimaryPale]] [[ColorPalette::PrimaryPale]] [[ColorPalette::PrimaryDark]];}
+
+#messageArea {border:1px solid [[ColorPalette::SecondaryMid]]; background:[[ColorPalette::SecondaryLight]]; color:[[ColorPalette::Foreground]];}
+#messageArea .button {color:[[ColorPalette::PrimaryMid]]; background:[[ColorPalette::SecondaryPale]]; border:none;}
+
+.popupTiddler {background:[[ColorPalette::TertiaryPale]]; border:2px solid [[ColorPalette::TertiaryMid]];}
+
+.popup {background:[[ColorPalette::TertiaryPale]]; color:[[ColorPalette::TertiaryDark]]; border-left:1px solid [[ColorPalette::TertiaryMid]]; border-top:1px solid [[ColorPalette::TertiaryMid]]; border-right:2px solid [[ColorPalette::TertiaryDark]]; border-bottom:2px solid [[ColorPalette::TertiaryDark]];}
+.popup hr {color:[[ColorPalette::PrimaryDark]]; background:[[ColorPalette::PrimaryDark]]; border-bottom:1px;}
+.popup li.disabled {color:[[ColorPalette::TertiaryMid]];}
+.popup li a, .popup li a:visited {color:[[ColorPalette::Foreground]]; border: none;}
+.popup li a:hover {background:[[ColorPalette::SecondaryLight]]; color:[[ColorPalette::Foreground]]; border: none;}
+.popup li a:active {background:[[ColorPalette::SecondaryPale]]; color:[[ColorPalette::Foreground]]; border: none;}
+.popupHighlight {background:[[ColorPalette::Background]]; color:[[ColorPalette::Foreground]];}
+.listBreak div {border-bottom:1px solid [[ColorPalette::TertiaryDark]];}
+
+.tiddler .defaultCommand {font-weight:bold;}
+
+.shadow .title {color:[[ColorPalette::TertiaryDark]];}
+
+.title {color:[[ColorPalette::SecondaryDark]];}
+.subtitle {color:[[ColorPalette::TertiaryDark]];}
+
+.toolbar {color:[[ColorPalette::PrimaryMid]];}
+.toolbar a {color:[[ColorPalette::TertiaryLight]];}
+.selected .toolbar a {color:[[ColorPalette::TertiaryMid]];}
+.selected .toolbar a:hover {color:[[ColorPalette::Foreground]];}
+
+.tagging, .tagged {border:1px solid [[ColorPalette::TertiaryPale]]; background-color:[[ColorPalette::TertiaryPale]];}
+.selected .tagging, .selected .tagged {background-color:[[ColorPalette::TertiaryLight]]; border:1px solid [[ColorPalette::TertiaryMid]];}
+.tagging .listTitle, .tagged .listTitle {color:[[ColorPalette::PrimaryDark]];}
+.tagging .button, .tagged .button {border:none;}
+
+.footer {color:[[ColorPalette::TertiaryLight]];}
+.selected .footer {color:[[ColorPalette::TertiaryMid]];}
+
+.sparkline {background:[[ColorPalette::PrimaryPale]]; border:0;}
+.sparktick {background:[[ColorPalette::PrimaryDark]];}
+
+.error, .errorButton {color:[[ColorPalette::Foreground]]; background:[[ColorPalette::Error]];}
+.warning {color:[[ColorPalette::Foreground]]; background:[[ColorPalette::SecondaryPale]];}
+.lowlight {background:[[ColorPalette::TertiaryLight]];}
+
+.zoomer {background:none; color:[[ColorPalette::TertiaryMid]]; border:3px solid [[ColorPalette::TertiaryMid]];}
+
+.imageLink, #displayArea .imageLink {background:transparent;}
+
+.annotation {background:[[ColorPalette::SecondaryLight]]; color:[[ColorPalette::Foreground]]; border:2px solid [[ColorPalette::SecondaryMid]];}
+
+.viewer .listTitle {list-style-type:none; margin-left:-2em;}
+.viewer .button {border:1px solid [[ColorPalette::SecondaryMid]];}
+.viewer blockquote {border-left:3px solid [[ColorPalette::TertiaryDark]];}
+
+.viewer table, table.twtable {border:2px solid [[ColorPalette::TertiaryDark]];}
+.viewer th, .viewer thead td, .twtable th, .twtable thead td {background:[[ColorPalette::SecondaryMid]]; border:1px solid [[ColorPalette::TertiaryDark]]; color:[[ColorPalette::Background]];}
+.viewer td, .viewer tr, .twtable td, .twtable tr {border:1px solid [[ColorPalette::TertiaryDark]];}
+
+.viewer pre {border:1px solid [[ColorPalette::SecondaryLight]]; background:[[ColorPalette::SecondaryPale]];}
+.viewer code {color:[[ColorPalette::SecondaryDark]];}
+.viewer hr {border:0; border-top:dashed 1px [[ColorPalette::TertiaryDark]]; color:[[ColorPalette::TertiaryDark]];}
+
+.highlight, .marked {background:[[ColorPalette::SecondaryLight]];}
+
+.editor input {border:1px solid [[ColorPalette::PrimaryMid]];}
+.editor textarea {border:1px solid [[ColorPalette::PrimaryMid]]; width:100%;}
+.editorFooter {color:[[ColorPalette::TertiaryMid]];}
+
+#backstageArea {background:[[ColorPalette::Foreground]]; color:[[ColorPalette::TertiaryMid]];}
+#backstageArea a {background:[[ColorPalette::Foreground]]; color:[[ColorPalette::Background]]; border:none;}
+#backstageArea a:hover {background:[[ColorPalette::SecondaryLight]]; color:[[ColorPalette::Foreground]]; }
+#backstageArea a.backstageSelTab {background:[[ColorPalette::Background]]; color:[[ColorPalette::Foreground]];}
+#backstageButton a {background:none; color:[[ColorPalette::Background]]; border:none;}
+#backstageButton a:hover {background:[[ColorPalette::Foreground]]; color:[[ColorPalette::Background]]; border:none;}
+#backstagePanel {background:[[ColorPalette::Background]]; border-color: [[ColorPalette::Background]] [[ColorPalette::TertiaryDark]] [[ColorPalette::TertiaryDark]] [[ColorPalette::TertiaryDark]];}
+.backstagePanelFooter .button {border:none; color:[[ColorPalette::Background]];}
+.backstagePanelFooter .button:hover {color:[[ColorPalette::Foreground]];}
+#backstageCloak {background:[[ColorPalette::Foreground]]; opacity:0.6; filter:'alpha(opacity:60)';}
+/*}}}*/

+

+

+
/*{{{*/
+* html .tiddler {height:1%;}
+
+body {font-size:.75em; font-family:arial,helvetica; margin:0; padding:0;}
+
+h1,h2,h3,h4,h5,h6 {font-weight:bold; text-decoration:none;}
+h1,h2,h3 {padding-bottom:1px; margin-top:1.2em;margin-bottom:0.3em;}
+h4,h5,h6 {margin-top:1em;}
+h1 {font-size:1.35em;}
+h2 {font-size:1.25em;}
+h3 {font-size:1.1em;}
+h4 {font-size:1em;}
+h5 {font-size:.9em;}
+
+hr {height:1px;}
+
+a {text-decoration:none;}
+
+dt {font-weight:bold;}
+
+ol {list-style-type:decimal;}
+ol ol {list-style-type:lower-alpha;}
+ol ol ol {list-style-type:lower-roman;}
+ol ol ol ol {list-style-type:decimal;}
+ol ol ol ol ol {list-style-type:lower-alpha;}
+ol ol ol ol ol ol {list-style-type:lower-roman;}
+ol ol ol ol ol ol ol {list-style-type:decimal;}
+
+.txtOptionInput {width:11em;}
+
+#contentWrapper .chkOptionInput {border:0;}
+
+.externalLink {text-decoration:underline;}
+
+.indent {margin-left:3em;}
+.outdent {margin-left:3em; text-indent:-3em;}
+code.escaped {white-space:nowrap;}
+
+.tiddlyLinkExisting {font-weight:bold;}
+.tiddlyLinkNonExisting {font-style:italic;}
+
+/* the 'a' is required for IE, otherwise it renders the whole tiddler in bold */
+a.tiddlyLinkNonExisting.shadow {font-weight:bold;}
+
+#mainMenu .tiddlyLinkExisting,
+	#mainMenu .tiddlyLinkNonExisting,
+	#sidebarTabs .tiddlyLinkNonExisting {font-weight:normal; font-style:normal;}
+#sidebarTabs .tiddlyLinkExisting {font-weight:bold; font-style:normal;}
+
+.header {position:relative;}
+.header a:hover {background:transparent;}
+.headerShadow {position:relative; padding:4.5em 0em 1em 1em; left:-1px; top:-1px;}
+.headerForeground {position:absolute; padding:4.5em 0em 1em 1em; left:0px; top:0px;}
+
+.siteTitle {font-size:3em;}
+.siteSubtitle {font-size:1.2em;}
+
+#mainMenu {position:absolute; left:0; width:10em; text-align:right; line-height:1.6em; padding:1.5em 0.5em 0.5em 0.5em; font-size:1.1em;}
+
+#sidebar {position:absolute; right:3px; width:16em; font-size:.9em;}
+#sidebarOptions {padding-top:0.3em;}
+#sidebarOptions a {margin:0em 0.2em; padding:0.2em 0.3em; display:block;}
+#sidebarOptions input {margin:0.4em 0.5em;}
+#sidebarOptions .sliderPanel {margin-left:1em; padding:0.5em; font-size:.85em;}
+#sidebarOptions .sliderPanel a {font-weight:bold; display:inline; padding:0;}
+#sidebarOptions .sliderPanel input {margin:0 0 .3em 0;}
+#sidebarTabs .tabContents {width:15em; overflow:hidden;}
+
+.wizard {padding:0.1em 1em 0em 2em;}
+.wizard h1 {font-size:2em; font-weight:bold; background:none; padding:0em 0em 0em 0em; margin:0.4em 0em 0.2em 0em;}
+.wizard h2 {font-size:1.2em; font-weight:bold; background:none; padding:0em 0em 0em 0em; margin:0.4em 0em 0.2em 0em;}
+.wizardStep {padding:1em 1em 1em 1em;}
+.wizard .button {margin:0.5em 0em 0em 0em; font-size:1.2em;}
+.wizardFooter {padding:0.8em 0.4em 0.8em 0em;}
+.wizardFooter .status {padding:0em 0.4em 0em 0.4em; margin-left:1em;}
+.wizard .button {padding:0.1em 0.2em 0.1em 0.2em;}
+
+#messageArea {position:fixed; top:2em; right:0em; margin:0.5em; padding:0.5em; z-index:2000; _position:absolute;}
+.messageToolbar {display:block; text-align:right; padding:0.2em 0.2em 0.2em 0.2em;}
+#messageArea a {text-decoration:underline;}
+
+.tiddlerPopupButton {padding:0.2em 0.2em 0.2em 0.2em;}
+.popupTiddler {position: absolute; z-index:300; padding:1em 1em 1em 1em; margin:0;}
+
+.popup {position:absolute; z-index:300; font-size:.9em; padding:0; list-style:none; margin:0;}
+.popup .popupMessage {padding:0.4em;}
+.popup hr {display:block; height:1px; width:auto; padding:0; margin:0.2em 0em;}
+.popup li.disabled {padding:0.4em;}
+.popup li a {display:block; padding:0.4em; font-weight:normal; cursor:pointer;}
+.listBreak {font-size:1px; line-height:1px;}
+.listBreak div {margin:2px 0;}
+
+.tabset {padding:1em 0em 0em 0.5em;}
+.tab {margin:0em 0em 0em 0.25em; padding:2px;}
+.tabContents {padding:0.5em;}
+.tabContents ul, .tabContents ol {margin:0; padding:0;}
+.txtMainTab .tabContents li {list-style:none;}
+.tabContents li.listLink { margin-left:.75em;}
+
+#contentWrapper {display:block;}
+#splashScreen {display:none;}
+
+#displayArea {margin:1em 17em 0em 14em;}
+
+.toolbar {text-align:right; font-size:.9em;}
+
+.tiddler {padding:1em 1em 0em 1em;}
+
+.missing .viewer,.missing .title {font-style:italic;}
+
+.title {font-size:1.6em; font-weight:bold;}
+
+.missing .subtitle {display:none;}
+.subtitle {font-size:1.1em;}
+
+.tiddler .button {padding:0.2em 0.4em;}
+
+.tagging {margin:0.5em 0.5em 0.5em 0; float:left; display:none;}
+.isTag .tagging {display:block;}
+.tagged {margin:0.5em; float:right;}
+.tagging, .tagged {font-size:0.9em; padding:0.25em;}
+.tagging ul, .tagged ul {list-style:none; margin:0.25em; padding:0;}
+.tagClear {clear:both;}
+
+.footer {font-size:.9em;}
+.footer li {display:inline;}
+
+.annotation {padding:0.5em; margin:0.5em;}
+
+* html .viewer pre {width:99%; padding:0 0 1em 0;}
+.viewer {line-height:1.4em; padding-top:0.5em;}
+.viewer .button {margin:0em 0.25em; padding:0em 0.25em;}
+.viewer blockquote {line-height:1.5em; padding-left:0.8em;margin-left:2.5em;}
+.viewer ul, .viewer ol {margin-left:0.5em; padding-left:1.5em;}
+
+.viewer table, table.twtable {border-collapse:collapse; margin:0.8em 1.0em;}
+.viewer th, .viewer td, .viewer tr,.viewer caption,.twtable th, .twtable td, .twtable tr,.twtable caption {padding:3px;}
+table.listView {font-size:0.85em; margin:0.8em 1.0em;}
+table.listView th, table.listView td, table.listView tr {padding:0px 3px 0px 3px;}
+
+.viewer pre {padding:0.5em; margin-left:0.5em; font-size:1.2em; line-height:1.4em; overflow:auto;}
+.viewer code {font-size:1.2em; line-height:1.4em;}
+
+.editor {font-size:1.1em;}
+.editor input, .editor textarea {display:block; width:100%; font:inherit;}
+.editorFooter {padding:0.25em 0em; font-size:.9em;}
+.editorFooter .button {padding-top:0px; padding-bottom:0px;}
+
+.fieldsetFix {border:0; padding:0; margin:1px 0px 1px 0px;}
+
+.sparkline {line-height:1em;}
+.sparktick {outline:0;}
+
+.zoomer {font-size:1.1em; position:absolute; overflow:hidden;}
+.zoomer div {padding:1em;}
+
+* html #backstage {width:99%;}
+* html #backstageArea {width:99%;}
+#backstageArea {display:none; position:relative; overflow: hidden; z-index:150; padding:0.3em 0.5em 0.3em 0.5em;}
+#backstageToolbar {position:relative;}
+#backstageArea a {font-weight:bold; margin-left:0.5em; padding:0.3em 0.5em 0.3em 0.5em;}
+#backstageButton {display:none; position:absolute; z-index:175; top:0em; right:0em;}
+#backstageButton a {padding:0.1em 0.4em 0.1em 0.4em; margin:0.1em 0.1em 0.1em 0.1em;}
+#backstage {position:relative; width:100%; z-index:50;}
+#backstagePanel {display:none; z-index:100; position:absolute; margin:0em 3em 0em 3em; padding:1em 1em 1em 1em;}
+.backstagePanelFooter {padding-top:0.2em; float:right;}
+.backstagePanelFooter a {padding:0.2em 0.4em 0.2em 0.4em;}
+#backstageCloak {display:none; z-index:20; position:absolute; width:100%; height:100px;}
+
+.whenBackstage {display:none;}
+.backstageVisible .whenBackstage {display:block;}
+/*}}}*/

+

+

+
/***
+StyleSheet for use when a translation requires any css style changes.
+This StyleSheet can be used directly by languages such as Chinese, Japanese and Korean which use a logographic writing system and need larger font sizes.
+***/
+
+/*{{{*/
+body {font-size:0.8em;}
+
+#sidebarOptions {font-size:1.05em;}
+#sidebarOptions a {font-style:normal;}
+#sidebarOptions .sliderPanel {font-size:0.95em;}
+
+.subtitle {font-size:0.8em;}
+
+.viewer table.listView {font-size:0.95em;}
+
+.htmlarea .toolbarHA table {border:1px solid ButtonFace; margin:0em 0em;}
+/*}}}*/

+

+

+
/*{{{*/
+@media print {
+#mainMenu, #sidebar, #messageArea, .toolbar, #backstageButton {display: none ! important;}
+#displayArea {margin: 1em 1em 0em 1em;}
+/* Fixes a feature in Firefox 1.5.0.2 where print preview displays the noscript content */
+noscript {display:none;}
+}
+/*}}}*/

+

+

+
<!--{{{-->
+<div class='header' macro='gradient vert [[ColorPalette::PrimaryLight]] [[ColorPalette::PrimaryMid]]'>
+<div class='headerShadow'>
+<span class='siteTitle' refresh='content' tiddler='SiteTitle'></span>&nbsp;
+<span class='siteSubtitle' refresh='content' tiddler='SiteSubtitle'></span>
+</div>
+<div class='headerForeground'>
+<span class='siteTitle' refresh='content' tiddler='SiteTitle'></span>&nbsp;
+<span class='siteSubtitle' refresh='content' tiddler='SiteSubtitle'></span>
+</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>
+<!--}}}-->

+

+

+
<!--{{{-->
+<div class='toolbar' macro='toolbar closeTiddler closeOthers +editTiddler > fields syncing permalink references jump'></div>
+<div class='title' macro='view title'></div>
+<div class='subtitle'><span macro='view modifier link'></span>, <span macro='view modified date'></span> (<span macro='message views.wikified.createdPrompt'></span> <span macro='view created date'></span>)</div>
+<div class='tagging' macro='tagging'></div>
+<div class='tagged' macro='tags'></div>
+<div class='viewer' macro='view text wikified'></div>
+<div class='tagClear'></div>
+<!--}}}-->

+

+

+
<!--{{{-->
+<div class='toolbar' macro='toolbar +saveTiddler -cancelTiddler deleteTiddler'></div>
+<div class='title' macro='view title'></div>
+<div class='editor' macro='edit title'></div>
+<div macro='annotations'></div>
+<div class='editor' macro='edit text'></div>
+<div class='editor' macro='edit tags'></div><div class='editorFooter'><span macro='message views.editor.tagPrompt'></span><span macro='tagChooser'></span></div>
+<!--}}}-->

+

+

+
To get started with this blank TiddlyWiki, you'll need to modify the following tiddlers:
+* SiteTitle & SiteSubtitle: The title and subtitle of the site, as shown above (after saving, they will also appear in the browser title bar)
+* MainMenu: The menu (usually on the left)
+* DefaultTiddlers: Contains the names of the tiddlers that you want to appear when the TiddlyWiki is opened
+You'll also need to enter your username for signing your edits: <<option txtUserName>>

+

+

+
These InterfaceOptions for customising TiddlyWiki are saved in your browser
+
+Your username for signing your edits. Write it as a WikiWord (eg JoeBloggs)
+
+<<option txtUserName>>
+<<option chkSaveBackups>> SaveBackups
+<<option chkAutoSave>> AutoSave
+<<option chkRegExpSearch>> RegExpSearch
+<<option chkCaseSensitiveSearch>> CaseSensitiveSearch
+<<option chkAnimate>> EnableAnimations
+
+----
+Also see AdvancedOptions

+

+

+
+

+

+
A task has a description, an estimate of how long it will take, and a record of how much time you have spent on it so far.  Here's an example, which shows a task estimated at 3 hours, with 1 hour spent on it, and ''2'' hours remaining:
+<<<
+<<task 3 3 1>> Add a double-click handler to the description cell that opens the editor and selects the text
+<<<
+If you hover the mouse over any part of the task -- the bullet, the description, or any of the numeric cells -- a tip will appear explaining it.
+
+Try modifying the time spent.  Suppose you've just spent one more hour and want to record it.  Just click on the second yellow cell, and enter "+1" (sans the quote marks, of course) in the popup window.  Watch the time remaining go down to 1 hour.
+
+In reality, I originally estimated this task at a half-hour, but it ended up taking 3.5 hours.  The macro also tracks your original estimate, if it is different from the current estimate, in a fourth cell like this:
+<<<
+<<task 0.5 2 1>> Add a double-click handler to the description cell that opens the editor and selects the text
+<<<
+You can adjust the current estimate in the same way as you adjusted the time spent.  Click on the current estimate cell (the first yellow cell), and change it to 2.5 hours by typing "2.5" or "+.5".
+
+You can also adjust the time remaining, which will modify either the estimate (if the time remaining increases) or the time spent (if it decreases).  Click on the time remaining and add an hour by typing "+1".
+
+When the time remaining goes to zero, the task is considered complete:
+<<<
+<<task 0.5 3.5 3.5>> Add a double-click handler to the description cell that opens the editor and selects the text
+<<<
+If you haven't already done so, try double-clicking the description.  Yes, it really does open up the editor and select just the text of the description.
+
+----
+To continue, click the down-arrow and choose another section: <<tag TaskMacroTutorial>>

+

+

+
A task's description is a single wikified line, so it can contain any formatting that can be specified on one line:
+<<<
+<<task 1>> Beef up the time click handlers to allow entry of ''two'' values each: cur&spent, spent&rem. Add click handler to done tasks' spent cells too, to reopen them (like with +0, 1).
+<<task 0.5>> Put tasksum on the ViewTemplate.
+<<<
+You can specify just the description of a task, and leave it unestimated.  Click the question mark to enter the estimate:
+<<<
+<<task>> Beef up the time click handlers to allow entry of ''two'' values each: cur&spent, spent&rem. Add click handler to done tasks' spent cells too, to reopen them (like with +0, 1).
+<<<
+As this task implies, you can enter two values in the popup when you click on any of the time cells.  Separate them with spaces and/or a comma.  Experiment:
+<<<
+<<task 1>> Beef up the time click handlers to allow entry of ''two'' values each: cur&spent, spent&rem. Add click handler to done tasks' spent cells too, to reopen them (like with +0, 1).
+<<<
+Finally, if you haven't already figured this out, you can double-click on a task's bullet to mark it complete, with the current estimate entered as the time spent.
+
+----
+To continue, click the down-arrow and choose another section: <<tag TaskMacroTutorial>>

+

+

+
If you've been paying attention, you've noticed that I haven't discussed the actual adding of calls to the task macro within your tiddlers -- it's all been about modifying tasks that were already there.  That's because adding tasks via the taskadder macro is much easier and more intuitive than adding them by hand.
+
+And setting up a taskadder is simplicity itself.  Just add {{{<<taskadder>>}}} to your tiddler.  You will see this:
+<<<
+<<taskadder>>
+<<<
+Just type a task description into the first field, and your initial estimate for how long it will take into the second field.  Click the "add task" button, or just hit Enter in either of the fields, to add the new task into the tiddler.  Notice that you can just start typing a new task as soon as you're done entering the first one.
+
+You can have as many taskadders as you like in any tiddler.  The last one you used will capture the keyboard focus when it is redisplayed, meaning you can type a series of tasks without using the mouse.  Try adding some tasks here and in the above adder:
+<<<
+<<taskadder>>
+<<<
+Notice that the one you just used takes focus when this tiddler is redisplayed.
+
+A taskadder by default adds tasks above itself.  You can make it add them below by adding a {{{below}}} argument to the macro call:
+<<<
+<<taskadder below>>
+<<<
+
+----
+To continue, click the down-arrow and choose another section: <<tag TaskMacroTutorial>>

+

+

+
In this tutorial, we've been looking mostly at individual tasks.  In real life, though, you'll typically have a series of them, or even several series of them in the same tiddler.  In these cases you want a summary that tells you -- at a minimum -- how much time you still expect to spend on these tasks.
+
+To get such a summary, just add {{{<<tasksum start>>}}} before the tasks and {{{<<tasksum end>>}}} after them.  Here's an example:
+<<<
+<<tasksum start>>
+<<task 0.25 0.25 0.25>> Add tooltips to the various cells
+<<task 1 0.75 0.75>> Figure out how to add auto-updating click handlers to the time cells
+<<task 2 2 0>> Add simple click handlers to cur, spent, rem: just allow direct setting of values
+<<task 1 3.5 2.5>> Add a double-click handler to the desc cell that opens the editor and selects the text
+<<task 1 1 0>> Beef up the time click handlers to allow entry of two values each: cur&spent, spent&rem. Add click handler to done tasks' spent cells too, to reopen them (like with +0, 1).
+<<task 1 1 0>> Beef up the time click handlers to handle leading + or -
+<<task 1 1 0>> Add a double-click handler to the status cell that functions like typing 0 into the rem cell
+<<tasksum end>>
+<<<
+If you'd rather have the summary at the top, just add {{{here}}} to the start call, ie {{{<<tasksum start here>>}}}.
+<<<
+<<tasksum start here>>
+<<task 0.25 0.25 0.25>> Add tooltips to the various cells
+<<task 1 0.75 0.75>> Figure out how to add auto-updating click handlers to the time cells
+<<task 2 2 0>> Add simple click handlers to cur, spent, rem: just allow direct setting of values
+<<tasksum end>>
+<<<
+You can nest these things if you like, just be sure to match starts and ends:
+<<<
+<<tasksum start here>>
+* Time cell manipulation:<<tasksum start>>
+<<task 1 0.75 0.75>> Figure out how to add auto-updating click handlers to the time cells
+<<task 2 2 0>> Add simple click handlers to cur, spent, rem: just allow direct setting of values
+<<task 1 1 0>> Beef up the time click handlers to allow entry of two values each: cur&spent, spent&rem. Add click handler to done tasks' spent cells too, to reopen them (like with +0, 1).
+<<task 1 1 0>> Beef up the time click handlers to handle leading + or -
+<<tasksum end "Cell manipulation:">>
+<<br>>
+* Double-click handling:<<tasksum start>>
+<<task 1 3.5 2.5>> Add a double-click handler to the desc cell that opens the editor and selects the text
+<<task 1 1 0>> Add a double-click handler to the status cell that functions like typing 0 into the rem cell
+<<tasksum end "Double-clicks:">>
+
+<<tasksum end>>
+<<<
+Finally, the simplest way to use tasksum is to add it to your view template.  See TaskSummaryViewTemplate for an example template.  Note that if no tasks are present between the start and end, nothing is displayed.
+
+----
+To continue, click the down-arrow and choose another section: <<tag TaskMacroTutorial>>

+

+

+
The TaskMacroPlugin can be installed like any other TiddlyWiki plugin, and used without further effort.  However, there are two issues that may affect you.  (To get started with a brand new wiki that does not have these issues, consider downloading the [[empty LabWiki|empty_labwiki.html]].)
+# The task macros don't play nicely with the default TiddlyWiki display of tags.  In the default view template, a tiddler's list of tags is shown in a little box that floats in the upper right corner of the tiddler.  However, this little box may interfere with the tables used by the task macros.  In Firefox, the tables are drawn right over the top of the tag box, rendering both of them illegible.  In Internet Explorer, the tag box forces the tables to be pushed down below the box, which can waste a lot of space.<<br>><<br>>Thus, I recommend changing your view template to eliminate the little box.  If you use Simon Baird's [[TagglyTagging|http://simonbaird.com/mptw/#TagglyTagging]] (as LabWiki does), then my TaskSummaryViewTemplate might be a good alternative.  Simply import it into your wiki and rename it to ViewTemplate.  This template also demonstrates how to incorporate the tasksum macro into every tiddler so any tiddler with tasks has a summary at the top.<<br>><<br>>
+# Most view templates also add a minus sign ("-") before the "close" command.  TiddlyWiki interprets this to mean that you want the close command to be executed if you hit the Escape key from within the tiddler.<<br>><<br>>However, most tiddlers never have focus, and so never give you the opportunity to try it out.  But if you have a taskadder in your tiddler, then you suddenly enable this feature -- and you probably don't want it.  It means that if you type a nice long task description and then hit Escape, that description will be lost and the tiddler will be closed.  So I recommend that you remove the minus sign from the view template's menu altogether, as I have done in LabWiki's own ViewTemplate.
+
+----
+This ends the tutorial.  To go back to any previous section, click the down-arrow and choose it: <<tag TaskMacroTutorial>>

+

+

+
PageTemplate
+|>|SiteTitle - SiteSubtitle|
+|>|MainMenu|
+|DefaultTiddlers<<br>><<br>><<br>>ViewTemplate<<br>><<br>>EditTemplate|SideBarOptions|
+|~|OptionsPanel|
+|~|SideBarTabs|
+|~|AdvancedOptions|
+|~|<<tiddler Configuration.SideBarTabs>>|
+
+''StyleSheet:'' StyleSheetColors - StyleSheetLayout - StyleSheetPrint
+
+ColorPalette
+
+SiteUrl

+

+

+
/***
+|Name|BetterTimelineMacro|
+|Created by|SaqImtiaz|
+|Location|http://tw.lewcid.org/#BetterTimelineMacro|
+|Version|0.5 beta|
+|Requires|~TW2.x|
+!!!Description:
+A replacement for the core timeline macro that offers more features:
+*list tiddlers with only specfic tag
+*exclude tiddlers with a particular tag
+*limit entries to any number of days, for example one week
+*specify a start date for the timeline, only tiddlers after that date will be listed.
+
+!!!Installation:
+Copy the contents of this tiddler to your TW, tag with systemConfig, save and reload your TW.
+Edit the ViewTemplate to add the fullscreen command to the toolbar.
+
+!!!Syntax:
+{{{<<timeline better:true>>}}}
+''the param better:true enables the advanced features, without it you will get the old timeline behaviour.''
+
+additonal params:
+(use only the ones you want)
+{{{<<timeline better:true  onlyTag:Tag1 excludeTag:Tag2 sortBy:modified/created firstDay:YYYYMMDD maxDays:7 maxEntries:30>>}}}
+
+''explanation of syntax:''
+onlyTag: only tiddlers with this tag will be listed. Default is to list all tiddlers.
+excludeTag: tiddlers with this tag will not be listed.
+sortBy: sort tiddlers by date modified or date created. Possible values are modified or created.
+firstDay: useful for starting timeline from a specific date. Example: 20060701 for 1st of July, 2006
+maxDays: limits timeline to include only tiddlers from the specified number of days. If you use a value of 7 for example, only tiddlers from the last 7 days will be listed.
+maxEntries: limit the total number of entries in the timeline.
+
+
+!!!History:
+*28-07-06: ver 0.5 beta, first release
+
+!!!Code
+***/
+//{{{
+// Return the tiddlers as a sorted array
+TiddlyWiki.prototype.getTiddlers = function(field,excludeTag,includeTag)
+{
+          var results = [];
+          this.forEachTiddler(function(title,tiddler)
+          {
+          if(excludeTag == undefined || tiddler.tags.find(excludeTag) == null)
+                        if(includeTag == undefined || tiddler.tags.find(includeTag)!=null)
+                                      results.push(tiddler);
+          });
+          if(field)
+                   results.sort(function (a,b) {if(a[field] == b[field]) return(0); else return (a[field] < b[field]) ? -1 : +1; });
+          return results;
+}
+
+
+
+//this function by Udo
+function getParam(params, name, defaultValue)
+{
+          if (!params)
+          return defaultValue;
+          var p = params[0][name];
+          return p ? p[0] : defaultValue;
+}
+
+window.old_timeline_handler= config.macros.timeline.handler;
+config.macros.timeline.handler = function(place,macroName,params,wikifier,paramString,tiddler)
+{
+          var args = paramString.parseParams("list",null,true);
+          var betterMode = getParam(args, "better", "false");
+          if (betterMode == 'true')
+          {
+          var sortBy = getParam(args,"sortBy","modified");
+          var excludeTag = getParam(args,"excludeTag",undefined);
+          var includeTag = getParam(args,"onlyTag",undefined);
+          var tiddlers = store.getTiddlers(sortBy,excludeTag,includeTag);
+          var firstDayParam = getParam(args,"firstDay",undefined);
+          var firstDay = (firstDayParam!=undefined)? firstDayParam: "00010101";
+          var lastDay = "";
+          var field= sortBy;
+          var maxDaysParam = getParam(args,"maxDays",undefined);
+          var maxDays = (maxDaysParam!=undefined)? maxDaysParam*24*60*60*1000: (new Date()).getTime() ;
+          var maxEntries = getParam(args,"maxEntries",undefined);
+          var last = (maxEntries!=undefined) ? tiddlers.length-Math.min(tiddlers.length,parseInt(maxEntries)) : 0;
+          for(var t=tiddlers.length-1; t>=last; t--)
+                  {
+                  var tiddler = tiddlers[t];
+                  var theDay = tiddler[field].convertToLocalYYYYMMDDHHMM().substr(0,8);
+                  if ((theDay>=firstDay)&& (tiddler[field].getTime()> (new Date()).getTime() - maxDays))
+                     {
+                     if(theDay != lastDay)
+                               {
+                               var theDateList = document.createElement("ul");
+                               place.appendChild(theDateList);
+                               createTiddlyElement(theDateList,"li",null,"listTitle",tiddler[field].formatString(this.dateFormat));
+                               lastDay = theDay;
+                               }
+                  var theDateListItem = createTiddlyElement(theDateList,"li",null,"listLink",null);
+                  theDateListItem.appendChild(createTiddlyLink(place,tiddler.title,true));
+                  }
+                  }
+          }
+
+          else
+              {
+              window.old_timeline_handler.apply(this,arguments);
+              }
+}
+//}}}

+

+

+
! Programming Languages
+ * C
+  a C99 compatible compiler, some GCC extensions are used, most are optional.
+ * C++
+  C++98 with some boost and tr1 additions
+ * bash
+  some build scripts (test.sh, ..) use bash specific extensions
+
+! Build Tools
+ * scons
+ * autotools
+ * Doxygen
+ * test.sh (included)
+
+! Extra tools
+ * git
+ * bouml
+
+! Libraries
+ * boost
+ * NoBug
+ * gavl
+

+

+

+
Background: #fff
+Foreground: #000
+PrimaryPale: #aaf
+PrimaryLight: #88f
+PrimaryMid: #00d
+PrimaryDark: #004
+SecondaryPale: #ffc
+SecondaryLight: #fe8
+SecondaryMid: #db4
+SecondaryDark: #841
+TertiaryPale: #eee
+TertiaryLight: #ccc
+TertiaryMid: #999
+TertiaryDark: #666
+Error: #f88

+

+

+
Overview

+

+

+
/***
+|Name|FullScreenPlugin|
+|Created by|SaqImtiaz|
+|Location|http://tw.lewcid.org/#FullScreenPlugin|
+|Version|1.1|
+|Requires|~TW2.x|
+!Description:
+Toggle between viewing tiddlers fullscreen and normally. Very handy for when you need more viewing space.
+
+!Demo:
+Click the ↕ button in the toolbar for this tiddler. Click it again to turn off fullscreen.
+
+!Installation:
+Copy the contents of this tiddler to your TW, tag with systemConfig, save and reload your TW.
+Edit the ViewTemplate to add the fullscreen command to the toolbar.
+
+!History:
+*25-07-06: ver 1.1
+*20-07-06: ver 1.0
+
+!Code
+***/
+//{{{
+var lewcidFullScreen = false;
+
+config.commands.fullscreen =
+{
+            text:" ↕ ",
+            tooltip:"Fullscreen mode"
+};
+
+config.commands.fullscreen.handler = function (event,src,title)
+{
+            if (lewcidFullScreen == false)
+               {
+                lewcidFullScreen = true;
+                setStylesheet('#sidebar, .header, #mainMenu{display:none;} #displayArea{margin:0em 0 0 0 !important;}',"lewcidFullScreenStyle");
+               }
+            else
+               {
+                lewcidFullScreen = false;
+                setStylesheet(' ',"lewcidFullScreenStyle");
+               }
+}
+
+config.macros.fullscreen={};
+config.macros.fullscreen.handler =  function(place,macroName,params,wikifier,paramString,tiddler)
+{
+        var label = params[0]||" ↕ ";
+        var tooltip = params[1]||"Fullscreen mode";
+        createTiddlyButton(place,label,tooltip,config.commands.fullscreen.handler);
+}
+
+var lewcid_fullscreen_closeTiddler = Story.prototype.closeTiddler;
+Story.prototype.closeTiddler =function(title,animate,slowly)
+{
+           lewcid_fullscreen_closeTiddler.apply(this,arguments);
+           if (story.isEmpty() && lewcidFullScreen == true)
+              config.commands.fullscreen.handler();
+}
+
+
+Slider.prototype.lewcidStop = Slider.prototype.stop;
+Slider.prototype.stop = function()
+{
+           this.lewcidStop();
+           if (story.isEmpty() && lewcidFullScreen == true)
+              config.commands.fullscreen.handler();
+}
+//}}}

+

+

+
! Platform
+We work and test on PC hardware, 32 and 64 bit. It is intended that Lumiera runs on other platforms which run GNU/Linux.
+
+! Graphics
+There are no special requirements for the graphic system, using of OpenGL will likely be defined by the single plugins. Anyways it will be strictly optional.
+
+! Disks
+Video editing requires decent disk speed, it is suggested to use a fast/big array of disks configured as raid.
+
+! Special Hardware
+There are currently no plans to add support for propietary hardware accelerator boards. We don't have such hardware and we don't want to tie a free software program to closed hardware. This might change if the benefits are worth it, someone dontates such hardware to the developers, the specs of the hardware and the programming API are open.
+

+

+

+
/***
+''InlineJavascriptPlugin for ~TiddlyWiki version 1.2.x and 2.0''
+^^author: Eric Shulman - ELS Design Studios
+source: http://www.TiddlyTools.com/#InlineJavascriptPlugin
+license: [[Creative Commons Attribution-ShareAlike 2.5 License|http://creativecommons.org/licenses/by-sa/2.5/]]^^
+
+Insert Javascript executable code directly into your tiddler content. Lets you ''call directly into TW core utility routines, define new functions, calculate values, add dynamically-generated TiddlyWiki-formatted output'' into tiddler content, or perform any other programmatic actions each time the tiddler is rendered.
+!!!!!Usage
+<<<
+When installed, this plugin adds new wiki syntax for surrounding tiddler content with {{{<script>}}} and {{{</script>}}} markers, so that it can be treated as embedded javascript and executed each time the tiddler is rendered.
+
+''Deferred execution from an 'onClick' link''
+By including a label="..." parameter in the initial {{{<script>}}} marker, the plugin will create a link to an 'onclick' script that will only be executed when that specific link is clicked, rather than running the script each time the tiddler is rendered.
+
+''External script source files:''
+You can also load javascript from an external source URL, by including a src="..." parameter in the initial {{{<script>}}} marker (e.g., {{{<script src="demo.js"></script>}}}). This is particularly useful when incorporating third-party javascript libraries for use in custom extensions and plugins. The 'foreign' javascript code remains isolated in a separate file that can be easily replaced whenever an updated library file becomes available.
+
+''Defining javascript functions and libraries:''
+Although the external javascript file is loaded while the tiddler content is being rendered, any functions it defines will not be available for use until //after// the rendering has been completed. Thus, you cannot load a library and //immediately// use it's functions within the same tiddler. However, once that tiddler has been loaded, the library functions can be freely used in any tiddler (even the one in which it was initially loaded).
+
+To ensure that your javascript functions are always available when needed, you should load the libraries from a tiddler that will be rendered as soon as your TiddlyWiki document is opened. For example, you could put your {{{<script src="..."></script>}}} syntax into a tiddler called LoadScripts, and then add {{{<<tiddler LoadScripts>>}}} in your MainMenu tiddler.
+
+Since the MainMenu is always rendered immediately upon opening your document, the library will always be loaded before any other tiddlers that rely upon the functions it defines. Loading an external javascript library does not produce any direct output in the tiddler, so these definitions should have no impact on the appearance of your MainMenu.
+
+''Creating dynamic tiddler content''
+An important difference between this implementation of embedded scripting and conventional embedded javascript techniques for web pages is the method used to produce output that is dynamically inserted into the document:
+* In a typical web document, you use the document.write() function to output text sequences (often containing HTML tags) that are then rendered when the entire document is first loaded into the browser window.
+* However, in a ~TiddlyWiki document, tiddlers (and other DOM elements) are created, deleted, and rendered "on-the-fly", so writing directly to the global 'document' object does not produce the results you want (i.e., replacing the embedded script within the tiddler content), and completely replaces the entire ~TiddlyWiki document in your browser window.
+* To allow these scripts to work unmodified, the plugin automatically converts all occurences of document.write() so that the output is inserted into the tiddler content instead of replacing the entire ~TiddlyWiki document.
+
+If your script does not use document.write() to create dynamically embedded content within a tiddler, your javascript can, as an alternative, explicitly return a text value that the plugin can then pass through the wikify() rendering engine to insert into the tiddler display. For example, using {{{return "thistext"}}} will produce the same output as {{{document.write("thistext")}}}.
+
+//Note: your script code is automatically 'wrapped' inside a function, {{{_out()}}}, so that any return value you provide can be correctly handled by the plugin and inserted into the tiddler. To avoid unpredictable results (and possibly fatal execution errors), this function should never be redefined or called from ''within'' your script code.//
+
+''Accessing the ~TiddlyWiki DOM''
+The plugin provides one pre-defined variable, 'place', that is passed in to your javascript code so that it can have direct access to the containing DOM element into which the tiddler output is currently being rendered.
+
+Access to this DOM element allows you to create scripts that can:
+* vary their actions based upon the specific location in which they are embedded
+* access 'tiddler-relative' information (use findContainingTiddler(place))
+* perform direct DOM manipulations (when returning wikified text is not enough)
+<<<
+!!!!!Examples
+<<<
+an "alert" message box:
+{{{
+<script>alert('InlineJavascriptPlugin: this is a demonstration message');</script>
+}}}
+<script>alert('InlineJavascriptPlugin: this is a demonstration message');</script>
+
+dynamic output:
+{{{
+<script>return (new Date()).toString();</script>
+}}}
+<script>return (new Date()).toString();</script>
+
+wikified dynamic output:
+{{{
+<script>return "link to current user: [["+config.options.txtUserName+"]]";</script>
+}}}
+<script>return "link to current user: [["+config.options.txtUserName+"]]";</script>
+
+dynamic output using 'place' to get size information for current tiddler
+{{{
+<script>
+ if (!window.story) window.story=window;
+ var title=story.findContainingTiddler(place).id.substr(7);
+ return title+" is using "+store.getTiddlerText(title).length+" bytes";
+</script>
+}}}
+<script>
+ if (!window.story) window.story=window;
+ var title=story.findContainingTiddler(place).id.substr(7);
+ return title+" is using "+store.getTiddlerText(title).length+" bytes";
+</script>
+
+creating an 'onclick' button/link that runs a script
+{{{
+<script label="click here">
+ if (!window.story) window.story=window;
+ alert("Hello World!\nlinktext='"+place.firstChild.data+"'\ntiddler='"+story.findContainingTiddler(place).id.substr(7)+"'");
+</script>
+}}}
+<script label="click here">
+ if (!window.story) window.story=window;
+ alert("Hello World!\nlinktext='"+place.firstChild.data+"'\ntiddler='"+story.findContainingTiddler(place).id.substr(7)+"'");
+</script>
+
+loading a script from a source url
+{{{
+<script src="demo.js">return "loading demo.js..."</script>
+<script label="click to execute demo() function">demo()</script>
+}}}
+where http://www.TiddlyTools.com/demo.js contains:
+>function demo() { alert('this output is from demo(), defined in demo.js') }
+>alert('InlineJavascriptPlugin: demo.js has been loaded');
+<script src="demo.js">return "loading demo.js..."</script>
+<script label="click to execute demo() function">demo()</script>
+<<<
+!!!!!Installation
+<<<
+import (or copy/paste) the following tiddlers into your document:
+''InlineJavascriptPlugin'' (tagged with <<tag systemConfig>>)
+<<<
+!!!!!Revision History
+<<<
+''2006.01.05 [1.4.0]''
+added support 'onclick' scripts. When label="..." param is present, a button/link is created using the indicated label text, and the script is only executed when the button/link is clicked. 'place' value is set to match the clicked button/link element.
+''2005.12.13 [1.3.1]''
+when catching eval error in IE, e.description contains the error text, instead of e.toString(). Fixed error reporting so IE shows the correct response text. Based on a suggestion by UdoBorkowski
+''2005.11.09 [1.3.0]''
+for 'inline' scripts (i.e., not scripts loaded with src="..."), automatically replace calls to 'document.write()' with 'place.innerHTML+=' so script output is directed into tiddler content
+Based on a suggestion by BradleyMeck
+''2005.11.08 [1.2.0]''
+handle loading of javascript from an external URL via src="..." syntax
+''2005.11.08 [1.1.0]''
+pass 'place' param into scripts to provide direct DOM access 
+''2005.11.08 [1.0.0]''
+initial release
+<<<
+!!!!!Credits
+<<<
+This feature was developed by EricShulman from [[ELS Design Studios|http:/www.elsdesign.com]]
+<<<
+!!!!!Code
+***/
+//{{{
+version.extensions.inlineJavascript= {major: 1, minor: 4, revision: 0, date: new Date(2006,1,5)};
+
+config.formatters.push( {
+ name: "inlineJavascript",
+ match: "\\<script",
+ lookahead: "\\<script(?: src=\\\"((?:.|\\n)*?)\\\")?(?: label=\\\"((?:.|\\n)*?)\\\")?\\>((?:.|\\n)*?)\\</script\\>",
+
+ handler: function(w) {
+ var lookaheadRegExp = new RegExp(this.lookahead,"mg");
+ lookaheadRegExp.lastIndex = w.matchStart;
+ var lookaheadMatch = lookaheadRegExp.exec(w.source)
+ if(lookaheadMatch && lookaheadMatch.index == w.matchStart) {
+ if (lookaheadMatch[1]) { // load a script library
+ // make script tag, set src, add to body to execute, then remove for cleanup
+ var script = document.createElement("script"); script.src = lookaheadMatch[1];
+ document.body.appendChild(script); document.body.removeChild(script);
+ }
+ if (lookaheadMatch[2] && lookaheadMatch[3]) { // create a link to an 'onclick' script
+ // add a link, define click handler, save code in link (pass 'place'), set link attributes
+ var link=createTiddlyElement(w.output,"a",null,"tiddlyLinkExisting",lookaheadMatch[2]);
+ link.onclick=function(){try{return(eval(this.code))}catch(e){alert(e.description?e.description:e.toString())}}
+ link.code="function _out(place){"+lookaheadMatch[3]+"};_out(this);"
+ link.setAttribute("href","javascript:;"); link.setAttribute("title",""); link.style.cursor="pointer";
+ }
+ else if (lookaheadMatch[3]) { // run inline script code
+ var code="function _out(place){"+lookaheadMatch[3]+"};_out(w.output);"
+ code=code.replace(/document.write\(/gi,'place.innerHTML+=(');
+ try { var out = eval(code); } catch(e) { out = e.description?e.description:e.toString(); }
+ if (out && out.length) wikify(out,w.output);
+ }
+ w.nextMatch = lookaheadMatch.index + lookaheadMatch[0].length;
+ }
+ }
+} )
+//}}}
+

+

+

+
/***
+|''Name:''|InlineJavascriptPlugin|
+|''Source:''|http://www.TiddlyTools.com/#InlineJavascriptPlugin|
+|''Author:''|Eric Shulman - ELS Design Studios|
+|''License:''|[[Creative Commons Attribution-ShareAlike 2.5 License|http://creativecommons.org/licenses/by-sa/2.5/]]|
+|''~CoreVersion:''|2.0.10|
+
+Insert Javascript executable code directly into your tiddler content. Lets you ''call directly into TW core utility routines, define new functions, calculate values, add dynamically-generated TiddlyWiki-formatted output'' into tiddler content, or perform any other programmatic actions each time the tiddler is rendered.
+!!!!!Usage
+<<<
+When installed, this plugin adds new wiki syntax for surrounding tiddler content with {{{<script>}}} and {{{</script>}}} markers, so that it can be treated as embedded javascript and executed each time the tiddler is rendered.
+
+''Deferred execution from an 'onClick' link''
+By including a label="..." parameter in the initial {{{<script>}}} marker, the plugin will create a link to an 'onclick' script that will only be executed when that specific link is clicked, rather than running the script each time the tiddler is rendered.
+
+''External script source files:''
+You can also load javascript from an external source URL, by including a src="..." parameter in the initial {{{<script>}}} marker (e.g., {{{<script src="demo.js"></script>}}}). This is particularly useful when incorporating third-party javascript libraries for use in custom extensions and plugins. The 'foreign' javascript code remains isolated in a separate file that can be easily replaced whenever an updated library file becomes available.
+
+''Display script source in tiddler output''
+By including the keyword parameter "show", in the initial {{{<script>}}} marker, the plugin will include the script source code in the output that it displays in the tiddler.
+
+''Defining javascript functions and libraries:''
+Although the external javascript file is loaded while the tiddler content is being rendered, any functions it defines will not be available for use until //after// the rendering has been completed. Thus, you cannot load a library and //immediately// use it's functions within the same tiddler. However, once that tiddler has been loaded, the library functions can be freely used in any tiddler (even the one in which it was initially loaded).
+
+To ensure that your javascript functions are always available when needed, you should load the libraries from a tiddler that will be rendered as soon as your TiddlyWiki document is opened. For example, you could put your {{{<script src="..."></script>}}} syntax into a tiddler called LoadScripts, and then add {{{<<tiddler LoadScripts>>}}} in your MainMenu tiddler.
+
+Since the MainMenu is always rendered immediately upon opening your document, the library will always be loaded before any other tiddlers that rely upon the functions it defines. Loading an external javascript library does not produce any direct output in the tiddler, so these definitions should have no impact on the appearance of your MainMenu.
+
+''Creating dynamic tiddler content''
+An important difference between this implementation of embedded scripting and conventional embedded javascript techniques for web pages is the method used to produce output that is dynamically inserted into the document:
+* In a typical web document, you use the document.write() function to output text sequences (often containing HTML tags) that are then rendered when the entire document is first loaded into the browser window.
+* However, in a ~TiddlyWiki document, tiddlers (and other DOM elements) are created, deleted, and rendered "on-the-fly", so writing directly to the global 'document' object does not produce the results you want (i.e., replacing the embedded script within the tiddler content), and completely replaces the entire ~TiddlyWiki document in your browser window.
+* To allow these scripts to work unmodified, the plugin automatically converts all occurences of document.write() so that the output is inserted into the tiddler content instead of replacing the entire ~TiddlyWiki document.
+
+If your script does not use document.write() to create dynamically embedded content within a tiddler, your javascript can, as an alternative, explicitly return a text value that the plugin can then pass through the wikify() rendering engine to insert into the tiddler display. For example, using {{{return "thistext"}}} will produce the same output as {{{document.write("thistext")}}}.
+
+//Note: your script code is automatically 'wrapped' inside a function, {{{_out()}}}, so that any return value you provide can be correctly handled by the plugin and inserted into the tiddler. To avoid unpredictable results (and possibly fatal execution errors), this function should never be redefined or called from ''within'' your script code.//
+
+''Accessing the ~TiddlyWiki DOM''
+The plugin provides one pre-defined variable, 'place', that is passed in to your javascript code so that it can have direct access to the containing DOM element into which the tiddler output is currently being rendered.
+
+Access to this DOM element allows you to create scripts that can:
+* vary their actions based upon the specific location in which they are embedded
+* access 'tiddler-relative' information (use findContainingTiddler(place))
+* perform direct DOM manipulations (when returning wikified text is not enough)
+<<<
+!!!!!Examples
+<<<
+an "alert" message box:
+><script show>
+ alert('InlineJavascriptPlugin: this is a demonstration message');
+</script>
+dynamic output:
+><script show>
+ return (new Date()).toString();
+</script>
+wikified dynamic output:
+><script show>
+ return "link to current user: [["+config.options.txtUserName+"]]";
+</script>
+dynamic output using 'place' to get size information for current tiddler:
+><script show>
+ if (!window.story) window.story=window;
+ var title=story.findContainingTiddler(place).id.substr(7);
+ return title+" is using "+store.getTiddlerText(title).length+" bytes";
+</script>
+creating an 'onclick' button/link that runs a script:
+><script label="click here" show>
+ if (!window.story) window.story=window;
+ alert("Hello World!\nlinktext='"+place.firstChild.data+"'\ntiddler='"+story.findContainingTiddler(place).id.substr(7)+"'");
+</script>
+loading a script from a source url:
+>http://www.TiddlyTools.com/demo.js contains:
+>>{{{function demo() { alert('this output is from demo(), defined in demo.js') } }}}
+>>{{{alert('InlineJavascriptPlugin: demo.js has been loaded'); }}}
+><script src="demo.js" show>
+ return "loading demo.js..."
+</script>
+><script label="click to execute demo() function" show>
+ demo()
+</script>
+<<<
+!!!!!Installation
+<<<
+import (or copy/paste) the following tiddlers into your document:
+''InlineJavascriptPlugin'' (tagged with <<tag systemConfig>>)
+<<<
+!!!!!Revision History
+<<<
+''2006.06.01 [1.5.1]'' when calling wikify() on script return value, pass hightlightRegExp and tiddler params so macros that rely on these values can render properly
+''2006.04.19 [1.5.0]'' added 'show' parameter to force display of javascript source code in tiddler output
+''2006.01.05 [1.4.0]'' added support 'onclick' scripts. When label="..." param is present, a button/link is created using the indicated label text, and the script is only executed when the button/link is clicked. 'place' value is set to match the clicked button/link element.
+''2005.12.13 [1.3.1]'' when catching eval error in IE, e.description contains the error text, instead of e.toString(). Fixed error reporting so IE shows the correct response text. Based on a suggestion by UdoBorkowski
+''2005.11.09 [1.3.0]'' for 'inline' scripts (i.e., not scripts loaded with src="..."), automatically replace calls to 'document.write()' with 'place.innerHTML+=' so script output is directed into tiddler content. Based on a suggestion by BradleyMeck
+''2005.11.08 [1.2.0]'' handle loading of javascript from an external URL via src="..." syntax
+''2005.11.08 [1.1.0]'' pass 'place' param into scripts to provide direct DOM access 
+''2005.11.08 [1.0.0]'' initial release
+<<<
+!!!!!Credits
+<<<
+This feature was developed by EricShulman from [[ELS Design Studios|http:/www.elsdesign.com]]
+<<<
+!!!!!Code
+***/
+//{{{
+version.extensions.inlineJavascript= {major: 1, minor: 5, revision: 1, date: new Date(2006,6,1)};
+
+config.formatters.push( {
+ name: "inlineJavascript",
+ match: "\\<script",
+ lookahead: "\\<script(?: src=\\\"((?:.|\\n)*?)\\\")?(?: label=\\\"((?:.|\\n)*?)\\\")?( show)?\\>((?:.|\\n)*?)\\</script\\>",
+
+ handler: function(w) {
+ var lookaheadRegExp = new RegExp(this.lookahead,"mg");
+ lookaheadRegExp.lastIndex = w.matchStart;
+ var lookaheadMatch = lookaheadRegExp.exec(w.source)
+ if(lookaheadMatch && lookaheadMatch.index == w.matchStart) {
+ if (lookaheadMatch[1]) { // load a script library
+ // make script tag, set src, add to body to execute, then remove for cleanup
+ var script = document.createElement("script"); script.src = lookaheadMatch[1];
+ document.body.appendChild(script); document.body.removeChild(script);
+ }
+ if (lookaheadMatch[4]) { // there is script code
+ if (lookaheadMatch[3]) // show inline script code in tiddler output
+ wikify("{{{\n"+lookaheadMatch[0]+"\n}}}\n",w.output);
+ if (lookaheadMatch[2]) { // create a link to an 'onclick' script
+ // add a link, define click handler, save code in link (pass 'place'), set link attributes
+ var link=createTiddlyElement(w.output,"a",null,"tiddlyLinkExisting",lookaheadMatch[2]);
+ link.onclick=function(){try{return(eval(this.code))}catch(e){alert(e.description?e.description:e.toString())}}
+ link.code="function _out(place){"+lookaheadMatch[4]+"};_out(this);"
+ link.setAttribute("href","javascript:;"); link.setAttribute("title",""); link.style.cursor="pointer";
+ }
+ else { // run inline script code
+ var code="function _out(place){"+lookaheadMatch[4]+"};_out(w.output);"
+ code=code.replace(/document.write\(/gi,'place.innerHTML+=(');
+ try { var out = eval(code); } catch(e) { out = e.description?e.description:e.toString(); }
+ if (out && out.length) wikify(out,w.output,w.highlightRegExp,w.tiddler);
+ }
+ }
+ w.nextMatch = lookaheadMatch.index + lookaheadMatch[0].length;
+ }
+ }
+} )
+//}}}

+

+

+
''[[Lumiera|index.html]]''
+OperatingSystem
+[[Hardware]]
+[[Software]]
+BuildDependencies
+RuntimeDependencies
+StyleGuide
+[[Admin]]
+<<fullscreen>>

+

+

+
<!--{{{-->
+<link rel='alternate' type='application/rss+xml' title='RSS' href='index.xml'/>
+<!--}}}-->
+
+<style type="text/css">#contentWrapper {display:none;}</style><div id="SplashScreen" style="border: 3px solid #ccc; display: block; text-align: center; width: 320px; margin: 100px auto; padding: 50px; color:#000; font-size: 28px; font-family:Tahoma; background-color:#eee;"><b>My TiddlyWiki</b> is loading<blink> ...</blink><br><br><span style="font-size: 14px; color:red;">Requires Javascript.</span></div>

+

+

+
Lumiera is written for GNU/Linux. We try to make the best out of modern system programming techniques to reach the best possible performance. It is suggested to use a 64bit OS. Lumiera shall scale with the provided Hardware, the more RAM and the more/faster CPU's you have the better. Nevertheless lower end 32bit machines are supported too.
+
+Secondary targets will be other free operating systems which offer a decent Posix API. By coincidence it will be possible to port Lumiera to Mac OSX if anyone helps with that.
+
+Windows platforms are not on our target list, if someone wants to do port it, we will merge his efforts but unless that happens we will not care for windows compatibility.
+

+

+

+
 * OperatingSystem
+ * [[Hardware]]
+ * [[Software]]
+ * BuildDependencies
+ * RuntimeDependencies
+ * StyleGuide
+

+

+

+
<!--{{{-->
+<div class='header' macro='gradient vert [[ColorPalette::PrimaryLight]] [[ColorPalette::PrimaryMid]]'>
+	<div class='headerShadow'>
+		<span class='siteTitle' refresh='content' tiddler='SiteTitle'></span>&nbsp;
+		<span class='siteSubtitle' refresh='content' tiddler='SiteSubtitle'></span>
+	</div>
+	<div class='headerForeground'>
+		<span class='siteTitle' refresh='content' tiddler='SiteTitle'></span>&nbsp;
+		<span class='siteSubtitle' refresh='content' tiddler='SiteSubtitle'></span>
+	</div>
+</div>
+<!-- horizontal MainMenu -->
+<div id='topMenu' refresh='content' tiddler='MainMenu'></div>
+<!-- original MainMenu menu -->
+<!-- <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>
+<!--}}}-->
+

+

+

+
/***
+|<html><a name="Top"/></html>''Name:''|PartTiddlerPlugin|
+|''Version:''|1.0.6 (2006-11-07)|
+|''Source:''|http://tiddlywiki.abego-software.de/#PartTiddlerPlugin|
+|''Author:''|UdoBorkowski (ub [at] abego-software [dot] de)|
+|''Licence:''|[[BSD open source license]]|
+|''TiddlyWiki:''|2.0|
+|''Browser:''|Firefox 1.0.4+; InternetExplorer 6.0|
+!Table of Content<html><a name="TOC"/></html>
+* <html><a href="javascript:;" onclick="window.scrollAnchorVisible('Description',null, event)">Description, Syntax</a></html>
+* <html><a href="javascript:;" onclick="window.scrollAnchorVisible('Applications',null, event)">Applications</a></html>
+** <html><a href="javascript:;" onclick="window.scrollAnchorVisible('LongTiddler',null, event)">Refering to Paragraphs of a Longer Tiddler</a></html>
+** <html><a href="javascript:;" onclick="window.scrollAnchorVisible('Citation',null, event)">Citation Index</a></html>
+** <html><a href="javascript:;" onclick="window.scrollAnchorVisible('TableCells',null, event)">Creating "multi-line" Table Cells</a></html>
+** <html><a href="javascript:;" onclick="window.scrollAnchorVisible('Tabs',null, event)">Creating Tabs</a></html>
+** <html><a href="javascript:;" onclick="window.scrollAnchorVisible('Sliders',null, event)">Using Sliders</a></html>
+* <html><a href="javascript:;" onclick="window.scrollAnchorVisible('Revisions',null, event)">Revision History</a></html>
+* <html><a href="javascript:;" onclick="window.scrollAnchorVisible('Code',null, event)">Code</a></html>
+!Description<html><a name="Description"/></html>
+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, 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//.|
+|''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.|
+|<html><i>any&nbsp;tiddler&nbsp;content</i></html>|<html>The content of the part.<br>A part can have any content that a "normal" tiddler may have, e.g. you may use all the formattings and macros defined.</html>|
+|>|~~Syntax formatting: Keywords in ''bold'', optional parts in [...]. 'or' means that exactly one of the two alternatives must exist.~~|
+<html><sub><a href="javascript:;" onclick="window.scrollAnchorVisible('Top',null, event)">[Top]</sub></a></html>
+
+!Applications<html><a name="Applications"/></html>
+!!Refering to Paragraphs of a Longer Tiddler<html><a name="LongTiddler"/></html>
+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.
+
+<html><sub><a href="javascript:;" onclick="window.scrollAnchorVisible('Top',null, event)">[Top]</sub></a></html>
+
+!!Citation Index<html><a name="Citation"/></html>
+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]]}}}.
+
+<html><sub><a href="javascript:;" onclick="window.scrollAnchorVisible('Top',null, event)">[Top]</sub></a></html>
+
+!!Creating "multi-line" Table Cells<html><a name="TableCells"/></html>
+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.
+
+<html><sub><a href="javascript:;" onclick="window.scrollAnchorVisible('Top',null, event)">[Top]</sub></a></html>
+
+!!Creating Tabs<html><a name="Tabs"/></html>
+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:
+* SideBarTabs
+* TabAll
+* TabMore
+* TabMoreMissing
+* TabMoreOrphans
+* TabMoreShadowed
+* TabTags
+* TabTimeline
+
+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":""'>>
+}}}
+<html><sub><a href="javascript:;" onclick="window.scrollAnchorVisible('Top',null, event)">[Top]</sub></a></html>
+
+!!Using Sliders<html><a name="Sliders"/></html>
+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.
+
+<html><sub><a href="javascript:;" onclick="window.scrollAnchorVisible('Top',null, event)">[Top]</sub></a></html>
+
+!Revision history<html><a name="Revisions"/></html>
+* 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
+<html><sub><a href="javascript:;" onclick="window.scrollAnchorVisible('Top',null, event)">[Top]</sub></a></html>
+
+!Code<html><a name="Code"/></html>
+<html><sub><a href="javascript:;" onclick="window.scrollAnchorVisible('Top',null, event)">[Top]</sub></a></html>
+***/
+//{{{
+//============================================================================
+// PartTiddlerPlugin
+
+// Ensure that the PartTiddler Plugin is only installed once.
+//
+if (!version.extensions.PartTiddlerPlugin) {
+
+
+
+version.extensions.PartTiddlerPlugin = {
+ major: 1, minor: 0, revision: 6,
+ date: new Date(2006, 10, 7), 
+ 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[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 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 == ".") 
+ ? currentParent 
+ : oldFetchTiddler.apply(this, [parentName]);
+ if (parent) {
+ return getPart(parent, partName, parent.title+"/"+partName);
+ }
+ }
+ }
+ return result; 
+};
+
+
+// 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 = 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)
+ {
+ clearMessage();
+ story.displayTiddler(null,title,DEFAULT_EDIT_TEMPLATE);
+ story.focusTiddler(title,"text");
+ 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;
+
+// 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"
+//}}}
+
+/***
+<html><sub><a href="javascript:;" onclick="scrollAnchorVisible('Top',null, event)">[Top]</sub></a></html>
+
+!Licence and Copyright
+Copyright (c) abego Software ~GmbH, 2006 ([[www.abego-software.de|http://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.
+
+<html><sub><a href="javascript:;" onclick="scrollAnchorVisible('Top',null, event)">[Top]</sub></a></html>
+***/

+

+

+
/***
+|''Name:''|RSSReaderPlugin|
+|''Description:''|This plugin provides a RSSReader for TiddlyWiki|
+|''Version:''|1.1.1|
+|''Date:''|Apr 21, 2007|
+|''Source:''|http://tiddlywiki.bidix.info/#RSSReaderPlugin|
+|''Documentation:''|http://tiddlywiki.bidix.info/#RSSReaderPluginDoc|
+|''Author:''|BidiX (BidiX (at) bidix (dot) info)|
+|''Credit:''|BramChen for RssNewsMacro|
+|''License:''|[[BSD open source license|http://tiddlywiki.bidix.info/#%5B%5BBSD%20open%20source%20license%5D%5D ]]|
+|''~CoreVersion:''|2.2.0|
+|''OptionalRequires:''|http://www.tiddlytools.com/#NestedSlidersPlugin|
+***/
+//{{{
+version.extensions.RSSReaderPlugin = {
+	major: 1, minor: 1, revision: 1,
+	date: new Date("Apr 21, 2007"),
+	source: "http://TiddlyWiki.bidix.info/#RSSReaderPlugin",
+	author: "BidiX",
+	coreVersion: '2.2.0'
+};
+
+config.macros.rssReader = {
+	dateFormat: "DDD, DD MMM YYYY",
+	itemStyle: "display: block;border: 1px solid black;padding: 5px;margin: 5px;", //useed  '@@'+itemStyle+itemText+'@@'
+	msg:{
+		permissionDenied: "Permission to read preferences was denied.",
+		noRSSFeed: "No RSS Feed at this address %0",
+		urlNotAccessible: " Access to %0 is not allowed"
+	},
+	cache: [], 	// url => XMLHttpRequest.responseXML
+	desc: "noDesc",
+	
+	handler: function(place,macroName,params,wikifier,paramString,tiddler) {
+		var desc = params[0];
+		var feedURL = params[1];
+		var toFilter = (params[2] ? true : false);
+		var filterString = (toFilter?(params[2].substr(0,1) == ' '? tiddler.title:params[2]):'');
+		var place = createTiddlyElement(place, "div", "RSSReader");
+		wikify("^^<<rssFeedUpdate "+feedURL+" [[" + tiddler.title + "]]>>^^\n",place);
+		if (this.cache[feedURL]) {
+			this.displayRssFeed(this.cache[feedURL], feedURL, place, desc, toFilter, filterString);
+		}
+		else {
+			var r = loadRemoteFile(feedURL,config.macros.rssReader.processResponse, [place, desc, toFilter, filterString]);
+			if (typeof r == "string")
+				displayMessage(r);
+		}
+		
+	},
+
+	// callback for loadRemoteFile 
+	// params : [place, desc, toFilter, filterString]
+	processResponse: function(status, params, responseText, url, xhr) { // feedURL, place, desc, toFilter, filterString) {	
+		if (window.netscape){
+			try {
+				if (document.location.protocol.indexOf("http") == -1) {
+					netscape.security.PrivilegeManager.enablePrivilege("UniversalBrowserRead");
+				}
+			}
+			catch (e) { displayMessage(e.description?e.description:e.toString()); }
+		}
+		if (xhr.status == httpStatus.NotFound)
+		 {
+			displayMessage(config.macros.rssReader.noRSSFeed.format([url]));
+			return;
+		}
+		if (!status)
+		 {
+			displayMessage(config.macros.rssReader.noRSSFeed.format([url]));
+			return;
+		}
+		if (xhr.responseXML) {
+			// response is interpreted as XML
+			config.macros.rssReader.cache[url] = xhr.responseXML;
+			config.macros.rssReader.displayRssFeed(xhr.responseXML, params[0], url, params[1], params[2], params[3]);
+		}
+		else {
+			if (responseText.substr(0,5) == "<?xml") {
+				// response exists but not return as XML -> try to parse it 
+				var dom = (new DOMParser()).parseFromString(responseText, "text/xml"); 
+				if (dom) {
+					// parsing successful so use it
+					config.macros.rssReader.cache[url] = dom;
+					config.macros.rssReader.displayRssFeed(dom, params[0], url, params[1], params[2], params[3]);
+					return;
+				}
+			}
+			// no XML display as html 
+			wikify("<html>" + responseText + "</html>", params[0]);
+			displayMessage(config.macros.rssReader.msg.noRSSFeed.format([url]));
+		}
+	},
+
+	// explore down the DOM tree
+	displayRssFeed: function(xml, place, feedURL, desc, toFilter, filterString){
+		// Channel
+		var chanelNode = xml.getElementsByTagName('channel').item(0);
+		var chanelTitleElement = (chanelNode ? chanelNode.getElementsByTagName('title').item(0) : null);
+		var chanelTitle = "";
+		if ((chanelTitleElement) && (chanelTitleElement.firstChild)) 
+			chanelTitle = chanelTitleElement.firstChild.nodeValue;
+		var chanelLinkElement = (chanelNode ? chanelNode.getElementsByTagName('link').item(0) : null);
+		var chanelLink = "";
+		if (chanelLinkElement) 
+			chanelLink = chanelLinkElement.firstChild.nodeValue;
+		var titleTxt = "!![["+chanelTitle+"|"+chanelLink+"]]\n";
+		var title = createTiddlyElement(place,"div",null,"ChanelTitle",null);
+		wikify(titleTxt,title);
+		// ItemList
+		var itemList = xml.getElementsByTagName('item');
+		var article = createTiddlyElement(place,"ul",null,null,null);
+		var lastDate;
+		var re;
+		if (toFilter) 
+			re = new RegExp(filterString.escapeRegExp());
+		for (var i=0; i<itemList.length; i++){
+			var titleElm = itemList[i].getElementsByTagName('title').item(0);
+			var titleText = (titleElm ? titleElm.firstChild.nodeValue : '');
+			if (toFilter && ! titleText.match(re)) {
+				continue;
+			}
+			var descText = '';
+			descElem = itemList[i].getElementsByTagName('description').item(0);
+			if (descElem){
+				try{
+					for (var ii=0; ii<descElem.childNodes.length; ii++) {
+						descText += descElem.childNodes[ii].nodeValue;
+					}
+				}
+				catch(e){}
+				descText = descText.replace(/<br \/>/g,'\n');
+				if (desc == "asHtml")
+					descText = "<html>"+descText+"</html>";
+			}
+			var linkElm = itemList[i].getElementsByTagName("link").item(0);
+			var linkURL = linkElm.firstChild.nodeValue;
+			var pubElm = itemList[i].getElementsByTagName('pubDate').item(0);
+			var pubDate;
+			if (!pubElm) {
+				pubElm = itemList[i].getElementsByTagName('date').item(0); // for del.icio.us
+				if (pubElm) {
+					pubDate = pubElm.firstChild.nodeValue;
+					pubDate = this.formatDateString(this.dateFormat, pubDate);
+					}
+					else {
+						pubDate = '0';
+					}
+				}
+			else {
+				pubDate = (pubElm ? pubElm.firstChild.nodeValue : 0);
+				pubDate = this.formatDate(this.dateFormat, pubDate);
+			}
+			titleText = titleText.replace(/\[|\]/g,'');
+			var rssText = '*'+'[[' + titleText + '|' + linkURL + ']]' + '' ;
+			if ((desc != "noDesc") && descText){
+				rssText = rssText.replace(/\n/g,' ');
+				descText = '@@'+this.itemStyle+descText + '@@\n';				
+				if (version.extensions.nestedSliders){
+					descText = '+++[...]' + descText + '===';
+				}
+				rssText = rssText + descText;
+			}
+			var story;
+			if ((lastDate != pubDate) && ( pubDate != '0')) {
+				story = createTiddlyElement(article,"li",null,"RSSItem",pubDate);
+				lastDate = pubDate;
+			}
+			else {
+				lastDate = pubDate;
+			}
+			story = createTiddlyElement(article,"div",null,"RSSItem",null);
+			wikify(rssText,story);
+		}
+	},
+	
+	formatDate: function(template, date){
+		var dateString = new Date(date);
+		// template = template.replace(/hh|mm|ss/g,'');
+		return dateString.formatString(template);
+	},
+	
+	formatDateString: function(template, date){
+		var dateString = new Date(date.substr(0,4), date.substr(5,2) - 1, date.substr(8,2)
+			);
+		return dateString.formatString(template);
+	}
+	
+};
+
+config.macros.rssFeedUpdate = {
+	label: "Update",
+	prompt: "Clear the cache and redisplay this RssFeed",
+	handler: function(place,macroName,params) {
+		var feedURL = params[0];
+		var tiddlerTitle = params[1];
+		createTiddlyButton(place, this.label, this.prompt, 
+			function () {
+				if (config.macros.rssReader.cache[feedURL]) {
+					config.macros.rssReader.cache[feedURL] = null; 
+			}
+			story.refreshTiddler(tiddlerTitle,null, true);
+		return false;});
+	}
+};
+
+//}}}
+

+

+

+
//last update: RSSReaderPlugin v 1.1.1//
+
+!Description
+This plugin provides a RSSReader for TiddlyWiki
+* It accesses asynchronously an RSSFeed
+*Depending on the chanel item format, each item could be written as :
+**simple text wikified
+**html
+
+!Usage
+{{{
+<<rssReader noDesc|asHtml|asText rssUrl ['filtering string']>>
+	noDesc: only title of item is printed
+
+	asHtml: if you know that description contain html (links, img ...), 
+		the text is enclosed with <html> </html> tags
+
+ 	asText: if the description should not be interpreted as html the 
+		description is wikified
+
+	rssUrl: the rssFeed url that could be accessed. 
+	
+	'filtering string': if present, the rssfeed item title must contained 
+		this string to be displayed. 
+		If 'filering string' contained space characters only, the tiddler 
+		title is used for filtering.
+
+}}}
+
+For security reasons, if the TiddlyWiki is accessed from http, a ProxyService should be used to access an rssFeed from an other site.
+
+!examples
+| !reader | !RSSFeed type | !working from |
+| BidiXTWRSS | Description asHtml | file: or tiddlywiki.bidix.info |
+| [[Le Monde]] | Description asText | file: or tiddlywiki.bidix.info using proxy |
+| YahooNewsSport | Description asHtml | file: or tiddlywiki.bidix.info using proxy |
+| TiddlyWikiRSS | Description asHtml | file: or tiddlywiki.bidix.info using proxy |
+| [[Libération]] | noDesc | file: or tiddlywiki.bidix.info using proxy |
+| [[TestComment]] | asText and filters | file: or tiddlywiki.bidix.info using proxy |
+see : <<tag RSSFeed>> for the full list.
+
+!Revision history
+* V1.1.0 (2207/04/13)
+**No more import functions
+* V1.0.0 (2006/11/11)
+**refactoring using core loadRemoteFile function
+**import using new tiddlywiki:tiddler element
+**import and presentation preserved without EricShulman's NestedSliderPlugin
+**better display of items 
+* v0.3.0 (24/08/2006)
+** Filter on RSS item title
+** Place to display redefined for asynchronous processing
+* v0.2.2 (22/08/2006)
+**Haloscan feed has no pubDate.
+* v0.2.1 (08/05/2006)
+* v0.2.0 (01/05/2006)
+**Small adapations for del.icio.us feed
+* v0.1.1 (28/04/2006)
+**Bug : Channel without title 
+* v0.1.0 (24/04/2006)
+** initial release
+
+
+

+

+

+
Dependencies and Style

+

+

+
Compatibility

+

+

+
Lumiera expects a 'standard' desktop installation running a Xserver.
+

+

+

+
/***
+
+''Inspired by [[TiddlyPom|http://www.warwick.ac.uk/~tuspam/tiddlypom.html]]''
+
+|Name|SplashScreenPlugin|
+|Created by|SaqImtiaz|
+|Location|http://tw.lewcid.org/#SplashScreenPlugin|
+|Version|0.21 |
+|Requires|~TW2.08+|
+!Description:
+Provides a simple splash screen that is visible while the TW is loading.
+
+!Installation
+Copy the source text of this tiddler to your TW in a new tiddler, tag it with systemConfig and save and reload. The SplashScreen will now be installed and will be visible the next time you reload your TW.
+
+!Customizing
+Once the SplashScreen has been installed and you have reloaded your TW, the splash screen html will be present in the MarkupPreHead tiddler. You can edit it and customize to your needs.
+
+!History
+* 20-07-06 : version 0.21, modified to hide contentWrapper while SplashScreen is displayed.
+* 26-06-06 : version 0.2, first release
+
+!Code
+***/
+//{{{
+var old_lewcid_splash_restart=restart;
+
+restart = function()
+{   if (document.getElementById("SplashScreen"))
+        document.getElementById("SplashScreen").style.display = "none";
+      if (document.getElementById("contentWrapper"))
+        document.getElementById("contentWrapper").style.display = "block";
+    
+    old_lewcid_splash_restart();
+   
+    if (splashScreenInstall)
+       {if(config.options.chkAutoSave)
+			{saveChanges();}
+        displayMessage("TW SplashScreen has been installed, please save and refresh your TW.");
+        }
+}
+
+
+var oldText = store.getTiddlerText("MarkupPreHead");
+if (oldText.indexOf("SplashScreen")==-1)
+   {var siteTitle = store.getTiddlerText("SiteTitle");
+   var splasher='\n\n<style type="text/css">#contentWrapper {display:none;}</style><div id="SplashScreen" style="border: 3px solid #ccc; display: block; text-align: center; width: 320px; margin: 100px auto; padding: 50px; color:#000; font-size: 28px; font-family:Tahoma; background-color:#eee;"><b>'+siteTitle +'</b> is loading<blink> ...</blink><br><br><span style="font-size: 14px; color:red;">Requires Javascript.</span></div>';
+   if (! store.tiddlerExists("MarkupPreHead"))
+       {var myTiddler = store.createTiddler("MarkupPreHead");}
+   else
+      {var myTiddler = store.getTiddler("MarkupPreHead");}
+      myTiddler.set(myTiddler.title,oldText+splasher,config.options.txtUserName,null,null);
+      store.setDirty(true);
+      var splashScreenInstall = true;
+}
+//}}}

+

+

+
! Source code formatting
+http://www.gnu.org/prep/standards/html_node/Formatting.html#Formatting
+
+! Contibuting
+
+! Tests
+

+

+

+
/*{{{*/
+/* a contrasting background so I can see where one tiddler ends and the other begins */
+body {
+	background: [[ColorPalette::TertiaryLight]];
+}
+
+/* sexy colours and font for the header */
+.headerForeground {
+	color: [[ColorPalette::PrimaryPale]];
+}
+.headerShadow, .headerShadow a {
+	color: [[ColorPalette::PrimaryMid]];
+}
+.headerForeground, .headerShadow {
+	padding: 1em 1em 0;
+	font-family: 'Trebuchet MS' sans-serif;
+	font-weight:bold;
+}
+.headerForeground .siteSubtitle {
+	color: [[ColorPalette::PrimaryLight]];
+}
+.headerShadow .siteSubtitle {
+	color: [[ColorPalette::PrimaryMid]];
+}
+
+/* make shadow go and down right instead of up and left */
+.headerShadow {
+	left: 2px;
+	top: 3px;
+}
+
+/* prefer monospace for editing */
+.editor textarea {
+	font-family: 'Consolas' monospace;
+}
+
+/* sexy tiddler titles */
+.title {
+	font-size: 250%;
+	color: [[ColorPalette::PrimaryLight]];
+	font-family: 'Trebuchet MS' sans-serif;
+}
+
+/* more subtle tiddler subtitle */
+.subtitle {
+	padding:0px;
+	margin:0px;
+	padding-left:0.5em;
+	font-size: 90%;
+	color: [[ColorPalette::TertiaryMid]];
+}
+.subtitle .tiddlyLink {
+	color: [[ColorPalette::TertiaryMid]];
+}
+
+/* a little bit of extra whitespace */
+.viewer {
+	padding-bottom:3px;
+}
+
+/* don't want any background color for headings */
+h1,h2,h3,h4,h5,h6 {
+	background: [[ColorPalette::Background]];
+	color: [[ColorPalette::Foreground]];
+}
+
+/* give tiddlers 3d style border and explicit background */
+.tiddler {
+	background: [[ColorPalette::Background]];
+	border-right: 2px [[ColorPalette::TertiaryMid]] solid;
+	border-bottom: 2px [[ColorPalette::TertiaryMid]] solid;
+	margin-bottom: 1em;
+	padding-bottom: 2em;
+}
+
+/* make options slider look nicer */
+#sidebarOptions .sliderPanel {
+	border:solid 1px [[ColorPalette::PrimaryLight]];
+}
+
+
+/* the borders look wrong with the body background */
+#sidebar .button {
+	border-style: none;
+}
+
+/* displays the list of a tiddler's tags horizontally. used in ViewTemplate */
+.tagglyTagged li.listTitle {
+	display:none
+}
+.tagglyTagged li {
+	display: inline; font-size:90%;
+}
+.tagglyTagged ul {
+	margin:0px; padding:0px;
+}
+
+/* this means you can put line breaks in SidebarOptions for readability */
+#sidebarOptions br {
+	display:none;
+}
+/* undo the above in OptionsPanel */
+#sidebarOptions .sliderPanel br {
+	display:inline;
+}
+
+/* horizontal main menu stuff */
+#displayArea {
+	margin: 1em 15.7em 0em 1em; /* use the freed up space */
+}
+#topMenu br {
+	display: none;
+}
+#topMenu {
+	background: [[ColorPalette::PrimaryMid]];
+	color:[[ColorPalette::PrimaryPale]];
+}
+#topMenu {
+	padding:2px;
+}
+#topMenu .button, #topMenu .tiddlyLink, #topMenu a {
+	margin-left: 0.5em;
+	margin-right: 0.5em;
+	padding-left: 3px;
+	padding-right: 3px;
+	color: [[ColorPalette::PrimaryPale]];
+	font-size: 115%;
+}
+#topMenu .button:hover, #topMenu .tiddlyLink:hover {
+	background: [[ColorPalette::PrimaryDark]];
+}
+
+/* make it print a little cleaner */
+@media print {
+	#topMenu {
+		display: none ! important;
+	}
+	/* not sure if we need all the importants */
+	.tiddler {
+		border-style: none ! important;
+		margin:0px ! important;
+		padding:0px ! important;
+		padding-bottom:2em ! important;
+	}
+	.tagglyTagging .button, .tagglyTagging .hidebutton {
+		display: none ! important;
+	}
+	.headerShadow {
+		visibility: hidden ! important;
+	}
+	.tagglyTagged .quickopentag, .tagged .quickopentag {
+		border-style: none ! important;
+	}
+	.quickopentag a.button, .miniTag {
+		display: none ! important;
+	}
+}
+/*}}}*/
+

+

+

+
<<timeline better:true maxDays:14 maxEntries:20>>

+

+

+
/***
+|Name|TaskMacroPlugin|
+|Author|<<extension TaskMacroPlugin author>>|
+|Location|<<extension TaskMacroPlugin source>>|
+|License|<<extension TaskMacroPlugin license>>|
+|Version|<<extension TaskMacroPlugin versionAndDate>>|
+!Description
+A set of macros to help you keep track of time estimates for tasks.
+
+Macros defined:
+* {{{task}}}: Displays a task description and makes it easy to estimate and track the time spent on the task.
+* {{{taskadder}}}: Displays text entry field to simplify the adding of tasks.
+* {{{tasksum}}}: Displays a summary of tasks sandwiched between two calls to this macro.
+* {{{extension}}}: A simple little macro that displays information about a TiddlyWiki plugin, and that will hopefully someday migrate to the TW core in some form.
+Core overrides:
+* {{{wikify}}}: when wikifying a tiddler's complete text, adds refresh information so the tiddler will be refreshed when it changes
+* {{{config.refreshers}}}: have the built-in refreshers return true; also, add a new refresher ("fullContent") that redisplays a full tiddler whenever it or any nested tiddlers it shows are changed
+* {{{refreshElements}}}: now checks the return value from the refresher and only short-circuits the recursion if the refresher returns true
+!Plugin Information
+***/
+//{{{
+version.extensions.TaskMacroPlugin = {
+	major: 1, minor: 1, revision: 0,
+	date: new Date(2006,5-1,13),
+	author: "LukeBlanshard",
+	source: "http://labwiki.sourceforge.net/#TaskMacroPlugin",
+	license: "http://labwiki.sourceforge.net/#CopyrightAndLicense"
+}
+//}}}
+/***
+A little macro for pulling out extension info.  Use like {{{<<extension PluginName datum>>}}}, where {{{PluginName}}} is the name you used for {{{version.extensions}}} and {{{datum}}} is either {{{versionAndDate}}} or a property of the extension description object, such as {{{source}}}.
+***/
+//{{{
+config.macros.extension = {
+	handler: function( place, macroName, params, wikifier, paramString, tiddler ) {
+		var info  = version.extensions[params[0]]
+		var datum = params[1]
+		switch (params[1]) {
+		case 'versionAndDate':
+			createTiddlyElement( place, "span", null, null,
+				info.major+'.'+info.minor+'.'+info.revision+', '+info.date.formatString('DD MMM YYYY') )
+			break;
+		default:
+			wikify( info[datum], place )
+			break;
+		}
+	}
+}
+//}}}
+/***
+!Core Overrides
+***/
+//{{{
+window.wikify_orig_TaskMacroPlugin = window.wikify
+window.wikify = function(source,output,highlightRegExp,tiddler)
+{
+	if ( tiddler && tiddler.text === source )
+		addDisplayDependency( output, tiddler.title )
+	wikify_orig_TaskMacroPlugin.apply( this, arguments )
+}
+config.refreshers_orig_TaskMacroPlugin = config.refreshers
+config.refreshers = {
+	link: function() {
+		config.refreshers_orig_TaskMacroPlugin.link.apply( this, arguments )
+		return true
+	},
+	content: function() {
+		config.refreshers_orig_TaskMacroPlugin.content.apply( this, arguments )
+		return true
+	},
+	fullContent: function( e, changeList ) {
+		var tiddlers = e.refreshTiddlers
+		if ( changeList == null || tiddlers == null )
+			return false
+		for ( var i=0; i < tiddlers.length; ++i )
+			if ( changeList.find(tiddlers[i]) != null ) {
+				var title = tiddlers[0]
+				story.refreshTiddler( title, null, true )
+				return true
+			}
+		return false
+	}
+}
+function refreshElements(root,changeList)
+{
+	var nodes = root.childNodes;
+	for(var c=0; c<nodes.length; c++)
+		{
+		var e = nodes[c],type;
+		if(e.getAttribute)
+			type = e.getAttribute("refresh");
+		else
+			type = null;
+		var refresher = config.refreshers[type];
+		if ( ! refresher || ! refresher(e, changeList) )
+			{
+			if(e.hasChildNodes())
+				refreshElements(e,changeList);
+			}
+		}
+}
+//}}}
+/***
+!Global Functions
+***/
+//{{{
+// Add the tiddler whose title is given to the list of tiddlers whose
+// changing will cause a refresh of the tiddler containing the given element.
+function addDisplayDependency( element, title ) {
+	while ( element && element.getAttribute ) {
+		var idAttr = element.getAttribute("id"), tiddlerAttr = element.getAttribute("tiddler")
+		if ( idAttr && tiddlerAttr && idAttr == story.idPrefix+tiddlerAttr ) {
+			var list = element.refreshTiddlers
+			if ( list == null ) {
+				list = [tiddlerAttr]
+				element.refreshTiddlers = list
+				element.setAttribute( "refresh", "fullContent" )
+			}
+			list.pushUnique( title )
+			return
+		}
+		element = element.parentNode
+	}
+}
+
+// Lifted from Story.prototype.focusTiddler: just return the field instead of focusing it.
+Story.prototype.findEditField = function( title, field )
+{
+	var tiddler = document.getElementById(this.idPrefix + title);
+	if(tiddler != null)
+		{
+		var children = tiddler.getElementsByTagName("*")
+		var e = null;
+		for (var t=0; t<children.length; t++)
+			{
+			var c = children[t];
+			if(c.tagName.toLowerCase() == "input" || c.tagName.toLowerCase() == "textarea")
+				{
+				if(!e)
+					e = c;
+				if(c.getAttribute("edit") == field)
+					e = c;
+				}
+			}
+		return e
+		}
+}
+
+// Wraps the given event function in another function that handles the
+// event in a standard way.
+function wrapEventHandler( otherHandler ) {
+	return function(e) {
+		if (!e) var e = window.event
+		e.cancelBubble = true
+		if (e.stopPropagation) e.stopPropagation()
+		return otherHandler( e )
+	}
+}
+//}}}
+/***
+!Task Macro
+Usage:
+> {{{<<task orig cur spent>>description}}}
+All of orig, cur, and spent are optional numbers of hours.  The description goes through the end of the line, and is wikified.
+***/
+//{{{
+config.macros.task = {
+	NASCENT:	0, // Task not yet estimated
+	LIVE:		1, // Estimated but with time remaining
+	DONE:		2, // Completed: no time remaining
+	bullets:	["\u25cb", // nascent (open circle)
+			 "\u25ba", // live (right arrow)
+			 "\u25a0"],// done (black square)
+	styles:		["nascent", "live", "done"],
+
+	// Translatable text:
+	lingo: {
+		spentTooBig:	"Spent time %0 can't exceed current estimate %1",
+		noNegative:	"Times may not be negative numbers",
+		statusTips:	["Not yet estimated", "To do", "Done"], // Array indexed by state (NASCENT/LIVE/DONE)
+		descClickTip:	" -- Double-click to edit task description",
+		statusClickTip:	" -- Double-click to mark task complete",
+		statusDoneTip:	" -- Double-click to adjust the time spent, to revive the task",
+		origTip:	"Original estimate in hours",
+		curTip:		"Current estimate in hours",
+		curTip2:	"Estimate in hours", // For when orig == cur
+		clickTip:	" -- Click to adjust",
+		spentTip:	"Hours spent on this task",
+		remTip:		"Hours remaining",
+		curPrompt:	"Estimate this task in hours, or adjust the current estimate by starting with + or -.\n\nYou may optionally also set or adjust the time spent by putting a second number after the first.",
+		spentPrompt:	"Enter the number of hours you've spent on this task, or adjust the current number by starting with + or -.\n\nYou may optionally also set or adjust the time remaining by putting a second number after the first.",
+		remPrompt:	"Enter the number of hours it will take to finish this task, or adjust the current estimate by starting with + or -.\n\nYou may optionally also set or adjust the time spent by putting a second number after the first.",
+		numbersOnly:	"Enter numbers only, please",
+		notCurrent:	"The tiddler has been modified since it was displayed, please redisplay it before doing this."
+	},
+
+	// The macro handler
+	handler: function( place, macroName, params, wikifier, paramString, tiddler )
+	{
+		var start = wikifier.matchStart, end = wikifier.nextMatch
+
+		var origStr	= params.length > 0? params.shift() : "?"
+		var orig	= +origStr // as a number
+		var cur		= params.length > 1? +params.shift() : orig
+		var spent	= params.length > 0? +params.shift() : 0
+		if ( spent > cur )
+			throw Error( this.lingo.spentTooBig.format([spent, cur]) )
+		if ( orig < 0 || cur < 0 || spent < 0 )
+			throw Error( this.lingo.noNegative )
+		var rem		= cur - spent
+		var state	= isNaN(orig+rem)? this.NASCENT : rem > 0? this.LIVE : this.DONE
+		var table	= createTiddlyElement( place, "table", null, "task "+this.styles[state] )
+		var tbody	= createTiddlyElement( table, "tbody" )
+		var row		= createTiddlyElement( tbody, "tr" )
+		var statusCell	= createTiddlyElement( row,   "td", null, "status", this.bullets[state] )
+		var descCell	= createTiddlyElement( row,   "td", null, "description" )
+
+		var origCell	= state==this.NASCENT || orig==cur? null
+				: createTiddlyElement( row, "td", null, "numeric original" )
+		var curCell	= createTiddlyElement( row, "td", null, "numeric current" )
+		var spentCell	= createTiddlyElement( row, "td", null, "numeric spent" )
+		var remCell	= createTiddlyElement( row, "td", null, "numeric remaining" )
+
+		var sums = config.macros.tasksum.tasksums
+		if ( sums && sums.length ) {
+			var summary = [(state == this.NASCENT? NaN : orig), cur, spent]
+			summary.owner = tiddler
+			sums[0].push( summary )
+		}
+
+		// The description goes to the end of the line
+		wikifier.subWikify( descCell, "$\\n?" )
+		var descEnd = wikifier.nextMatch
+
+		statusCell.setAttribute( "title", this.lingo.statusTips[state] )
+		descCell.setAttribute(   "title", this.lingo.statusTips[state]+this.lingo.descClickTip )
+		if (origCell) {
+			createTiddlyElement( origCell, "div", null, null, orig )
+			origCell.setAttribute( "title", this.lingo.origTip )
+			curCell.setAttribute( "title", this.lingo.curTip )
+		}
+		else {
+			curCell.setAttribute( "title", this.lingo.curTip2 )
+		}
+		var curDivContents = (state==this.NASCENT)? "?" : cur
+		var curDiv = createTiddlyElement( curCell, "div", null, null, curDivContents )
+		spentCell.setAttribute( "title", this.lingo.spentTip )
+		var spentDiv = createTiddlyElement( spentCell, "div", null, null, spent )
+		remCell.setAttribute( "title", this.lingo.remTip )
+		var remDiv = createTiddlyElement( remCell, "div", null, null, rem )
+
+		// Handle double-click on the description by going
+		// into edit mode and selecting the description
+		descCell.ondblclick = this.editDescription( tiddler, end, descEnd )
+
+		function appTitle( el, suffix ) {
+			el.setAttribute( "title", el.getAttribute("title")+suffix )
+		}
+
+		// For incomplete tasks, handle double-click on the bullet by marking the task complete
+		if ( state != this.DONE ) {
+			appTitle( statusCell, this.lingo.statusClickTip )
+			statusCell.ondblclick = this.markTaskComplete( tiddler, start, end, macroName, orig, cur, state )
+		}
+		// For complete ones, handle double-click on the bullet by letting you adjust the time spent
+		else {
+			appTitle( statusCell, this.lingo.statusDoneTip )
+			statusCell.ondblclick = this.adjustTimeSpent( tiddler, start, end, macroName, orig, cur, spent )
+		}
+
+		// Add click handlers for the numeric cells.
+		if ( state != this.DONE ) {
+			appTitle( curCell, this.lingo.clickTip )
+			curDiv.className = "adjustable"
+			curDiv.onclick = this.adjustCurrentEstimate( tiddler, start, end, macroName,
+				orig, cur, spent, curDivContents )
+		}
+		appTitle( spentCell, this.lingo.clickTip )
+		spentDiv.className = "adjustable"
+		spentDiv.onclick = this.adjustTimeSpent( tiddler, start, end, macroName, orig, cur, spent )
+		if ( state == this.LIVE ) {
+			appTitle( remCell, this.lingo.clickTip )
+			remDiv.className = "adjustable"
+			remDiv.onclick = this.adjustTimeRemaining( tiddler, start, end, macroName, orig, cur, spent )
+		}
+	},
+
+	// Puts the tiddler into edit mode, and selects the range of characters
+	// defined by start and end.  Separated for leak prevention in IE.
+	editDescription: function( tiddler, start, end ) {
+		return wrapEventHandler( function(e) {
+			story.displayTiddler( null, tiddler.title, DEFAULT_EDIT_TEMPLATE )
+			var tiddlerElement = document.getElementById( story.idPrefix + tiddler.title )
+			window.scrollTo( 0, ensureVisible(tiddlerElement) )
+			var element = story.findEditField( tiddler.title, "text" )
+			if ( element && element.tagName.toLowerCase() == "textarea" ) {
+				// Back up one char if the last char's a newline
+				if ( tiddler.text[end-1] == '\n' )
+					--end
+				element.focus()
+				if ( element.setSelectionRange != undefined ) { // Mozilla
+					element.setSelectionRange( start, end )
+					// Damn mozilla doesn't scroll to visible.  Approximate.
+					var max = 0.0 + element.scrollHeight
+					var len = element.textLength
+					var top = max*start/len, bot = max*end/len
+					element.scrollTop = Math.min( top, (bot+top-element.clientHeight)/2 )
+				}
+				else if ( element.createTextRange != undefined ) { // IE
+					var range = element.createTextRange()
+					range.collapse()
+					range.moveEnd("character", end)
+					range.moveStart("character", start)
+					range.select()
+				}
+				else // Other? Too bad, just select the whole thing.
+					element.select()
+				return false
+			}
+			else
+				return true
+		} )
+	},
+
+	// Modifies a task macro call such that the task appears complete.
+	markTaskComplete: function( tiddler, start, end, macroName, orig, cur, state ) {
+		var macro = this, text = tiddler.text
+		return wrapEventHandler( function(e) {
+			if ( text !== tiddler.text ) {
+				alert( macro.lingo.notCurrent )
+				return false
+			}
+			if ( state == macro.NASCENT )
+				orig = cur = 0
+			// The second "cur" in the call below bumps up the time spent
+			// to match the current estimate.
+			macro.replaceMacroCall( tiddler, start, end, macroName, orig, cur, cur )
+			return false
+		} )
+	},
+
+	// Asks the user for an adjustment to the current estimate, modifies the macro call accordingly.
+	adjustCurrentEstimate: function( tiddler, start, end, macroName, orig, cur, spent, curDivContents ) {
+		var macro = this, text = tiddler.text
+		return wrapEventHandler( function(e) {
+			if ( text !== tiddler.text ) {
+				alert( macro.lingo.notCurrent )
+				return false
+			}
+			var txt = prompt( macro.lingo.curPrompt, curDivContents )
+			if ( txt != null ) {
+				var a = macro.breakInput( txt )
+				cur = macro.offset( cur, a[0] )
+				if ( a.length > 1 )
+					spent = macro.offset( spent, a[1] )
+				macro.replaceMacroCall( tiddler, start, end, macroName, orig, cur, spent )
+			}
+			return false
+		} )
+	},
+
+	// Asks the user for an adjustment to the time spent, modifies the macro call accordingly.
+	adjustTimeSpent: function( tiddler, start, end, macroName, orig, cur, spent ) {
+		var macro = this, text = tiddler.text
+		return wrapEventHandler( function(e) {
+			if ( text !== tiddler.text ) {
+				alert( macro.lingo.notCurrent )
+				return false
+			}
+			var txt = prompt( macro.lingo.spentPrompt, spent )
+			if ( txt != null ) {
+				var a = macro.breakInput( txt )
+				spent = macro.offset( spent, a[0] )
+				var rem = cur - spent
+				if ( a.length > 1 ) {
+					rem = macro.offset( rem, a[1] )
+					cur = spent + rem
+				}
+				macro.replaceMacroCall( tiddler, start, end, macroName, orig, cur, spent )
+			}
+			return false
+		} )
+	},
+
+	// Asks the user for an adjustment to the time remaining, modifies the macro call accordingly.
+	adjustTimeRemaining: function( tiddler, start, end, macroName, orig, cur, spent ) {
+		var macro = this
+		var text  = tiddler.text
+		var rem   = cur - spent
+		return wrapEventHandler( function(e) {
+			if ( text !== tiddler.text ) {
+				alert( macro.lingo.notCurrent )
+				return false
+			}
+			var txt = prompt( macro.lingo.remPrompt, rem )
+			if ( txt != null ) {
+				var a = macro.breakInput( txt )
+				var newRem = macro.offset( rem, a[0] )
+				if ( newRem > rem || a.length > 1 )
+					cur += (newRem - rem)
+				else
+					spent += (rem - newRem)
+				if ( a.length > 1 )
+					spent = macro.offset( spent, a[1] )
+				macro.replaceMacroCall( tiddler, start, end, macroName, orig, cur, spent )
+			}
+			return false
+		} )
+	},
+
+	// Breaks input at spaces & commas, returns array
+	breakInput: function( txt ) {
+		var a = txt.trim().split( /[\s,]+/ )
+		if ( a.length == 0 )
+			a = [NaN]
+		return a
+	},
+
+	// Adds to, subtracts from, or replaces a numeric value
+	offset: function( num, txt ) {
+		if ( txt == "" || typeof(txt) != "string" )
+			return NaN
+		if ( txt.match(/^[+-]/) )
+			return num + (+txt)
+		return +txt
+	},
+
+	// Does some error checking, then replaces the indicated macro
+	// call within the text of the given tiddler.
+	replaceMacroCall: function( tiddler, start, end, macroName, orig, cur, spent )
+	{
+		if ( isNaN(cur+spent) ) {
+			alert( this.lingo.numbersOnly )
+			return
+		}
+		if ( spent < 0 || cur < 0 ) {
+			alert( this.lingo.noNegative )
+			return
+		}
+		if ( isNaN(orig) )
+			orig = cur
+		if ( spent > cur )
+			cur = spent
+		var text = tiddler.text.substring(0,start) + "<<" + macroName + " " +
+			orig + " " + cur + " " + spent + ">>" + tiddler.text.substring(end)
+		var title = tiddler.title
+		store.saveTiddler( title, title, text, config.options.txtUserName, new Date(), undefined )
+		//story.refreshTiddler( title, null, true )
+		if ( config.options.chkAutoSave )
+			saveChanges()
+	}
+}
+//}}}
+/***
+!Tasksum Macro
+Usage:
+> {{{<<tasksum "start" ["here" [intro]]>>}}}
+or:
+> {{{<<tasksum "end" [intro]>>}}}
+Put one of the {{{<<tasksum start>>}}} lines before the tasks you want to summarize, and an {{{end}}} line after them.  By default, the summary goes at the end; if you include {{{here}}} in the start line, the summary will go at the top.  The intro argument, if supplied, replaces the default text introducing the summary.
+***/
+//{{{
+config.macros.tasksum = {
+
+	// Translatable text:
+	lingo: {
+		unrecVerb:	"<<%0>> requires 'start' or 'end' as its first argument",
+		mustMatch:	"<<%0 end>> must match a preceding <<%0 start>>",
+		defIntro:	"Task summary:",
+		nascentSum:	"''%0 not estimated''",
+		doneSum:	"%0 complete (in %1 hours)",
+		liveSum:	"%0 ongoing (%1 hours so far, ''%2 hours remaining'')",
+		overSum:	"Total overestimate: %0%.",
+		underSum:	"Total underestimate: %0%.",
+		descPattern:	"%0 %1. %2",
+                origTip:	"Total original estimates in hours",
+		curTip:		"Total current estimates in hours",
+		spentTip:	"Total hours spent on tasks",
+		remTip:		"Total hours remaining"
+	},
+
+	// The macro handler
+	handler: function( place, macroName, params, wikifier, paramString, tiddler )
+	{
+		var sums = this.tasksums
+		if ( params[0] == "start" ) {
+			sums.unshift([])
+			if ( params[1] == "here" ) {
+				sums[0].intro = params[2] || this.lingo.defIntro
+				sums[0].place = place
+				sums[0].placement = place.childNodes.length
+			}
+		}
+		else if ( params[0] == "end" ) {
+			if ( ! sums.length )
+				throw Error( this.lingo.mustMatch.format([macroName]) )
+			var list = sums.shift()
+			var intro = list.intro || params[1] || this.lingo.defIntro
+			var nNascent=0, nLive=0, nDone=0, nMine=0
+			var totLiveSpent=0, totDoneSpent=0
+			var totOrig=0, totCur=0, totSpent=0
+			for ( var i=0; i < list.length; ++i ) {
+				var a = list[i]
+				if ( a.length > 3 ) {
+					nNascent 	+= a[0]
+					nLive 		+= a[1]
+					nDone 		+= a[2]
+					totLiveSpent 	+= a[3]
+					totDoneSpent 	+= a[4]
+					totOrig 	+= a[5]
+					totCur 		+= a[6]
+					totSpent 	+= a[7]
+					if ( a.owner == tiddler )
+						nMine	+= a[8]
+				}
+				else {
+					if ( a.owner == tiddler )
+						++nMine
+					if ( isNaN(a[0]) ) {
+						++nNascent
+					}
+					else {
+						if ( a[1] > a[2] ) {
+							++nLive
+							totLiveSpent += a[2]
+						}
+						else {
+							++nDone
+							totDoneSpent += a[2]
+						}
+						totOrig  += a[0]
+						totCur   += a[1]
+						totSpent += a[2]
+					}
+				}
+			}
+
+			// If we're nested, push a summary outward
+                        if ( sums.length ) {
+				var summary = [nNascent, nLive, nDone, totLiveSpent, totDoneSpent,
+						totOrig, totCur, totSpent, nMine]
+				summary.owner = tiddler
+				sums[0].push( summary )
+			}
+
+			var descs = [], styles = []
+			if ( nNascent > 0 ) {
+				descs.push( this.lingo.nascentSum.format([nNascent]) )
+				styles.push( "nascent" )
+			}
+			if ( nDone > 0 )
+				descs.push( this.lingo.doneSum.format([nDone, totDoneSpent]) )
+			if ( nLive > 0 ) {
+				descs.push( this.lingo.liveSum.format([nLive, totLiveSpent, totCur-totSpent]) )
+				styles.push( "live" )
+			}
+			else
+				styles.push( "done" )
+			var off = ""
+			if ( totOrig > totCur )
+				off = this.lingo.overSum.format( [Math.round(100.0*(totOrig-totCur)/totCur)] )
+			else if ( totCur > totOrig )
+				off = this.lingo.underSum.format( [Math.round(100.0*(totCur-totOrig)/totOrig)] )
+
+			var top		= (list.intro != undefined)
+			var table	= createTiddlyElement( null, "table", null, "tasksum "+(top?"top":"bottom") )
+			var tbody	= createTiddlyElement( table, "tbody" )
+			var row		= createTiddlyElement( tbody, "tr", null, styles.join(" ") )
+			var descCell	= createTiddlyElement( row,   "td", null, "description" )
+
+			var description = this.lingo.descPattern.format( [intro, descs.join(", "), off] )
+			wikify( description, descCell, null, tiddler )
+
+			var origCell	= totOrig == totCur? null
+					: createTiddlyElement( row, "td", null, "numeric original", totOrig )
+			var curCell	= createTiddlyElement( row, "td", null, "numeric current", totCur )
+			var spentCell	= createTiddlyElement( row, "td", null, "numeric spent", totSpent )
+			var remCell	= createTiddlyElement( row, "td", null, "numeric remaining", totCur-totSpent )
+
+			if ( origCell )
+				origCell.setAttribute( "title", this.lingo.origTip )
+			curCell  .setAttribute( "title", this.lingo.curTip )
+			spentCell.setAttribute( "title", this.lingo.spentTip )
+			remCell  .setAttribute( "title", this.lingo.remTip )
+
+			// Discard the table if there are no tasks
+			if ( list.length > 0 ) {
+				var place = top? list.place : place
+				var placement = top? list.placement : place.childNodes.length
+				if ( placement >= place.childNodes.length )
+					place.appendChild( table )
+				else
+					place.insertBefore( table, place.childNodes[placement] )
+			}
+		}
+		else
+			throw Error( this.lingo.unrecVerb.format([macroName]) )
+
+		// If we're wikifying, and are followed by end-of-line, swallow the newline.
+		if ( wikifier && wikifier.source.charAt(wikifier.nextMatch) == "\n" )
+			++wikifier.nextMatch
+	},
+
+	// This is the stack of pending summaries
+	tasksums: []
+}
+//}}}
+/***
+!Taskadder Macro
+Usage:
+> {{{<<taskadder ["above"|"below"|"focus"|"nofocus"]...>>}}}
+Creates a line with text entry fields for a description and an estimate.  By default, puts focus in the description field and adds tasks above the entry fields.  Use {{{nofocus}}} to not put focus in the description field.  Use {{{below}}} to add tasks below the entry fields.
+***/
+//{{{
+config.macros.taskadder = {
+
+	// Translatable text:
+	lingo: {
+		unrecParam:	"<<%0>> doesn't recognize '%1' as a parameter",
+		descTip:	"Describe a new task",
+		curTip:		"Estimate how long in hours the task will take",
+		buttonText:	"add task",
+		buttonTip:	"Add a new task with the description and estimate as entered",
+		notCurrent:	"The tiddler has been modified since it was displayed, please redisplay it before adding a task this way.",
+
+		eol:		"eol"
+	},
+
+	// The macro handler
+	handler: function( place, macroName, params, wikifier, paramString, tiddler )
+	{
+		var above = true
+		var focus = false
+
+		while ( params.length > 0 ) {
+			var p = params.shift()
+			switch (p) {
+			case "above": 	above = true;  break
+			case "below": 	above = false; break
+			case "focus": 	focus = true;  break
+			case "nofocus":	focus = false; break
+			default:	throw Error( this.lingo.unrecParam.format([macroName, p]) )
+			}
+		}
+
+		// If we're followed by end-of-line, swallow the newline.
+		if ( wikifier.source.charAt(wikifier.nextMatch) == "\n" )
+			++wikifier.nextMatch
+
+		var where	= above? wikifier.matchStart : wikifier.nextMatch
+
+		var table	= createTiddlyElement( place, "table", null, "task" )
+		var tbody	= createTiddlyElement( table, "tbody" )
+		var row		= createTiddlyElement( tbody, "tr" )
+		var statusCell	= createTiddlyElement( row,   "td", null, "status" )
+		var descCell	= createTiddlyElement( row,   "td", null, "description" )
+		var curCell	= createTiddlyElement( row,   "td", null, "numeric" )
+		var addCell	= createTiddlyElement( row,   "td", null, "addtask" )
+
+		var descId	= this.generateId()
+		var curId	= this.generateId()
+		var descInput	= createTiddlyElement( descCell, "input", descId )
+		var curInput	= createTiddlyElement( curCell,  "input", curId  )
+
+		descInput.setAttribute( "type", "text" )
+		curInput .setAttribute( "type", "text" )
+		descInput.setAttribute( "size", "40")
+		curInput .setAttribute( "size", "6" )
+		descInput.setAttribute( "autocomplete", "off" );
+		curInput .setAttribute( "autocomplete", "off" );
+		descInput.setAttribute( "title", this.lingo.descTip );
+		curInput .setAttribute( "title", this.lingo.curTip  );
+
+		var addAction	= this.addTask( tiddler, where, descId, curId, above )
+		var addButton	= createTiddlyButton( addCell, this.lingo.buttonText, this.lingo.buttonTip, addAction )
+
+		descInput.onkeypress = this.handleEnter(addAction)
+		curInput .onkeypress = descInput.onkeypress
+		addButton.onkeypress = this.handleSpace(addAction)
+		if ( focus || tiddler.taskadderLocation == where ) {
+			descInput.focus()
+			descInput.select()
+		}
+	},
+
+	// Returns a function that inserts a new task macro into the tiddler.
+	addTask: function( tiddler, where, descId, curId, above ) {
+		var macro = this, oldText = tiddler.text
+		return wrapEventHandler( function(e) {
+			if ( oldText !== tiddler.text ) {
+				alert( macro.lingo.notCurrent )
+				return false
+			}
+			var desc	= document.getElementById(descId).value
+			var cur		= document.getElementById(curId) .value
+			var init	= tiddler.text.substring(0,where) + "<<task " + cur + ">> " + desc + "\n"
+			var text	= init + tiddler.text.substring(where)
+			var title	= tiddler.title
+			tiddler.taskadderLocation = (above? init.length : where)
+			try {
+				store.saveTiddler( title, title, text, config.options.txtUserName, new Date(), undefined )
+				//story.refreshTiddler( title, null, true )
+			}
+			finally {
+				delete tiddler.taskadderLocation
+			}
+			if ( config.options.chkAutoSave )
+				saveChanges()
+		} )
+	},
+
+	// Returns an event handler that delegates to two other functions: "matches" to decide
+	// whether to consume the event, and "addTask" to actually perform the work.
+	handleGeneric: function( addTask, matches ) {
+		return function(e) {
+			if (!e) var e = window.event
+			var consume = false
+			if ( matches(e) ) {
+				consume = true
+				addTask( e )
+			}
+			e.cancelBubble = consume;
+			if ( consume && e.stopPropagation ) e.stopPropagation();
+			return !consume;
+		}
+	},
+
+	// Returns an event handler that handles enter keys by calling another event handler
+	handleEnter: function( addTask ) {
+		return this.handleGeneric( addTask, function(e){return e.keyCode == 13 || e.keyCode == 10} ) // Different codes for Enter
+	},
+
+	// Returns an event handler that handles the space key by calling another event handler
+	handleSpace: function( addTask ) {
+		return this.handleGeneric( addTask, function(e){return (e.charCode||e.keyCode) == 32} )
+	},
+
+	counter: 0,
+	generateId: function() {
+		return "taskadder:" + String(this.counter++)
+	}
+}
+//}}}
+/***
+!Stylesheet
+***/
+//{{{
+var stylesheet = '\
+.viewer table.task, table.tasksum {\
+	width: 100%;\
+	padding: 0;\
+	border-collapse: collapse;\
+}\
+.viewer table.task {\
+	border: none;\
+	margin: 0;\
+}\
+table.tasksum, .viewer table.tasksum {\
+	border: solid 2px #999;\
+	margin: 3px 0;\
+}\
+table.tasksum td {\
+	text-align: center;\
+	border: 1px solid #ddd;\
+	background-color: #ffc;\
+	vertical-align: middle;\
+	margin: 0;\
+	padding: 0;\
+}\
+.viewer table.task tr {\
+	border: none;\
+}\
+.viewer table.task td {\
+	text-align: center;\
+	vertical-align: baseline;\
+	border: 1px solid #fff;\
+	background-color: inherit;\
+	margin: 0;\
+	padding: 0;\
+}\
+td.numeric {\
+	width: 3em;\
+}\
+table.task td.numeric div {\
+	border: 1px solid #ddd;\
+	background-color: #ffc;\
+	margin: 1px 0;\
+	padding: 0;\
+}\
+table.task td.original div {\
+	background-color: #fdd;\
+}\
+table.tasksum td.original {\
+	background-color: #fdd;\
+}\
+table.tasksum td.description {\
+	background-color: #e8e8e8;\
+}\
+table.task td.status {\
+	width: 1.5em;\
+	cursor: default;\
+}\
+table.task td.description, table.tasksum td.description {\
+	width: auto;\
+	text-align: left;\
+	padding: 0 3px;\
+}\
+table.task.done td.status,table.task.done td.description {\
+	color: #ccc;\
+}\
+table.task.done td.current, table.task.done td.remaining {\
+	visibility: hidden;\
+}\
+table.task.done td.spent div, table.tasksum tr.done td.current,\
+table.tasksum tr.done td.spent, table.tasksum tr.done td.remaining {\
+	background-color: #eee;\
+	color: #aaa;\
+}\
+table.task.nascent td.description {\
+	color: #844;\
+}\
+table.task.nascent td.current div, table.tasksum tr.nascent td.numeric.current {\
+	font-weight: bold;\
+	color: #c00;\
+	background-color: #def;\
+}\
+table.task.nascent td.spent, table.task.nascent td.remaining {\
+	visibility: hidden;\
+}\
+td.remaining {\
+	font-weight: bold;\
+}\
+.adjustable {\
+	cursor: pointer; \
+}\
+table.task input {\
+	display: block;\
+	width: 100%;\
+	font: inherit;\
+	margin: 2px 0;\
+	padding: 0;\
+	border: 1px inset #999;\
+}\
+table.task td.numeric input {\
+	background-color: #ffc;\
+	text-align: center;\
+}\
+table.task td.addtask {\
+	width: 6em;\
+	border-left: 2px solid white;\
+	vertical-align: middle;\
+}\
+'
+setStylesheet( stylesheet, "TaskMacroPluginStylesheet" )
+//}}}
+

+

+

+
!!Changes in 1.1.0
+* Made the macros work in nested tiddlers (ie when one tiddler includes another using {{{<<tiddler>>}}} or something similar):
+** Task summaries in the outer tiddler include the tasks from the inner one
+** Using the editing shortcuts on the tasks as displayed in the outer tiddler correctly changes the inner tiddler and also redisplays the outer one
+** Added sanity checks to the editing shortcuts so they will refuse to work if the tiddler has been modified behind their backs
+* Made some small usability fixes:
+** The "add task" button now responds to the Space key (hat tip: Daniel Baird)
+** Double-clicking on a completed task's bullet now does the same thing as clicking on the elapsed time: it lets you adjust the time spent, giving you the option of resurrecting the task (hat tip: ~JackF)
+** Reworked the focus handling of the taskadder macro so it works more intuitively, by refocusing on the same adder you just used
+

+

+

+
The task macro provided by the TaskMacroPlugin is for planning, estimating, and tracking detailed tasks such as those required for writing software.  It is inspired by [[Joel Spolsky|http://www.joelonsoftware.com/articles/fog0000000245.html]]'s method for scheduling software development, also popularized by [[Voo2do|http://voo2do.com]] and [[XPlanner|http://xplanner.org]].
+
+For changes since the previous version, see the TaskMacroReleaseNotes.
+
+This tutorial leads you through the use of the task macro itself, and supporting macros that summarize lists of tasks and simplify the adding of tasks to a list.  Follow along by clicking the links below.  Or click the little down-arrow next to this tiddler's title, above, and choose "Open all" to have all the tutorial sections displayed at once.
+
+

+

+

+
<!---
+Includes portions of [[TagglyTaggingViewTemplate|http://simonbaird.com/mptw/#TagglyTaggingViewTemplate]], v1.2 (16-Jan-2006).
+Also adds a pair of tasksum macros around the tiddler, to summarize any contained tasks at the top.  Removes the "-" in front of closeTiddler, which can easily bite you if you have a focusable element in a tiddler, such as a taskadder entry field.
+Portions written by Luke Blanshard are hereby released into the public domain.
+--->
+<!--{{{-->
+<div class="toolbar" macro="toolbar closeTiddler closeOthers +editTiddler permalink references jump newHere"></div>
+<div class="tagglyTagged" macro="tags"></div>
+<div><span class="title" macro="view title"></span><span class="miniTag" macro="miniTag"></span></div>
+<div macro="tasksum start here"></div>
+<div class="viewer" macro="view text wikified"></div>
+<div macro="tasksum end"></div>
+<div class="tagglyTagging" macro="tagglyListWithSort"></div>
+<!--}}}-->
+

+

+

+
/***
+''TextAreaPlugin for TiddlyWiki version 2.0''
+^^author: Eric Shulman - ELS Design Studios
+source: http://www.elsdesign.com/tiddlywiki/#TextAreaPlugin
+license: [[Creative Commons Attribution-ShareAlike 2.5 License|http://creativecommons.org/licenses/by-sa/2.5/]]^^
+
+This plugin 'hijacks' the TW core function, ''Story.prototype.focusTiddler()'', so it can add special 'keyDown' handlers to adjust several behaviors associated with the textarea control used in the tiddler editor.  Specifically, it:
+* Adds text search INSIDE of edit fields.^^
+Use ~CTRL-F for "Find" (prompts for search text), and ~CTRL-G for "Find Next" (uses previous search text)^^
+* Enables TAB characters to be entered into field content^^
+(instead of moving to next field)^^
+* Option to set cursor at top of edit field instead of auto-selecting contents^^
+(see configuration section for checkbox)^^
+!!!!!Configuration
+<<<
+<<option chkDisableAutoSelect>> place cursor at start of textarea instead of pre-selecting content
+<<option chkTextAreaExtensions>> add control-f (find), control-g (find again) and allow TABs as input in textarea
+<<<
+!!!!!Installation
+<<<
+Import (or copy/paste) the following tiddlers into your document:
+''TextAreaPlugin'' (tagged with <<tag systemConfig>>)
+<<<
+!!!!!Revision History
+<<<
+''2006.01.22 [1.0.1]''
+only add extra key processing for TEXTAREA elements (not other edit fields).
+added option to enable/disable textarea keydown extensions (default is "standard keys" only)
+''2006.01.22 [1.0.0]''
+Moved from temporary "System Tweaks" tiddler into 'real' TextAreaPlugin tiddler.
+<<<
+!!!!!Code
+***/
+//{{{
+version.extensions.textAreaPlugin= {major: 1, minor: 0, revision: 1, date: new Date(2006,1,23)};
+//}}}
+
+//{{{
+if (!config.options.chkDisableAutoSelect) config.options.chkDisableAutoSelect=false; // default to standard action
+if (!config.options.chkTextAreaExtensions) config.options.chkTextAreaExtensions=false; // default to standard action
+
+// Focus a specified tiddler. Attempts to focus the specified field, otherwise the first edit field it finds
+Story.prototype.focusTiddler = function(title,field)
+{
+	var tiddler = document.getElementById(this.idPrefix + title);
+	if(tiddler != null)
+		{
+		var children = tiddler.getElementsByTagName("*")
+		var e = null;
+		for (var t=0; t<children.length; t++)
+			{
+			var c = children[t];
+			if(c.tagName.toLowerCase() == "input" || c.tagName.toLowerCase() == "textarea")
+				{
+				if(!e)
+					e = c;
+				if(c.getAttribute("edit") == field)
+					e = c;
+				}
+			}
+		if(e)
+			{
+			e.focus();
+			e.select(); // select entire contents
+
+			// TWEAK: add TAB and "find" key handlers
+			if (config.options.chkTextAreaExtensions) // add extra key handlers
+				addKeyDownHandlers(e);
+
+			// TWEAK: option to NOT autoselect contents
+			if (config.options.chkDisableAutoSelect) // set cursor to start of field content
+				if (e.setSelectionRange) e.setSelectionRange(0,0); // for FF
+				else if (e.createTextRange) { var r=e.createTextRange(); r.collapse(true); r.select(); } // for IE
+
+			}
+		}
+}
+//}}}
+
+//{{{
+function addKeyDownHandlers(e)
+{
+	// exit if not textarea or element doesn't allow selections
+	if (e.tagName.toLowerCase()!="textarea" || !e.setSelectionRange) return;
+
+	// utility function: exits keydown handler and prevents browser from processing the keystroke
+	var processed=function(ev) { ev.cancelBubble=true; if (ev.stopPropagation) ev.stopPropagation(); return false; }
+
+	// capture keypress in edit field
+	e.onkeydown = function(ev) { if (!ev) var ev=window.event;
+
+		// process TAB
+		if (!ev.shiftKey && ev.keyCode==9) { 
+			// replace current selection with a TAB character
+			var start=e.selectionStart; var end=e.selectionEnd;
+			e.value=e.value.substr(0,start)+String.fromCharCode(9)+e.value.substr(end);
+			// update insertion point, scroll it into view
+			e.setSelectionRange(start+1,start+1);
+			var linecount=e.value.split('\n').length;
+			var thisline=e.value.substr(0,e.selectionStart).split('\n').length-1;
+			e.scrollTop=Math.floor((thisline-e.rows/2)*e.scrollHeight/linecount);
+			return processed(ev);
+		}
+
+		// process CTRL-F (find matching text) or CTRL-G (find next match)
+		if (ev.ctrlKey && (ev.keyCode==70||ev.keyCode==71)) {
+			// if ctrl-f or no previous search, prompt for search text (default to previous text or current selection)... if no search text, exit
+			if (ev.keyCode==70||!e.find||!e.find.length)
+				{ var f=prompt("find:",e.find?e.find:e.value.substring(e.selectionStart,e.selectionEnd)); e.focus(); e.find=f?f:e.find; }
+			if (!e.find||!e.find.length) return processed(ev);
+			// do case-insensitive match with 'wraparound'...  if not found, alert and exit 
+			var newstart=e.value.toLowerCase().indexOf(e.find.toLowerCase(),e.selectionStart+1);
+			if (newstart==-1) newstart=e.value.toLowerCase().indexOf(e.find.toLowerCase());
+			if (newstart==-1) { alert("'"+e.find+"' not found"); e.focus(); return processed(ev); }
+			// set new selection, scroll it into view, and report line position in status bar
+			e.setSelectionRange(newstart,newstart+e.find.length);
+			var linecount=e.value.split('\n').length;
+			var thisline=e.value.substr(0,e.selectionStart).split('\n').length;
+			e.scrollTop=Math.floor((thisline-1-e.rows/2)*e.scrollHeight/linecount);
+			window.status="line: "+thisline+"/"+linecount;
+			return processed(ev);
+		}
+	}
+}
+//}}}

+

+

+
+
+
+
+
+
+
+
+
+
diff --git a/wiki/index.html b/wiki/index.html
index f2f7f8139..7a4d039ca 100755
--- a/wiki/index.html
+++ b/wiki/index.html
@@ -776,72 +776,6 @@ for __Running__

 * provide central interface for setting switches and configuration options
 * installing of some or all created artifacts
-
-
! Lumiera design process
-A lightweight formalized process how people can add proposals for the Lumiera development.
-
-
-!! Description
-Use the Wiki at http://www.pipapo.org/pipawiki/Lumiera/DesignProcess to make it easy to add proposals in a well defined manner.
-
-I'd like to introduce a slightly formalized process for the ongoing Lumiera planning:
-* Every proposal is instantiated as 'Idea', the author gives other people the opportunity to review and comment on it with extreme prejudice, while still working out details.
-* When the the 'Idea' in a proper form and worked out in most details it becomes a 'Draft'. This 'Draft' need to be carefully reviewed, commented, perhaps corrected and rated by the other Developers.
-* At some point we may decide that a 'Draft' becomes a 'Final' (I leave it open how this decision shall be done for now). 'Final' Documents will be imported into the repository (this wiki, you are reading such a Document right now!).
-
-* Sometimes proposals will become dropped for some reason, this is indicated by changing their state to 'Dropped', they still stay in the system for further reference.
-
-!!! Pros
-* simple
-* flexible
-* no much rules
-* persistent and at Final stage well documented process
-
-!!! Cons
-* could be abused/vandalized (but wiki can use ACL's)
-* depends on my server, this might be unfavorable or unreliable, ymmv.
-* will only work if all or almost all involved people agree on this process
-
-!!! Alternatives
-We could use some forum, Trac, Mailinglist or whatever instead.
-
-Just for Design documentation I would give [[Bouml|http://bouml.free.fr/]] a try. For myself, I am not very fond of UML Design tools, while Bouml looks quite promising and we could maintain the UML model in git repositories which would be more favorable than this centralized wiki. The backside is that this needs even more agreement between the developers, everyone has to install and use Bouml (and learn its usage) and design is constrained by a external tool.
-
-This distributed wiki might be used instead the pipapo.org wiki, investigate that for future.
-
-!! Rationale
-Wiki works. It is simple to use and just flexible enough to handle the task. I don't go to install any other software for such tasks on my server. While the design progresses I'd propose to move our work into git repositories and eventually phase this wiki pages out anyways. I'd rather like to start out distributed/git right away .. but git gives us only a fine storage layer, for a design process we need some good presentation layer (later when using git and starting the implementation everyones favorite editor serves for that) I have no better ideas yet to solve the presentation problem other than using this wiki (or maybe Bouml).
-
-
-
-
This is the entry point to several [[TiddlyWiki]]-Pages containing the developer and design documentation for Lumiera.
-
-* Cehteh started GitNotes where we will collect some information about git, howto and special setups
-* since we prefer gpg signed tags in git and not each developer knows gpg well here is a Micro-GPG-HowTo 
-* we maintain (semi-) final design docs in DesignDocumentation
-* Things get often worked out on IRC, see IRC-Transcripts for decisions made there and not yet put into the proper documentation places
-
-Please __end your tiddlers in a newline__, this makes merging in git easier since the /pre tag used in tiddlywiki will become on a single line.
-
-----
-!Design Draft
-to get started, we create design drafts emphasizing different aspects and regions of Lumiera
-
-* Ichthyo focuses mainly on the Render Engine and its interconnection to the EDL, [[see this separate page|renderengine.html]]
-* Cehteh works on the data backend draft, see [[this page|backend.html]]
-* Some tools which don't fit somewhere else and are used everywhere are put into a [[Support Library|support_library.html]]
-* [[Description of the Test System|TestSh]]
-
-!Coding Structures
-next we should //start thinking// on how to organize several aspects of the practical coding...
-* what to do in BOUML?                          &rarr; [[more|whatInBOUML]]
-* how to organize packages, files, includes?    &rarr; [[more|SrcTreeStructure]]
-* how to organize the executable to be built?
-* what coding conventions to prefer?            &rarr; [[GNU Style|DesignDocumentation]]
-* what [[build system|BuildSystem]] to use?
-* various [[build dependencies|BuildDependenceis]]
-* TestSuite
-
LumieraWiki
 ShortCuts
@@ -1407,9 +1341,77 @@ config.formatters.push( { } ) //}}}
-
+
+
! Lumiera design process
+A lightweight formalized process how people can add proposals for the Lumiera development.
+
+
+!! Description
+Use the Wiki at http://www.pipapo.org/pipawiki/Lumiera/DesignProcess to make it easy to add proposals in a well defined manner.
+
+I'd like to introduce a slightly formalized process for the ongoing Lumiera planning:
+* Every proposal is instantiated as 'Idea', the author gives other people the opportunity to review and comment on it with extreme prejudice, while still working out details.
+* When the the 'Idea' in a proper form and worked out in most details it becomes a 'Draft'. This 'Draft' need to be carefully reviewed, commented, perhaps corrected and rated by the other Developers.
+* At some point we may decide that a 'Draft' becomes a 'Final' (I leave it open how this decision shall be done for now). 'Final' Documents will be imported into the repository (this wiki, you are reading such a Document right now!).
+
+* Sometimes proposals will become dropped for some reason, this is indicated by changing their state to 'Dropped', they still stay in the system for further reference.
+
+!!! Pros
+* simple
+* flexible
+* no much rules
+* persistent and at Final stage well documented process
+
+!!! Cons
+* could be abused/vandalized (but wiki can use ACL's)
+* depends on my server, this might be unfavorable or unreliable, ymmv.
+* will only work if all or almost all involved people agree on this process
+
+!!! Alternatives
+We could use some forum, Trac, Mailinglist or whatever instead.
+
+Just for Design documentation I would give [[Bouml|http://bouml.free.fr/]] a try. For myself, I am not very fond of UML Design tools, while Bouml looks quite promising and we could maintain the UML model in git repositories which would be more favorable than this centralized wiki. The backside is that this needs even more agreement between the developers, everyone has to install and use Bouml (and learn its usage) and design is constrained by a external tool.
+
+This distributed wiki might be used instead the pipapo.org wiki, investigate that for future.
+
+!! Rationale
+Wiki works. It is simple to use and just flexible enough to handle the task. I don't go to install any other software for such tasks on my server. While the design progresses I'd propose to move our work into git repositories and eventually phase this wiki pages out anyways. I'd rather like to start out distributed/git right away .. but git gives us only a fine storage layer, for a design process we need some good presentation layer (later when using git and starting the implementation everyones favorite editor serves for that) I have no better ideas yet to solve the presentation problem other than using this wiki (or maybe Bouml).
+
+
+
+
This is the entry point to several [[TiddlyWiki]]-Pages containing the developer and design documentation for Lumiera.
+
+* Cehteh started GitNotes where we will collect some information about git, howto and special setups
+* since we prefer gpg signed tags in git and not each developer knows gpg well here is a Micro-GPG-HowTo 
+* we maintain (semi-) final design docs in DesignDocumentation
+* Things get often worked out on IRC, see IRC-Transcripts for decisions made there and not yet put into the proper documentation places
+
+Please __end your tiddlers in a newline__, this makes merging in git easier since the /pre tag used in tiddlywiki will become on a single line.
+
+----
+!Design Draft
+to get started, we create design drafts emphasizing different aspects and regions of Lumiera
+
+* Ichthyo focuses mainly on the Render Engine and its interconnection to the EDL, [[see this separate page|renderengine.html]]
+* Cehteh works on the data backend draft, see [[this page|backend.html]]
+* Some tools which don't fit somewhere else and are used everywhere are put into a [[Support Library|support_library.html]]
+* [[Description of the Test System|TestSh]]
+
+!Coding Structures
+next we should //start thinking// on how to organize several aspects of the practical coding...
+* what to do in BOUML?                          &rarr; [[more|whatInBOUML]]
+* how to organize packages, files, includes?    &rarr; [[more|SrcTreeStructure]]
+* how to organize the executable to be built?
+* what coding conventions to prefer?            &rarr; [[GNU Style|DesignDocumentation]]
+* what [[build system|BuildSystem]] to use?
+* various [[build dependencies|BuildDependenceis]]
+* TestSuite
+
+
GettingStarted
 [[LumieraWiki]]
+[[Compatibility|compatibility.html]]
+[[ToDo|todo.html]]
 [[Backend|backend.html]]
 [[Proc-Layer|renderengine.html]]
 [[Support-Library|support_library.html]]
@@ -1432,7 +1434,7 @@ Some of these things work quite well, there is an overall friendly relation betw
 
 But there are some bad things too. Notably there is not much progress on the community development. Users don't benefit from new improvements which other people have made. There is a endlessly growing list of bugs and feature requests, when someone sends a patch to the ML he has to invest quite some time to maintain it until it might be merged. Finally we don't know what heroine virtual is working on, until we see his next tarball.
 
-!! Solution for "Cinelerra3" / Lumiera
+!! Solution for "Cinelerra3" / Lumiera
 Cinelerra is heroine's product, this time we should work together with him to make it pleasant and progressing for anyone.
 We are in need of a new development model which is acceptable by all involved people and benefits from the way Cinelerra development worked the years before, without maintaining the bad sides again: 
 
diff --git a/wiki/support_library.html b/wiki/support_library.html
index 095ca833f..8a6bc456b 100644
--- a/wiki/support_library.html
+++ b/wiki/support_library.html
@@ -643,6 +643,11 @@ TertiaryMid: #999
 TertiaryDark: #666
 Error: #f88
+
+
This hashing gives guaranteed O(1) lookup complexity and amortized O(1) insert and remove complexity. Hash tables by default grow and shrink automatically. It is posible to preallocate entries and turn automatic shrinking off taking out the memory management factors for insert and remove operations. This implementation uses 3 Tables which exponential growing sizes.
+
+Hash table utilization is commonly between 40-80% which gives better memory usage and far better locality than trees.
+
[[SupportLibrary]]
@@ -2188,6 +2193,31 @@ config.macros.rssFeedUpdate = { //}}}
+
+
! Memory allocation
+* lumiera_malloc()
+  Succceeds or dies, no need for error handling.
+
+! String functions
+Small wrapers and extensions to the string.h functions, handle NULL pointers gracefully.
+* lumiera_strndup()
+  Succceeds or dies, no need for error handling.
+* lumiera_strncmp() lumiera_streq()
+  Optimized comparing same addresses.
+
+! Round robin temporary buffers
+Provides 64 buffers per thread which are recycled with each use, the idea here is to have fast buffers for temporal data without need for explicit heap management or stack waste.
+
+* lumiera_tmpbuf_provide ()
+ Acquire a temporary buffer. doesn't need to be freed. Stays valid for the next 63 tmpbuf calls.
+
+* lumiera_tmpbuf_strndup ()
+ Duplicate string to a tmpbuf.
+
+* lumiera_tmpbuf_sprintf ()
+ Construct a string in a tmpbuf.
+
+
Each Plugin can export different Interfaces, even same interfaces with different capabilities like a effect for different color models or such.
 
@@ -2419,7 +2449,7 @@ h1,h2,h3,h4,h5,h6 {
 /*}}}*/
-
+
The Support Library contains all tools we need at various places, but by themselves don't defines a subsystem on their own.
 
 These things are:
@@ -2428,8 +2458,9 @@ These things are:
 * a wrapper for POSIX Threads
 ** Thread creation joining and canceling
 ** [[Locking primitives like Condition variables and Mutexes|LockingPrimitives]]
-* [[Frame and Time handling and calculations|FrameAndTime]]
- 
+* [[Some tools and wrapers around the C library|SafeCLib]]
+* [[O(1) hashtable using Cuckoo hashing|Cuckoo]]
+
 (... to be continued)
diff --git a/wiki/todo.html b/wiki/todo.html new file mode 100644 index 000000000..7440ab36a --- /dev/null +++ b/wiki/todo.html @@ -0,0 +1,11631 @@ + + + + + + + + + + + +
My TiddlyWiki is loading ...

Requires Javascript.
+ + ToDo - Roadmap and tasks + + + + + + + + + + + +
+
+
+
+
+
+
+
+
+
+
+
Background: #fff
+Foreground: #000
+PrimaryPale: #8cf
+PrimaryLight: #18f
+PrimaryMid: #04b
+PrimaryDark: #014
+SecondaryPale: #ffc
+SecondaryLight: #fe8
+SecondaryMid: #db4
+SecondaryDark: #841
+TertiaryPale: #eee
+TertiaryLight: #ccc
+TertiaryMid: #999
+TertiaryDark: #666
+Error: #f88
+
+
+
/*{{{*/
+body {background:[[ColorPalette::Background]]; color:[[ColorPalette::Foreground]];}
+
+a {color:[[ColorPalette::PrimaryMid]];}
+a:hover {background-color:[[ColorPalette::PrimaryMid]]; color:[[ColorPalette::Background]];}
+a img {border:0;}
+
+h1,h2,h3,h4,h5,h6 {color:[[ColorPalette::SecondaryDark]]; background:transparent;}
+h1 {border-bottom:2px solid [[ColorPalette::TertiaryLight]];}
+h2,h3 {border-bottom:1px solid [[ColorPalette::TertiaryLight]];}
+
+.button {color:[[ColorPalette::PrimaryDark]]; border:1px solid [[ColorPalette::Background]];}
+.button:hover {color:[[ColorPalette::PrimaryDark]]; background:[[ColorPalette::SecondaryLight]]; border-color:[[ColorPalette::SecondaryMid]];}
+.button:active {color:[[ColorPalette::Background]]; background:[[ColorPalette::SecondaryMid]]; border:1px solid [[ColorPalette::SecondaryDark]];}
+
+.header {background:[[ColorPalette::PrimaryMid]];}
+.headerShadow {color:[[ColorPalette::Foreground]];}
+.headerShadow a {font-weight:normal; color:[[ColorPalette::Foreground]];}
+.headerForeground {color:[[ColorPalette::Background]];}
+.headerForeground a {font-weight:normal; color:[[ColorPalette::PrimaryPale]];}
+
+.tabSelected{color:[[ColorPalette::PrimaryDark]];
+	background:[[ColorPalette::TertiaryPale]];
+	border-left:1px solid [[ColorPalette::TertiaryLight]];
+	border-top:1px solid [[ColorPalette::TertiaryLight]];
+	border-right:1px solid [[ColorPalette::TertiaryLight]];
+}
+.tabUnselected {color:[[ColorPalette::Background]]; background:[[ColorPalette::TertiaryMid]];}
+.tabContents {color:[[ColorPalette::PrimaryDark]]; background:[[ColorPalette::TertiaryPale]]; border:1px solid [[ColorPalette::TertiaryLight]];}
+.tabContents .button {border:0;}
+
+#sidebar {}
+#sidebarOptions input {border:1px solid [[ColorPalette::PrimaryMid]];}
+#sidebarOptions .sliderPanel {background:[[ColorPalette::PrimaryPale]];}
+#sidebarOptions .sliderPanel a {border:none;color:[[ColorPalette::PrimaryMid]];}
+#sidebarOptions .sliderPanel a:hover {color:[[ColorPalette::Background]]; background:[[ColorPalette::PrimaryMid]];}
+#sidebarOptions .sliderPanel a:active {color:[[ColorPalette::PrimaryMid]]; background:[[ColorPalette::Background]];}
+
+.wizard {background:[[ColorPalette::PrimaryPale]]; border:1px solid [[ColorPalette::PrimaryMid]];}
+.wizard h1 {color:[[ColorPalette::PrimaryDark]]; border:none;}
+.wizard h2 {color:[[ColorPalette::Foreground]]; border:none;}
+.wizardStep {background:[[ColorPalette::Background]]; color:[[ColorPalette::Foreground]];
+	border:1px solid [[ColorPalette::PrimaryMid]];}
+.wizardStep.wizardStepDone {background::[[ColorPalette::TertiaryLight]];}
+.wizardFooter {background:[[ColorPalette::PrimaryPale]];}
+.wizardFooter .status {background:[[ColorPalette::PrimaryDark]]; color:[[ColorPalette::Background]];}
+.wizard .button {color:[[ColorPalette::Foreground]]; background:[[ColorPalette::SecondaryLight]]; border: 1px solid;
+	border-color:[[ColorPalette::SecondaryPale]] [[ColorPalette::SecondaryDark]] [[ColorPalette::SecondaryDark]] [[ColorPalette::SecondaryPale]];}
+.wizard .button:hover {color:[[ColorPalette::Foreground]]; background:[[ColorPalette::Background]];}
+.wizard .button:active {color:[[ColorPalette::Background]]; background:[[ColorPalette::Foreground]]; border: 1px solid;
+	border-color:[[ColorPalette::PrimaryDark]] [[ColorPalette::PrimaryPale]] [[ColorPalette::PrimaryPale]] [[ColorPalette::PrimaryDark]];}
+
+#messageArea {border:1px solid [[ColorPalette::SecondaryMid]]; background:[[ColorPalette::SecondaryLight]]; color:[[ColorPalette::Foreground]];}
+#messageArea .button {color:[[ColorPalette::PrimaryMid]]; background:[[ColorPalette::SecondaryPale]]; border:none;}
+
+.popupTiddler {background:[[ColorPalette::TertiaryPale]]; border:2px solid [[ColorPalette::TertiaryMid]];}
+
+.popup {background:[[ColorPalette::TertiaryPale]]; color:[[ColorPalette::TertiaryDark]]; border-left:1px solid [[ColorPalette::TertiaryMid]]; border-top:1px solid [[ColorPalette::TertiaryMid]]; border-right:2px solid [[ColorPalette::TertiaryDark]]; border-bottom:2px solid [[ColorPalette::TertiaryDark]];}
+.popup hr {color:[[ColorPalette::PrimaryDark]]; background:[[ColorPalette::PrimaryDark]]; border-bottom:1px;}
+.popup li.disabled {color:[[ColorPalette::TertiaryMid]];}
+.popup li a, .popup li a:visited {color:[[ColorPalette::Foreground]]; border: none;}
+.popup li a:hover {background:[[ColorPalette::SecondaryLight]]; color:[[ColorPalette::Foreground]]; border: none;}
+.popup li a:active {background:[[ColorPalette::SecondaryPale]]; color:[[ColorPalette::Foreground]]; border: none;}
+.popupHighlight {background:[[ColorPalette::Background]]; color:[[ColorPalette::Foreground]];}
+.listBreak div {border-bottom:1px solid [[ColorPalette::TertiaryDark]];}
+
+.tiddler .defaultCommand {font-weight:bold;}
+
+.shadow .title {color:[[ColorPalette::TertiaryDark]];}
+
+.title {color:[[ColorPalette::SecondaryDark]];}
+.subtitle {color:[[ColorPalette::TertiaryDark]];}
+
+.toolbar {color:[[ColorPalette::PrimaryMid]];}
+.toolbar a {color:[[ColorPalette::TertiaryLight]];}
+.selected .toolbar a {color:[[ColorPalette::TertiaryMid]];}
+.selected .toolbar a:hover {color:[[ColorPalette::Foreground]];}
+
+.tagging, .tagged {border:1px solid [[ColorPalette::TertiaryPale]]; background-color:[[ColorPalette::TertiaryPale]];}
+.selected .tagging, .selected .tagged {background-color:[[ColorPalette::TertiaryLight]]; border:1px solid [[ColorPalette::TertiaryMid]];}
+.tagging .listTitle, .tagged .listTitle {color:[[ColorPalette::PrimaryDark]];}
+.tagging .button, .tagged .button {border:none;}
+
+.footer {color:[[ColorPalette::TertiaryLight]];}
+.selected .footer {color:[[ColorPalette::TertiaryMid]];}
+
+.sparkline {background:[[ColorPalette::PrimaryPale]]; border:0;}
+.sparktick {background:[[ColorPalette::PrimaryDark]];}
+
+.error, .errorButton {color:[[ColorPalette::Foreground]]; background:[[ColorPalette::Error]];}
+.warning {color:[[ColorPalette::Foreground]]; background:[[ColorPalette::SecondaryPale]];}
+.lowlight {background:[[ColorPalette::TertiaryLight]];}
+
+.zoomer {background:none; color:[[ColorPalette::TertiaryMid]]; border:3px solid [[ColorPalette::TertiaryMid]];}
+
+.imageLink, #displayArea .imageLink {background:transparent;}
+
+.annotation {background:[[ColorPalette::SecondaryLight]]; color:[[ColorPalette::Foreground]]; border:2px solid [[ColorPalette::SecondaryMid]];}
+
+.viewer .listTitle {list-style-type:none; margin-left:-2em;}
+.viewer .button {border:1px solid [[ColorPalette::SecondaryMid]];}
+.viewer blockquote {border-left:3px solid [[ColorPalette::TertiaryDark]];}
+
+.viewer table, table.twtable {border:2px solid [[ColorPalette::TertiaryDark]];}
+.viewer th, .viewer thead td, .twtable th, .twtable thead td {background:[[ColorPalette::SecondaryMid]]; border:1px solid [[ColorPalette::TertiaryDark]]; color:[[ColorPalette::Background]];}
+.viewer td, .viewer tr, .twtable td, .twtable tr {border:1px solid [[ColorPalette::TertiaryDark]];}
+
+.viewer pre {border:1px solid [[ColorPalette::SecondaryLight]]; background:[[ColorPalette::SecondaryPale]];}
+.viewer code {color:[[ColorPalette::SecondaryDark]];}
+.viewer hr {border:0; border-top:dashed 1px [[ColorPalette::TertiaryDark]]; color:[[ColorPalette::TertiaryDark]];}
+
+.highlight, .marked {background:[[ColorPalette::SecondaryLight]];}
+
+.editor input {border:1px solid [[ColorPalette::PrimaryMid]];}
+.editor textarea {border:1px solid [[ColorPalette::PrimaryMid]]; width:100%;}
+.editorFooter {color:[[ColorPalette::TertiaryMid]];}
+
+#backstageArea {background:[[ColorPalette::Foreground]]; color:[[ColorPalette::TertiaryMid]];}
+#backstageArea a {background:[[ColorPalette::Foreground]]; color:[[ColorPalette::Background]]; border:none;}
+#backstageArea a:hover {background:[[ColorPalette::SecondaryLight]]; color:[[ColorPalette::Foreground]]; }
+#backstageArea a.backstageSelTab {background:[[ColorPalette::Background]]; color:[[ColorPalette::Foreground]];}
+#backstageButton a {background:none; color:[[ColorPalette::Background]]; border:none;}
+#backstageButton a:hover {background:[[ColorPalette::Foreground]]; color:[[ColorPalette::Background]]; border:none;}
+#backstagePanel {background:[[ColorPalette::Background]]; border-color: [[ColorPalette::Background]] [[ColorPalette::TertiaryDark]] [[ColorPalette::TertiaryDark]] [[ColorPalette::TertiaryDark]];}
+.backstagePanelFooter .button {border:none; color:[[ColorPalette::Background]];}
+.backstagePanelFooter .button:hover {color:[[ColorPalette::Foreground]];}
+#backstageCloak {background:[[ColorPalette::Foreground]]; opacity:0.6; filter:'alpha(opacity:60)';}
+/*}}}*/
+
+
+
/*{{{*/
+* html .tiddler {height:1%;}
+
+body {font-size:.75em; font-family:arial,helvetica; margin:0; padding:0;}
+
+h1,h2,h3,h4,h5,h6 {font-weight:bold; text-decoration:none;}
+h1,h2,h3 {padding-bottom:1px; margin-top:1.2em;margin-bottom:0.3em;}
+h4,h5,h6 {margin-top:1em;}
+h1 {font-size:1.35em;}
+h2 {font-size:1.25em;}
+h3 {font-size:1.1em;}
+h4 {font-size:1em;}
+h5 {font-size:.9em;}
+
+hr {height:1px;}
+
+a {text-decoration:none;}
+
+dt {font-weight:bold;}
+
+ol {list-style-type:decimal;}
+ol ol {list-style-type:lower-alpha;}
+ol ol ol {list-style-type:lower-roman;}
+ol ol ol ol {list-style-type:decimal;}
+ol ol ol ol ol {list-style-type:lower-alpha;}
+ol ol ol ol ol ol {list-style-type:lower-roman;}
+ol ol ol ol ol ol ol {list-style-type:decimal;}
+
+.txtOptionInput {width:11em;}
+
+#contentWrapper .chkOptionInput {border:0;}
+
+.externalLink {text-decoration:underline;}
+
+.indent {margin-left:3em;}
+.outdent {margin-left:3em; text-indent:-3em;}
+code.escaped {white-space:nowrap;}
+
+.tiddlyLinkExisting {font-weight:bold;}
+.tiddlyLinkNonExisting {font-style:italic;}
+
+/* the 'a' is required for IE, otherwise it renders the whole tiddler in bold */
+a.tiddlyLinkNonExisting.shadow {font-weight:bold;}
+
+#mainMenu .tiddlyLinkExisting,
+	#mainMenu .tiddlyLinkNonExisting,
+	#sidebarTabs .tiddlyLinkNonExisting {font-weight:normal; font-style:normal;}
+#sidebarTabs .tiddlyLinkExisting {font-weight:bold; font-style:normal;}
+
+.header {position:relative;}
+.header a:hover {background:transparent;}
+.headerShadow {position:relative; padding:4.5em 0em 1em 1em; left:-1px; top:-1px;}
+.headerForeground {position:absolute; padding:4.5em 0em 1em 1em; left:0px; top:0px;}
+
+.siteTitle {font-size:3em;}
+.siteSubtitle {font-size:1.2em;}
+
+#mainMenu {position:absolute; left:0; width:10em; text-align:right; line-height:1.6em; padding:1.5em 0.5em 0.5em 0.5em; font-size:1.1em;}
+
+#sidebar {position:absolute; right:3px; width:16em; font-size:.9em;}
+#sidebarOptions {padding-top:0.3em;}
+#sidebarOptions a {margin:0em 0.2em; padding:0.2em 0.3em; display:block;}
+#sidebarOptions input {margin:0.4em 0.5em;}
+#sidebarOptions .sliderPanel {margin-left:1em; padding:0.5em; font-size:.85em;}
+#sidebarOptions .sliderPanel a {font-weight:bold; display:inline; padding:0;}
+#sidebarOptions .sliderPanel input {margin:0 0 .3em 0;}
+#sidebarTabs .tabContents {width:15em; overflow:hidden;}
+
+.wizard {padding:0.1em 1em 0em 2em;}
+.wizard h1 {font-size:2em; font-weight:bold; background:none; padding:0em 0em 0em 0em; margin:0.4em 0em 0.2em 0em;}
+.wizard h2 {font-size:1.2em; font-weight:bold; background:none; padding:0em 0em 0em 0em; margin:0.4em 0em 0.2em 0em;}
+.wizardStep {padding:1em 1em 1em 1em;}
+.wizard .button {margin:0.5em 0em 0em 0em; font-size:1.2em;}
+.wizardFooter {padding:0.8em 0.4em 0.8em 0em;}
+.wizardFooter .status {padding:0em 0.4em 0em 0.4em; margin-left:1em;}
+.wizard .button {padding:0.1em 0.2em 0.1em 0.2em;}
+
+#messageArea {position:fixed; top:2em; right:0em; margin:0.5em; padding:0.5em; z-index:2000; _position:absolute;}
+.messageToolbar {display:block; text-align:right; padding:0.2em 0.2em 0.2em 0.2em;}
+#messageArea a {text-decoration:underline;}
+
+.tiddlerPopupButton {padding:0.2em 0.2em 0.2em 0.2em;}
+.popupTiddler {position: absolute; z-index:300; padding:1em 1em 1em 1em; margin:0;}
+
+.popup {position:absolute; z-index:300; font-size:.9em; padding:0; list-style:none; margin:0;}
+.popup .popupMessage {padding:0.4em;}
+.popup hr {display:block; height:1px; width:auto; padding:0; margin:0.2em 0em;}
+.popup li.disabled {padding:0.4em;}
+.popup li a {display:block; padding:0.4em; font-weight:normal; cursor:pointer;}
+.listBreak {font-size:1px; line-height:1px;}
+.listBreak div {margin:2px 0;}
+
+.tabset {padding:1em 0em 0em 0.5em;}
+.tab {margin:0em 0em 0em 0.25em; padding:2px;}
+.tabContents {padding:0.5em;}
+.tabContents ul, .tabContents ol {margin:0; padding:0;}
+.txtMainTab .tabContents li {list-style:none;}
+.tabContents li.listLink { margin-left:.75em;}
+
+#contentWrapper {display:block;}
+#splashScreen {display:none;}
+
+#displayArea {margin:1em 17em 0em 14em;}
+
+.toolbar {text-align:right; font-size:.9em;}
+
+.tiddler {padding:1em 1em 0em 1em;}
+
+.missing .viewer,.missing .title {font-style:italic;}
+
+.title {font-size:1.6em; font-weight:bold;}
+
+.missing .subtitle {display:none;}
+.subtitle {font-size:1.1em;}
+
+.tiddler .button {padding:0.2em 0.4em;}
+
+.tagging {margin:0.5em 0.5em 0.5em 0; float:left; display:none;}
+.isTag .tagging {display:block;}
+.tagged {margin:0.5em; float:right;}
+.tagging, .tagged {font-size:0.9em; padding:0.25em;}
+.tagging ul, .tagged ul {list-style:none; margin:0.25em; padding:0;}
+.tagClear {clear:both;}
+
+.footer {font-size:.9em;}
+.footer li {display:inline;}
+
+.annotation {padding:0.5em; margin:0.5em;}
+
+* html .viewer pre {width:99%; padding:0 0 1em 0;}
+.viewer {line-height:1.4em; padding-top:0.5em;}
+.viewer .button {margin:0em 0.25em; padding:0em 0.25em;}
+.viewer blockquote {line-height:1.5em; padding-left:0.8em;margin-left:2.5em;}
+.viewer ul, .viewer ol {margin-left:0.5em; padding-left:1.5em;}
+
+.viewer table, table.twtable {border-collapse:collapse; margin:0.8em 1.0em;}
+.viewer th, .viewer td, .viewer tr,.viewer caption,.twtable th, .twtable td, .twtable tr,.twtable caption {padding:3px;}
+table.listView {font-size:0.85em; margin:0.8em 1.0em;}
+table.listView th, table.listView td, table.listView tr {padding:0px 3px 0px 3px;}
+
+.viewer pre {padding:0.5em; margin-left:0.5em; font-size:1.2em; line-height:1.4em; overflow:auto;}
+.viewer code {font-size:1.2em; line-height:1.4em;}
+
+.editor {font-size:1.1em;}
+.editor input, .editor textarea {display:block; width:100%; font:inherit;}
+.editorFooter {padding:0.25em 0em; font-size:.9em;}
+.editorFooter .button {padding-top:0px; padding-bottom:0px;}
+
+.fieldsetFix {border:0; padding:0; margin:1px 0px 1px 0px;}
+
+.sparkline {line-height:1em;}
+.sparktick {outline:0;}
+
+.zoomer {font-size:1.1em; position:absolute; overflow:hidden;}
+.zoomer div {padding:1em;}
+
+* html #backstage {width:99%;}
+* html #backstageArea {width:99%;}
+#backstageArea {display:none; position:relative; overflow: hidden; z-index:150; padding:0.3em 0.5em 0.3em 0.5em;}
+#backstageToolbar {position:relative;}
+#backstageArea a {font-weight:bold; margin-left:0.5em; padding:0.3em 0.5em 0.3em 0.5em;}
+#backstageButton {display:none; position:absolute; z-index:175; top:0em; right:0em;}
+#backstageButton a {padding:0.1em 0.4em 0.1em 0.4em; margin:0.1em 0.1em 0.1em 0.1em;}
+#backstage {position:relative; width:100%; z-index:50;}
+#backstagePanel {display:none; z-index:100; position:absolute; margin:0em 3em 0em 3em; padding:1em 1em 1em 1em;}
+.backstagePanelFooter {padding-top:0.2em; float:right;}
+.backstagePanelFooter a {padding:0.2em 0.4em 0.2em 0.4em;}
+#backstageCloak {display:none; z-index:20; position:absolute; width:100%; height:100px;}
+
+.whenBackstage {display:none;}
+.backstageVisible .whenBackstage {display:block;}
+/*}}}*/
+
+
+
/***
+StyleSheet for use when a translation requires any css style changes.
+This StyleSheet can be used directly by languages such as Chinese, Japanese and Korean which use a logographic writing system and need larger font sizes.
+***/
+
+/*{{{*/
+body {font-size:0.8em;}
+
+#sidebarOptions {font-size:1.05em;}
+#sidebarOptions a {font-style:normal;}
+#sidebarOptions .sliderPanel {font-size:0.95em;}
+
+.subtitle {font-size:0.8em;}
+
+.viewer table.listView {font-size:0.95em;}
+
+.htmlarea .toolbarHA table {border:1px solid ButtonFace; margin:0em 0em;}
+/*}}}*/
+
+
+
/*{{{*/
+@media print {
+#mainMenu, #sidebar, #messageArea, .toolbar, #backstageButton {display: none ! important;}
+#displayArea {margin: 1em 1em 0em 1em;}
+/* Fixes a feature in Firefox 1.5.0.2 where print preview displays the noscript content */
+noscript {display:none;}
+}
+/*}}}*/
+
+
+
<!--{{{-->
+<div class='header' macro='gradient vert [[ColorPalette::PrimaryLight]] [[ColorPalette::PrimaryMid]]'>
+<div class='headerShadow'>
+<span class='siteTitle' refresh='content' tiddler='SiteTitle'></span>&nbsp;
+<span class='siteSubtitle' refresh='content' tiddler='SiteSubtitle'></span>
+</div>
+<div class='headerForeground'>
+<span class='siteTitle' refresh='content' tiddler='SiteTitle'></span>&nbsp;
+<span class='siteSubtitle' refresh='content' tiddler='SiteSubtitle'></span>
+</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>
+<!--}}}-->
+
+
+
<!--{{{-->
+<div class='toolbar' macro='toolbar closeTiddler closeOthers +editTiddler > fields syncing permalink references jump'></div>
+<div class='title' macro='view title'></div>
+<div class='subtitle'><span macro='view modifier link'></span>, <span macro='view modified date'></span> (<span macro='message views.wikified.createdPrompt'></span> <span macro='view created date'></span>)</div>
+<div class='tagging' macro='tagging'></div>
+<div class='tagged' macro='tags'></div>
+<div class='viewer' macro='view text wikified'></div>
+<div class='tagClear'></div>
+<!--}}}-->
+
+
+
<!--{{{-->
+<div class='toolbar' macro='toolbar +saveTiddler -cancelTiddler deleteTiddler'></div>
+<div class='title' macro='view title'></div>
+<div class='editor' macro='edit title'></div>
+<div macro='annotations'></div>
+<div class='editor' macro='edit text'></div>
+<div class='editor' macro='edit tags'></div><div class='editorFooter'><span macro='message views.editor.tagPrompt'></span><span macro='tagChooser'></span></div>
+<!--}}}-->
+
+
+
To get started with this blank TiddlyWiki, you'll need to modify the following tiddlers:
+* SiteTitle & SiteSubtitle: The title and subtitle of the site, as shown above (after saving, they will also appear in the browser title bar)
+* MainMenu: The menu (usually on the left)
+* DefaultTiddlers: Contains the names of the tiddlers that you want to appear when the TiddlyWiki is opened
+You'll also need to enter your username for signing your edits: <<option txtUserName>>
+
+
+
These InterfaceOptions for customising TiddlyWiki are saved in your browser
+
+Your username for signing your edits. Write it as a WikiWord (eg JoeBloggs)
+
+<<option txtUserName>>
+<<option chkSaveBackups>> SaveBackups
+<<option chkAutoSave>> AutoSave
+<<option chkRegExpSearch>> RegExpSearch
+<<option chkCaseSensitiveSearch>> CaseSensitiveSearch
+<<option chkAnimate>> EnableAnimations
+
+----
+Also see AdvancedOptions
+
+
+ +
+
+
A task has a description, an estimate of how long it will take, and a record of how much time you have spent on it so far.  Here's an example, which shows a task estimated at 3 hours, with 1 hour spent on it, and ''2'' hours remaining:
+<<<
+<<task 3 3 1>> Add a double-click handler to the description cell that opens the editor and selects the text
+<<<
+If you hover the mouse over any part of the task -- the bullet, the description, or any of the numeric cells -- a tip will appear explaining it.
+
+Try modifying the time spent.  Suppose you've just spent one more hour and want to record it.  Just click on the second yellow cell, and enter "+1" (sans the quote marks, of course) in the popup window.  Watch the time remaining go down to 1 hour.
+
+In reality, I originally estimated this task at a half-hour, but it ended up taking 3.5 hours.  The macro also tracks your original estimate, if it is different from the current estimate, in a fourth cell like this:
+<<<
+<<task 0.5 2 1>> Add a double-click handler to the description cell that opens the editor and selects the text
+<<<
+You can adjust the current estimate in the same way as you adjusted the time spent.  Click on the current estimate cell (the first yellow cell), and change it to 2.5 hours by typing "2.5" or "+.5".
+
+You can also adjust the time remaining, which will modify either the estimate (if the time remaining increases) or the time spent (if it decreases).  Click on the time remaining and add an hour by typing "+1".
+
+When the time remaining goes to zero, the task is considered complete:
+<<<
+<<task 0.5 3.5 3.5>> Add a double-click handler to the description cell that opens the editor and selects the text
+<<<
+If you haven't already done so, try double-clicking the description.  Yes, it really does open up the editor and select just the text of the description.
+
+----
+To continue, click the down-arrow and choose another section: <<tag TaskMacroTutorial>>
+
+
+
A task's description is a single wikified line, so it can contain any formatting that can be specified on one line:
+<<<
+<<task 1>> Beef up the time click handlers to allow entry of ''two'' values each: cur&spent, spent&rem. Add click handler to done tasks' spent cells too, to reopen them (like with +0, 1).
+<<task 0.5>> Put tasksum on the ViewTemplate.
+<<<
+You can specify just the description of a task, and leave it unestimated.  Click the question mark to enter the estimate:
+<<<
+<<task>> Beef up the time click handlers to allow entry of ''two'' values each: cur&spent, spent&rem. Add click handler to done tasks' spent cells too, to reopen them (like with +0, 1).
+<<<
+As this task implies, you can enter two values in the popup when you click on any of the time cells.  Separate them with spaces and/or a comma.  Experiment:
+<<<
+<<task 1>> Beef up the time click handlers to allow entry of ''two'' values each: cur&spent, spent&rem. Add click handler to done tasks' spent cells too, to reopen them (like with +0, 1).
+<<<
+Finally, if you haven't already figured this out, you can double-click on a task's bullet to mark it complete, with the current estimate entered as the time spent.
+
+----
+To continue, click the down-arrow and choose another section: <<tag TaskMacroTutorial>>
+
+
+
If you've been paying attention, you've noticed that I haven't discussed the actual adding of calls to the task macro within your tiddlers -- it's all been about modifying tasks that were already there.  That's because adding tasks via the taskadder macro is much easier and more intuitive than adding them by hand.
+
+And setting up a taskadder is simplicity itself.  Just add {{{<<taskadder>>}}} to your tiddler.  You will see this:
+<<<
+<<taskadder>>
+<<<
+Just type a task description into the first field, and your initial estimate for how long it will take into the second field.  Click the "add task" button, or just hit Enter in either of the fields, to add the new task into the tiddler.  Notice that you can just start typing a new task as soon as you're done entering the first one.
+
+You can have as many taskadders as you like in any tiddler.  The last one you used will capture the keyboard focus when it is redisplayed, meaning you can type a series of tasks without using the mouse.  Try adding some tasks here and in the above adder:
+<<<
+<<taskadder>>
+<<<
+Notice that the one you just used takes focus when this tiddler is redisplayed.
+
+A taskadder by default adds tasks above itself.  You can make it add them below by adding a {{{below}}} argument to the macro call:
+<<<
+<<taskadder below>>
+<<<
+
+----
+To continue, click the down-arrow and choose another section: <<tag TaskMacroTutorial>>
+
+
+
In this tutorial, we've been looking mostly at individual tasks.  In real life, though, you'll typically have a series of them, or even several series of them in the same tiddler.  In these cases you want a summary that tells you -- at a minimum -- how much time you still expect to spend on these tasks.
+
+To get such a summary, just add {{{<<tasksum start>>}}} before the tasks and {{{<<tasksum end>>}}} after them.  Here's an example:
+<<<
+<<tasksum start>>
+<<task 0.25 0.25 0.25>> Add tooltips to the various cells
+<<task 1 0.75 0.75>> Figure out how to add auto-updating click handlers to the time cells
+<<task 2 2 0>> Add simple click handlers to cur, spent, rem: just allow direct setting of values
+<<task 1 3.5 2.5>> Add a double-click handler to the desc cell that opens the editor and selects the text
+<<task 1 1 0>> Beef up the time click handlers to allow entry of two values each: cur&spent, spent&rem. Add click handler to done tasks' spent cells too, to reopen them (like with +0, 1).
+<<task 1 1 0>> Beef up the time click handlers to handle leading + or -
+<<task 1 1 0>> Add a double-click handler to the status cell that functions like typing 0 into the rem cell
+<<tasksum end>>
+<<<
+If you'd rather have the summary at the top, just add {{{here}}} to the start call, ie {{{<<tasksum start here>>}}}.
+<<<
+<<tasksum start here>>
+<<task 0.25 0.25 0.25>> Add tooltips to the various cells
+<<task 1 0.75 0.75>> Figure out how to add auto-updating click handlers to the time cells
+<<task 2 2 0>> Add simple click handlers to cur, spent, rem: just allow direct setting of values
+<<tasksum end>>
+<<<
+You can nest these things if you like, just be sure to match starts and ends:
+<<<
+<<tasksum start here>>
+* Time cell manipulation:<<tasksum start>>
+<<task 1 0.75 0.75>> Figure out how to add auto-updating click handlers to the time cells
+<<task 2 2 0>> Add simple click handlers to cur, spent, rem: just allow direct setting of values
+<<task 1 1 0>> Beef up the time click handlers to allow entry of two values each: cur&spent, spent&rem. Add click handler to done tasks' spent cells too, to reopen them (like with +0, 1).
+<<task 1 1 0>> Beef up the time click handlers to handle leading + or -
+<<tasksum end "Cell manipulation:">>
+<<br>>
+* Double-click handling:<<tasksum start>>
+<<task 1 3.5 2.5>> Add a double-click handler to the desc cell that opens the editor and selects the text
+<<task 1 1 0>> Add a double-click handler to the status cell that functions like typing 0 into the rem cell
+<<tasksum end "Double-clicks:">>
+
+<<tasksum end>>
+<<<
+Finally, the simplest way to use tasksum is to add it to your view template.  See TaskSummaryViewTemplate for an example template.  Note that if no tasks are present between the start and end, nothing is displayed.
+
+----
+To continue, click the down-arrow and choose another section: <<tag TaskMacroTutorial>>
+
+
+
The TaskMacroPlugin can be installed like any other TiddlyWiki plugin, and used without further effort.  However, there are two issues that may affect you.  (To get started with a brand new wiki that does not have these issues, consider downloading the [[empty LabWiki|empty_labwiki.html]].)
+# The task macros don't play nicely with the default TiddlyWiki display of tags.  In the default view template, a tiddler's list of tags is shown in a little box that floats in the upper right corner of the tiddler.  However, this little box may interfere with the tables used by the task macros.  In Firefox, the tables are drawn right over the top of the tag box, rendering both of them illegible.  In Internet Explorer, the tag box forces the tables to be pushed down below the box, which can waste a lot of space.<<br>><<br>>Thus, I recommend changing your view template to eliminate the little box.  If you use Simon Baird's [[TagglyTagging|http://simonbaird.com/mptw/#TagglyTagging]] (as LabWiki does), then my TaskSummaryViewTemplate might be a good alternative.  Simply import it into your wiki and rename it to ViewTemplate.  This template also demonstrates how to incorporate the tasksum macro into every tiddler so any tiddler with tasks has a summary at the top.<<br>><<br>>
+# Most view templates also add a minus sign ("-") before the "close" command.  TiddlyWiki interprets this to mean that you want the close command to be executed if you hit the Escape key from within the tiddler.<<br>><<br>>However, most tiddlers never have focus, and so never give you the opportunity to try it out.  But if you have a taskadder in your tiddler, then you suddenly enable this feature -- and you probably don't want it.  It means that if you type a nice long task description and then hit Escape, that description will be lost and the tiddler will be closed.  So I recommend that you remove the minus sign from the view template's menu altogether, as I have done in LabWiki's own ViewTemplate.
+
+----
+This ends the tutorial.  To go back to any previous section, click the down-arrow and choose it: <<tag TaskMacroTutorial>>
+
+
+
PageTemplate
+|>|SiteTitle - SiteSubtitle|
+|>|MainMenu|
+|DefaultTiddlers<<br>><<br>><<br>>ViewTemplate<<br>><<br>>EditTemplate|SideBarOptions|
+|~|OptionsPanel|
+|~|SideBarTabs|
+|~|AdvancedOptions|
+|~|<<tiddler Configuration.SideBarTabs>>|
+
+''StyleSheet:'' StyleSheetColors - StyleSheetLayout - StyleSheetPrint
+
+ColorPalette
+
+SiteUrl
+
+
+
/***
+|Name|BetterTimelineMacro|
+|Created by|SaqImtiaz|
+|Location|http://tw.lewcid.org/#BetterTimelineMacro|
+|Version|0.5 beta|
+|Requires|~TW2.x|
+!!!Description:
+A replacement for the core timeline macro that offers more features:
+*list tiddlers with only specfic tag
+*exclude tiddlers with a particular tag
+*limit entries to any number of days, for example one week
+*specify a start date for the timeline, only tiddlers after that date will be listed.
+
+!!!Installation:
+Copy the contents of this tiddler to your TW, tag with systemConfig, save and reload your TW.
+Edit the ViewTemplate to add the fullscreen command to the toolbar.
+
+!!!Syntax:
+{{{<<timeline better:true>>}}}
+''the param better:true enables the advanced features, without it you will get the old timeline behaviour.''
+
+additonal params:
+(use only the ones you want)
+{{{<<timeline better:true  onlyTag:Tag1 excludeTag:Tag2 sortBy:modified/created firstDay:YYYYMMDD maxDays:7 maxEntries:30>>}}}
+
+''explanation of syntax:''
+onlyTag: only tiddlers with this tag will be listed. Default is to list all tiddlers.
+excludeTag: tiddlers with this tag will not be listed.
+sortBy: sort tiddlers by date modified or date created. Possible values are modified or created.
+firstDay: useful for starting timeline from a specific date. Example: 20060701 for 1st of July, 2006
+maxDays: limits timeline to include only tiddlers from the specified number of days. If you use a value of 7 for example, only tiddlers from the last 7 days will be listed.
+maxEntries: limit the total number of entries in the timeline.
+
+
+!!!History:
+*28-07-06: ver 0.5 beta, first release
+
+!!!Code
+***/
+//{{{
+// Return the tiddlers as a sorted array
+TiddlyWiki.prototype.getTiddlers = function(field,excludeTag,includeTag)
+{
+          var results = [];
+          this.forEachTiddler(function(title,tiddler)
+          {
+          if(excludeTag == undefined || tiddler.tags.find(excludeTag) == null)
+                        if(includeTag == undefined || tiddler.tags.find(includeTag)!=null)
+                                      results.push(tiddler);
+          });
+          if(field)
+                   results.sort(function (a,b) {if(a[field] == b[field]) return(0); else return (a[field] < b[field]) ? -1 : +1; });
+          return results;
+}
+
+
+
+//this function by Udo
+function getParam(params, name, defaultValue)
+{
+          if (!params)
+          return defaultValue;
+          var p = params[0][name];
+          return p ? p[0] : defaultValue;
+}
+
+window.old_timeline_handler= config.macros.timeline.handler;
+config.macros.timeline.handler = function(place,macroName,params,wikifier,paramString,tiddler)
+{
+          var args = paramString.parseParams("list",null,true);
+          var betterMode = getParam(args, "better", "false");
+          if (betterMode == 'true')
+          {
+          var sortBy = getParam(args,"sortBy","modified");
+          var excludeTag = getParam(args,"excludeTag",undefined);
+          var includeTag = getParam(args,"onlyTag",undefined);
+          var tiddlers = store.getTiddlers(sortBy,excludeTag,includeTag);
+          var firstDayParam = getParam(args,"firstDay",undefined);
+          var firstDay = (firstDayParam!=undefined)? firstDayParam: "00010101";
+          var lastDay = "";
+          var field= sortBy;
+          var maxDaysParam = getParam(args,"maxDays",undefined);
+          var maxDays = (maxDaysParam!=undefined)? maxDaysParam*24*60*60*1000: (new Date()).getTime() ;
+          var maxEntries = getParam(args,"maxEntries",undefined);
+          var last = (maxEntries!=undefined) ? tiddlers.length-Math.min(tiddlers.length,parseInt(maxEntries)) : 0;
+          for(var t=tiddlers.length-1; t>=last; t--)
+                  {
+                  var tiddler = tiddlers[t];
+                  var theDay = tiddler[field].convertToLocalYYYYMMDDHHMM().substr(0,8);
+                  if ((theDay>=firstDay)&& (tiddler[field].getTime()> (new Date()).getTime() - maxDays))
+                     {
+                     if(theDay != lastDay)
+                               {
+                               var theDateList = document.createElement("ul");
+                               place.appendChild(theDateList);
+                               createTiddlyElement(theDateList,"li",null,"listTitle",tiddler[field].formatString(this.dateFormat));
+                               lastDay = theDay;
+                               }
+                  var theDateListItem = createTiddlyElement(theDateList,"li",null,"listLink",null);
+                  theDateListItem.appendChild(createTiddlyLink(place,tiddler.title,true));
+                  }
+                  }
+          }
+
+          else
+              {
+              window.old_timeline_handler.apply(this,arguments);
+              }
+}
+//}}}
+
+
+
Background: #fff
+Foreground: #000
+PrimaryPale: #aaa
+PrimaryLight: #f00
+PrimaryMid: #400
+PrimaryDark: #000
+SecondaryPale: #ffc
+SecondaryLight: #fe8
+SecondaryMid: #db4
+SecondaryDark: #841
+TertiaryPale: #eee
+TertiaryLight: #ccc
+TertiaryMid: #999
+TertiaryDark: #666
+Error: #f88
+
+
+
[[Overview]]
+
+
+
/***
+|Name|FullScreenPlugin|
+|Created by|SaqImtiaz|
+|Location|http://tw.lewcid.org/#FullScreenPlugin|
+|Version|1.1|
+|Requires|~TW2.x|
+!Description:
+Toggle between viewing tiddlers fullscreen and normally. Very handy for when you need more viewing space.
+
+!Demo:
+Click the ↕ button in the toolbar for this tiddler. Click it again to turn off fullscreen.
+
+!Installation:
+Copy the contents of this tiddler to your TW, tag with systemConfig, save and reload your TW.
+Edit the ViewTemplate to add the fullscreen command to the toolbar.
+
+!History:
+*25-07-06: ver 1.1
+*20-07-06: ver 1.0
+
+!Code
+***/
+//{{{
+var lewcidFullScreen = false;
+
+config.commands.fullscreen =
+{
+            text:" ↕ ",
+            tooltip:"Fullscreen mode"
+};
+
+config.commands.fullscreen.handler = function (event,src,title)
+{
+            if (lewcidFullScreen == false)
+               {
+                lewcidFullScreen = true;
+                setStylesheet('#sidebar, .header, #mainMenu{display:none;} #displayArea{margin:0em 0 0 0 !important;}',"lewcidFullScreenStyle");
+               }
+            else
+               {
+                lewcidFullScreen = false;
+                setStylesheet(' ',"lewcidFullScreenStyle");
+               }
+}
+
+config.macros.fullscreen={};
+config.macros.fullscreen.handler =  function(place,macroName,params,wikifier,paramString,tiddler)
+{
+        var label = params[0]||" ↕ ";
+        var tooltip = params[1]||"Fullscreen mode";
+        createTiddlyButton(place,label,tooltip,config.commands.fullscreen.handler);
+}
+
+var lewcid_fullscreen_closeTiddler = Story.prototype.closeTiddler;
+Story.prototype.closeTiddler =function(title,animate,slowly)
+{
+           lewcid_fullscreen_closeTiddler.apply(this,arguments);
+           if (story.isEmpty() && lewcidFullScreen == true)
+              config.commands.fullscreen.handler();
+}
+
+
+Slider.prototype.lewcidStop = Slider.prototype.stop;
+Slider.prototype.stop = function()
+{
+           this.lewcidStop();
+           if (story.isEmpty() && lewcidFullScreen == true)
+              config.commands.fullscreen.handler();
+}
+//}}}
+
+
+
/***
+''InlineJavascriptPlugin for ~TiddlyWiki version 1.2.x and 2.0''
+^^author: Eric Shulman - ELS Design Studios
+source: http://www.TiddlyTools.com/#InlineJavascriptPlugin
+license: [[Creative Commons Attribution-ShareAlike 2.5 License|http://creativecommons.org/licenses/by-sa/2.5/]]^^
+
+Insert Javascript executable code directly into your tiddler content. Lets you ''call directly into TW core utility routines, define new functions, calculate values, add dynamically-generated TiddlyWiki-formatted output'' into tiddler content, or perform any other programmatic actions each time the tiddler is rendered.
+!!!!!Usage
+<<<
+When installed, this plugin adds new wiki syntax for surrounding tiddler content with {{{<script>}}} and {{{</script>}}} markers, so that it can be treated as embedded javascript and executed each time the tiddler is rendered.
+
+''Deferred execution from an 'onClick' link''
+By including a label="..." parameter in the initial {{{<script>}}} marker, the plugin will create a link to an 'onclick' script that will only be executed when that specific link is clicked, rather than running the script each time the tiddler is rendered.
+
+''External script source files:''
+You can also load javascript from an external source URL, by including a src="..." parameter in the initial {{{<script>}}} marker (e.g., {{{<script src="demo.js"></script>}}}). This is particularly useful when incorporating third-party javascript libraries for use in custom extensions and plugins. The 'foreign' javascript code remains isolated in a separate file that can be easily replaced whenever an updated library file becomes available.
+
+''Defining javascript functions and libraries:''
+Although the external javascript file is loaded while the tiddler content is being rendered, any functions it defines will not be available for use until //after// the rendering has been completed. Thus, you cannot load a library and //immediately// use it's functions within the same tiddler. However, once that tiddler has been loaded, the library functions can be freely used in any tiddler (even the one in which it was initially loaded).
+
+To ensure that your javascript functions are always available when needed, you should load the libraries from a tiddler that will be rendered as soon as your TiddlyWiki document is opened. For example, you could put your {{{<script src="..."></script>}}} syntax into a tiddler called LoadScripts, and then add {{{<<tiddler LoadScripts>>}}} in your MainMenu tiddler.
+
+Since the MainMenu is always rendered immediately upon opening your document, the library will always be loaded before any other tiddlers that rely upon the functions it defines. Loading an external javascript library does not produce any direct output in the tiddler, so these definitions should have no impact on the appearance of your MainMenu.
+
+''Creating dynamic tiddler content''
+An important difference between this implementation of embedded scripting and conventional embedded javascript techniques for web pages is the method used to produce output that is dynamically inserted into the document:
+* In a typical web document, you use the document.write() function to output text sequences (often containing HTML tags) that are then rendered when the entire document is first loaded into the browser window.
+* However, in a ~TiddlyWiki document, tiddlers (and other DOM elements) are created, deleted, and rendered "on-the-fly", so writing directly to the global 'document' object does not produce the results you want (i.e., replacing the embedded script within the tiddler content), and completely replaces the entire ~TiddlyWiki document in your browser window.
+* To allow these scripts to work unmodified, the plugin automatically converts all occurences of document.write() so that the output is inserted into the tiddler content instead of replacing the entire ~TiddlyWiki document.
+
+If your script does not use document.write() to create dynamically embedded content within a tiddler, your javascript can, as an alternative, explicitly return a text value that the plugin can then pass through the wikify() rendering engine to insert into the tiddler display. For example, using {{{return "thistext"}}} will produce the same output as {{{document.write("thistext")}}}.
+
+//Note: your script code is automatically 'wrapped' inside a function, {{{_out()}}}, so that any return value you provide can be correctly handled by the plugin and inserted into the tiddler. To avoid unpredictable results (and possibly fatal execution errors), this function should never be redefined or called from ''within'' your script code.//
+
+''Accessing the ~TiddlyWiki DOM''
+The plugin provides one pre-defined variable, 'place', that is passed in to your javascript code so that it can have direct access to the containing DOM element into which the tiddler output is currently being rendered.
+
+Access to this DOM element allows you to create scripts that can:
+* vary their actions based upon the specific location in which they are embedded
+* access 'tiddler-relative' information (use findContainingTiddler(place))
+* perform direct DOM manipulations (when returning wikified text is not enough)
+<<<
+!!!!!Examples
+<<<
+an "alert" message box:
+{{{
+<script>alert('InlineJavascriptPlugin: this is a demonstration message');</script>
+}}}
+<script>alert('InlineJavascriptPlugin: this is a demonstration message');</script>
+
+dynamic output:
+{{{
+<script>return (new Date()).toString();</script>
+}}}
+<script>return (new Date()).toString();</script>
+
+wikified dynamic output:
+{{{
+<script>return "link to current user: [["+config.options.txtUserName+"]]";</script>
+}}}
+<script>return "link to current user: [["+config.options.txtUserName+"]]";</script>
+
+dynamic output using 'place' to get size information for current tiddler
+{{{
+<script>
+ if (!window.story) window.story=window;
+ var title=story.findContainingTiddler(place).id.substr(7);
+ return title+" is using "+store.getTiddlerText(title).length+" bytes";
+</script>
+}}}
+<script>
+ if (!window.story) window.story=window;
+ var title=story.findContainingTiddler(place).id.substr(7);
+ return title+" is using "+store.getTiddlerText(title).length+" bytes";
+</script>
+
+creating an 'onclick' button/link that runs a script
+{{{
+<script label="click here">
+ if (!window.story) window.story=window;
+ alert("Hello World!\nlinktext='"+place.firstChild.data+"'\ntiddler='"+story.findContainingTiddler(place).id.substr(7)+"'");
+</script>
+}}}
+<script label="click here">
+ if (!window.story) window.story=window;
+ alert("Hello World!\nlinktext='"+place.firstChild.data+"'\ntiddler='"+story.findContainingTiddler(place).id.substr(7)+"'");
+</script>
+
+loading a script from a source url
+{{{
+<script src="demo.js">return "loading demo.js..."</script>
+<script label="click to execute demo() function">demo()</script>
+}}}
+where http://www.TiddlyTools.com/demo.js contains:
+>function demo() { alert('this output is from demo(), defined in demo.js') }
+>alert('InlineJavascriptPlugin: demo.js has been loaded');
+<script src="demo.js">return "loading demo.js..."</script>
+<script label="click to execute demo() function">demo()</script>
+<<<
+!!!!!Installation
+<<<
+import (or copy/paste) the following tiddlers into your document:
+''InlineJavascriptPlugin'' (tagged with <<tag systemConfig>>)
+<<<
+!!!!!Revision History
+<<<
+''2006.01.05 [1.4.0]''
+added support 'onclick' scripts. When label="..." param is present, a button/link is created using the indicated label text, and the script is only executed when the button/link is clicked. 'place' value is set to match the clicked button/link element.
+''2005.12.13 [1.3.1]''
+when catching eval error in IE, e.description contains the error text, instead of e.toString(). Fixed error reporting so IE shows the correct response text. Based on a suggestion by UdoBorkowski
+''2005.11.09 [1.3.0]''
+for 'inline' scripts (i.e., not scripts loaded with src="..."), automatically replace calls to 'document.write()' with 'place.innerHTML+=' so script output is directed into tiddler content
+Based on a suggestion by BradleyMeck
+''2005.11.08 [1.2.0]''
+handle loading of javascript from an external URL via src="..." syntax
+''2005.11.08 [1.1.0]''
+pass 'place' param into scripts to provide direct DOM access 
+''2005.11.08 [1.0.0]''
+initial release
+<<<
+!!!!!Credits
+<<<
+This feature was developed by EricShulman from [[ELS Design Studios|http:/www.elsdesign.com]]
+<<<
+!!!!!Code
+***/
+//{{{
+version.extensions.inlineJavascript= {major: 1, minor: 4, revision: 0, date: new Date(2006,1,5)};
+
+config.formatters.push( {
+ name: "inlineJavascript",
+ match: "\\<script",
+ lookahead: "\\<script(?: src=\\\"((?:.|\\n)*?)\\\")?(?: label=\\\"((?:.|\\n)*?)\\\")?\\>((?:.|\\n)*?)\\</script\\>",
+
+ handler: function(w) {
+ var lookaheadRegExp = new RegExp(this.lookahead,"mg");
+ lookaheadRegExp.lastIndex = w.matchStart;
+ var lookaheadMatch = lookaheadRegExp.exec(w.source)
+ if(lookaheadMatch && lookaheadMatch.index == w.matchStart) {
+ if (lookaheadMatch[1]) { // load a script library
+ // make script tag, set src, add to body to execute, then remove for cleanup
+ var script = document.createElement("script"); script.src = lookaheadMatch[1];
+ document.body.appendChild(script); document.body.removeChild(script);
+ }
+ if (lookaheadMatch[2] && lookaheadMatch[3]) { // create a link to an 'onclick' script
+ // add a link, define click handler, save code in link (pass 'place'), set link attributes
+ var link=createTiddlyElement(w.output,"a",null,"tiddlyLinkExisting",lookaheadMatch[2]);
+ link.onclick=function(){try{return(eval(this.code))}catch(e){alert(e.description?e.description:e.toString())}}
+ link.code="function _out(place){"+lookaheadMatch[3]+"};_out(this);"
+ link.setAttribute("href","javascript:;"); link.setAttribute("title",""); link.style.cursor="pointer";
+ }
+ else if (lookaheadMatch[3]) { // run inline script code
+ var code="function _out(place){"+lookaheadMatch[3]+"};_out(w.output);"
+ code=code.replace(/document.write\(/gi,'place.innerHTML+=(');
+ try { var out = eval(code); } catch(e) { out = e.description?e.description:e.toString(); }
+ if (out && out.length) wikify(out,w.output);
+ }
+ w.nextMatch = lookaheadMatch.index + lookaheadMatch[0].length;
+ }
+ }
+} )
+//}}}
+
+
+
+
/***
+|''Name:''|InlineJavascriptPlugin|
+|''Source:''|http://www.TiddlyTools.com/#InlineJavascriptPlugin|
+|''Author:''|Eric Shulman - ELS Design Studios|
+|''License:''|[[Creative Commons Attribution-ShareAlike 2.5 License|http://creativecommons.org/licenses/by-sa/2.5/]]|
+|''~CoreVersion:''|2.0.10|
+
+Insert Javascript executable code directly into your tiddler content. Lets you ''call directly into TW core utility routines, define new functions, calculate values, add dynamically-generated TiddlyWiki-formatted output'' into tiddler content, or perform any other programmatic actions each time the tiddler is rendered.
+!!!!!Usage
+<<<
+When installed, this plugin adds new wiki syntax for surrounding tiddler content with {{{<script>}}} and {{{</script>}}} markers, so that it can be treated as embedded javascript and executed each time the tiddler is rendered.
+
+''Deferred execution from an 'onClick' link''
+By including a label="..." parameter in the initial {{{<script>}}} marker, the plugin will create a link to an 'onclick' script that will only be executed when that specific link is clicked, rather than running the script each time the tiddler is rendered.
+
+''External script source files:''
+You can also load javascript from an external source URL, by including a src="..." parameter in the initial {{{<script>}}} marker (e.g., {{{<script src="demo.js"></script>}}}). This is particularly useful when incorporating third-party javascript libraries for use in custom extensions and plugins. The 'foreign' javascript code remains isolated in a separate file that can be easily replaced whenever an updated library file becomes available.
+
+''Display script source in tiddler output''
+By including the keyword parameter "show", in the initial {{{<script>}}} marker, the plugin will include the script source code in the output that it displays in the tiddler.
+
+''Defining javascript functions and libraries:''
+Although the external javascript file is loaded while the tiddler content is being rendered, any functions it defines will not be available for use until //after// the rendering has been completed. Thus, you cannot load a library and //immediately// use it's functions within the same tiddler. However, once that tiddler has been loaded, the library functions can be freely used in any tiddler (even the one in which it was initially loaded).
+
+To ensure that your javascript functions are always available when needed, you should load the libraries from a tiddler that will be rendered as soon as your TiddlyWiki document is opened. For example, you could put your {{{<script src="..."></script>}}} syntax into a tiddler called LoadScripts, and then add {{{<<tiddler LoadScripts>>}}} in your MainMenu tiddler.
+
+Since the MainMenu is always rendered immediately upon opening your document, the library will always be loaded before any other tiddlers that rely upon the functions it defines. Loading an external javascript library does not produce any direct output in the tiddler, so these definitions should have no impact on the appearance of your MainMenu.
+
+''Creating dynamic tiddler content''
+An important difference between this implementation of embedded scripting and conventional embedded javascript techniques for web pages is the method used to produce output that is dynamically inserted into the document:
+* In a typical web document, you use the document.write() function to output text sequences (often containing HTML tags) that are then rendered when the entire document is first loaded into the browser window.
+* However, in a ~TiddlyWiki document, tiddlers (and other DOM elements) are created, deleted, and rendered "on-the-fly", so writing directly to the global 'document' object does not produce the results you want (i.e., replacing the embedded script within the tiddler content), and completely replaces the entire ~TiddlyWiki document in your browser window.
+* To allow these scripts to work unmodified, the plugin automatically converts all occurences of document.write() so that the output is inserted into the tiddler content instead of replacing the entire ~TiddlyWiki document.
+
+If your script does not use document.write() to create dynamically embedded content within a tiddler, your javascript can, as an alternative, explicitly return a text value that the plugin can then pass through the wikify() rendering engine to insert into the tiddler display. For example, using {{{return "thistext"}}} will produce the same output as {{{document.write("thistext")}}}.
+
+//Note: your script code is automatically 'wrapped' inside a function, {{{_out()}}}, so that any return value you provide can be correctly handled by the plugin and inserted into the tiddler. To avoid unpredictable results (and possibly fatal execution errors), this function should never be redefined or called from ''within'' your script code.//
+
+''Accessing the ~TiddlyWiki DOM''
+The plugin provides one pre-defined variable, 'place', that is passed in to your javascript code so that it can have direct access to the containing DOM element into which the tiddler output is currently being rendered.
+
+Access to this DOM element allows you to create scripts that can:
+* vary their actions based upon the specific location in which they are embedded
+* access 'tiddler-relative' information (use findContainingTiddler(place))
+* perform direct DOM manipulations (when returning wikified text is not enough)
+<<<
+!!!!!Examples
+<<<
+an "alert" message box:
+><script show>
+ alert('InlineJavascriptPlugin: this is a demonstration message');
+</script>
+dynamic output:
+><script show>
+ return (new Date()).toString();
+</script>
+wikified dynamic output:
+><script show>
+ return "link to current user: [["+config.options.txtUserName+"]]";
+</script>
+dynamic output using 'place' to get size information for current tiddler:
+><script show>
+ if (!window.story) window.story=window;
+ var title=story.findContainingTiddler(place).id.substr(7);
+ return title+" is using "+store.getTiddlerText(title).length+" bytes";
+</script>
+creating an 'onclick' button/link that runs a script:
+><script label="click here" show>
+ if (!window.story) window.story=window;
+ alert("Hello World!\nlinktext='"+place.firstChild.data+"'\ntiddler='"+story.findContainingTiddler(place).id.substr(7)+"'");
+</script>
+loading a script from a source url:
+>http://www.TiddlyTools.com/demo.js contains:
+>>{{{function demo() { alert('this output is from demo(), defined in demo.js') } }}}
+>>{{{alert('InlineJavascriptPlugin: demo.js has been loaded'); }}}
+><script src="demo.js" show>
+ return "loading demo.js..."
+</script>
+><script label="click to execute demo() function" show>
+ demo()
+</script>
+<<<
+!!!!!Installation
+<<<
+import (or copy/paste) the following tiddlers into your document:
+''InlineJavascriptPlugin'' (tagged with <<tag systemConfig>>)
+<<<
+!!!!!Revision History
+<<<
+''2006.06.01 [1.5.1]'' when calling wikify() on script return value, pass hightlightRegExp and tiddler params so macros that rely on these values can render properly
+''2006.04.19 [1.5.0]'' added 'show' parameter to force display of javascript source code in tiddler output
+''2006.01.05 [1.4.0]'' added support 'onclick' scripts. When label="..." param is present, a button/link is created using the indicated label text, and the script is only executed when the button/link is clicked. 'place' value is set to match the clicked button/link element.
+''2005.12.13 [1.3.1]'' when catching eval error in IE, e.description contains the error text, instead of e.toString(). Fixed error reporting so IE shows the correct response text. Based on a suggestion by UdoBorkowski
+''2005.11.09 [1.3.0]'' for 'inline' scripts (i.e., not scripts loaded with src="..."), automatically replace calls to 'document.write()' with 'place.innerHTML+=' so script output is directed into tiddler content. Based on a suggestion by BradleyMeck
+''2005.11.08 [1.2.0]'' handle loading of javascript from an external URL via src="..." syntax
+''2005.11.08 [1.1.0]'' pass 'place' param into scripts to provide direct DOM access 
+''2005.11.08 [1.0.0]'' initial release
+<<<
+!!!!!Credits
+<<<
+This feature was developed by EricShulman from [[ELS Design Studios|http:/www.elsdesign.com]]
+<<<
+!!!!!Code
+***/
+//{{{
+version.extensions.inlineJavascript= {major: 1, minor: 5, revision: 1, date: new Date(2006,6,1)};
+
+config.formatters.push( {
+ name: "inlineJavascript",
+ match: "\\<script",
+ lookahead: "\\<script(?: src=\\\"((?:.|\\n)*?)\\\")?(?: label=\\\"((?:.|\\n)*?)\\\")?( show)?\\>((?:.|\\n)*?)\\</script\\>",
+
+ handler: function(w) {
+ var lookaheadRegExp = new RegExp(this.lookahead,"mg");
+ lookaheadRegExp.lastIndex = w.matchStart;
+ var lookaheadMatch = lookaheadRegExp.exec(w.source)
+ if(lookaheadMatch && lookaheadMatch.index == w.matchStart) {
+ if (lookaheadMatch[1]) { // load a script library
+ // make script tag, set src, add to body to execute, then remove for cleanup
+ var script = document.createElement("script"); script.src = lookaheadMatch[1];
+ document.body.appendChild(script); document.body.removeChild(script);
+ }
+ if (lookaheadMatch[4]) { // there is script code
+ if (lookaheadMatch[3]) // show inline script code in tiddler output
+ wikify("{{{\n"+lookaheadMatch[0]+"\n}}}\n",w.output);
+ if (lookaheadMatch[2]) { // create a link to an 'onclick' script
+ // add a link, define click handler, save code in link (pass 'place'), set link attributes
+ var link=createTiddlyElement(w.output,"a",null,"tiddlyLinkExisting",lookaheadMatch[2]);
+ link.onclick=function(){try{return(eval(this.code))}catch(e){alert(e.description?e.description:e.toString())}}
+ link.code="function _out(place){"+lookaheadMatch[4]+"};_out(this);"
+ link.setAttribute("href","javascript:;"); link.setAttribute("title",""); link.style.cursor="pointer";
+ }
+ else { // run inline script code
+ var code="function _out(place){"+lookaheadMatch[4]+"};_out(w.output);"
+ code=code.replace(/document.write\(/gi,'place.innerHTML+=(');
+ try { var out = eval(code); } catch(e) { out = e.description?e.description:e.toString(); }
+ if (out && out.length) wikify(out,w.output,w.highlightRegExp,w.tiddler);
+ }
+ }
+ w.nextMatch = lookaheadMatch.index + lookaheadMatch[0].length;
+ }
+ }
+} )
+//}}}
+
+
+
''[[Lumiera|index.html]]''
+RoadMap
+ToDo
+[[Tasks]]
+[[Admin]]
+<<fullscreen>>
+
+
+
<!--{{{-->
+<link rel='alternate' type='application/rss+xml' title='RSS' href='index.xml'/>
+<!--}}}-->
+
+<style type="text/css">#contentWrapper {display:none;}</style><div id="SplashScreen" style="border: 3px solid #ccc; display: block; text-align: center; width: 320px; margin: 100px auto; padding: 50px; color:#000; font-size: 28px; font-family:Tahoma; background-color:#eee;"><b>My TiddlyWiki</b> is loading<blink> ...</blink><br><br><span style="font-size: 14px; color:red;">Requires Javascript.</span></div>
+
+
+
Here we describe the things which are planned and going on.
+
+There is:
+ * A RoadMap which gives a coarse overview of the project.
+ * A ToDo list, showing whats left to be done on a intermediate to high level
+ * A list of detailed [[Tasks]] which are imminent to do.
+
+The goal of this wiki is not to track each and every task, but show whats going on and where possible contributors can pick a job.
+
+
+
+
+
+
<!--{{{-->
+<div class='header' macro='gradient vert [[ColorPalette::PrimaryLight]] [[ColorPalette::PrimaryMid]]'>
+	<div class='headerShadow'>
+		<span class='siteTitle' refresh='content' tiddler='SiteTitle'></span>&nbsp;
+		<span class='siteSubtitle' refresh='content' tiddler='SiteSubtitle'></span>
+	</div>
+	<div class='headerForeground'>
+		<span class='siteTitle' refresh='content' tiddler='SiteTitle'></span>&nbsp;
+		<span class='siteSubtitle' refresh='content' tiddler='SiteSubtitle'></span>
+	</div>
+</div>
+<!-- horizontal MainMenu -->
+<div id='topMenu' refresh='content' tiddler='MainMenu'></div>
+<!-- original MainMenu menu -->
+<!-- <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>
+<!--}}}-->
+
+
+
+
/***
+|<html><a name="Top"/></html>''Name:''|PartTiddlerPlugin|
+|''Version:''|1.0.6 (2006-11-07)|
+|''Source:''|http://tiddlywiki.abego-software.de/#PartTiddlerPlugin|
+|''Author:''|UdoBorkowski (ub [at] abego-software [dot] de)|
+|''Licence:''|[[BSD open source license]]|
+|''TiddlyWiki:''|2.0|
+|''Browser:''|Firefox 1.0.4+; InternetExplorer 6.0|
+!Table of Content<html><a name="TOC"/></html>
+* <html><a href="javascript:;" onclick="window.scrollAnchorVisible('Description',null, event)">Description, Syntax</a></html>
+* <html><a href="javascript:;" onclick="window.scrollAnchorVisible('Applications',null, event)">Applications</a></html>
+** <html><a href="javascript:;" onclick="window.scrollAnchorVisible('LongTiddler',null, event)">Refering to Paragraphs of a Longer Tiddler</a></html>
+** <html><a href="javascript:;" onclick="window.scrollAnchorVisible('Citation',null, event)">Citation Index</a></html>
+** <html><a href="javascript:;" onclick="window.scrollAnchorVisible('TableCells',null, event)">Creating "multi-line" Table Cells</a></html>
+** <html><a href="javascript:;" onclick="window.scrollAnchorVisible('Tabs',null, event)">Creating Tabs</a></html>
+** <html><a href="javascript:;" onclick="window.scrollAnchorVisible('Sliders',null, event)">Using Sliders</a></html>
+* <html><a href="javascript:;" onclick="window.scrollAnchorVisible('Revisions',null, event)">Revision History</a></html>
+* <html><a href="javascript:;" onclick="window.scrollAnchorVisible('Code',null, event)">Code</a></html>
+!Description<html><a name="Description"/></html>
+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, 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//.|
+|''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.|
+|<html><i>any&nbsp;tiddler&nbsp;content</i></html>|<html>The content of the part.<br>A part can have any content that a "normal" tiddler may have, e.g. you may use all the formattings and macros defined.</html>|
+|>|~~Syntax formatting: Keywords in ''bold'', optional parts in [...]. 'or' means that exactly one of the two alternatives must exist.~~|
+<html><sub><a href="javascript:;" onclick="window.scrollAnchorVisible('Top',null, event)">[Top]</sub></a></html>
+
+!Applications<html><a name="Applications"/></html>
+!!Refering to Paragraphs of a Longer Tiddler<html><a name="LongTiddler"/></html>
+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.
+
+<html><sub><a href="javascript:;" onclick="window.scrollAnchorVisible('Top',null, event)">[Top]</sub></a></html>
+
+!!Citation Index<html><a name="Citation"/></html>
+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]]}}}.
+
+<html><sub><a href="javascript:;" onclick="window.scrollAnchorVisible('Top',null, event)">[Top]</sub></a></html>
+
+!!Creating "multi-line" Table Cells<html><a name="TableCells"/></html>
+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.
+
+<html><sub><a href="javascript:;" onclick="window.scrollAnchorVisible('Top',null, event)">[Top]</sub></a></html>
+
+!!Creating Tabs<html><a name="Tabs"/></html>
+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:
+* SideBarTabs
+* TabAll
+* TabMore
+* TabMoreMissing
+* TabMoreOrphans
+* TabMoreShadowed
+* TabTags
+* TabTimeline
+
+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":""'>>
+}}}
+<html><sub><a href="javascript:;" onclick="window.scrollAnchorVisible('Top',null, event)">[Top]</sub></a></html>
+
+!!Using Sliders<html><a name="Sliders"/></html>
+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.
+
+<html><sub><a href="javascript:;" onclick="window.scrollAnchorVisible('Top',null, event)">[Top]</sub></a></html>
+
+!Revision history<html><a name="Revisions"/></html>
+* 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
+<html><sub><a href="javascript:;" onclick="window.scrollAnchorVisible('Top',null, event)">[Top]</sub></a></html>
+
+!Code<html><a name="Code"/></html>
+<html><sub><a href="javascript:;" onclick="window.scrollAnchorVisible('Top',null, event)">[Top]</sub></a></html>
+***/
+//{{{
+//============================================================================
+// PartTiddlerPlugin
+
+// Ensure that the PartTiddler Plugin is only installed once.
+//
+if (!version.extensions.PartTiddlerPlugin) {
+
+
+
+version.extensions.PartTiddlerPlugin = {
+ major: 1, minor: 0, revision: 6,
+ date: new Date(2006, 10, 7), 
+ 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[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 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 == ".") 
+ ? currentParent 
+ : oldFetchTiddler.apply(this, [parentName]);
+ if (parent) {
+ return getPart(parent, partName, parent.title+"/"+partName);
+ }
+ }
+ }
+ return result; 
+};
+
+
+// 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 = 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)
+ {
+ clearMessage();
+ story.displayTiddler(null,title,DEFAULT_EDIT_TEMPLATE);
+ story.focusTiddler(title,"text");
+ 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;
+
+// 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"
+//}}}
+
+/***
+<html><sub><a href="javascript:;" onclick="scrollAnchorVisible('Top',null, event)">[Top]</sub></a></html>
+
+!Licence and Copyright
+Copyright (c) abego Software ~GmbH, 2006 ([[www.abego-software.de|http://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.
+
+<html><sub><a href="javascript:;" onclick="scrollAnchorVisible('Top',null, event)">[Top]</sub></a></html>
+***/
+
+
+
/***
+|''Name:''|RSSReaderPlugin|
+|''Description:''|This plugin provides a RSSReader for TiddlyWiki|
+|''Version:''|1.1.1|
+|''Date:''|Apr 21, 2007|
+|''Source:''|http://tiddlywiki.bidix.info/#RSSReaderPlugin|
+|''Documentation:''|http://tiddlywiki.bidix.info/#RSSReaderPluginDoc|
+|''Author:''|BidiX (BidiX (at) bidix (dot) info)|
+|''Credit:''|BramChen for RssNewsMacro|
+|''License:''|[[BSD open source license|http://tiddlywiki.bidix.info/#%5B%5BBSD%20open%20source%20license%5D%5D ]]|
+|''~CoreVersion:''|2.2.0|
+|''OptionalRequires:''|http://www.tiddlytools.com/#NestedSlidersPlugin|
+***/
+//{{{
+version.extensions.RSSReaderPlugin = {
+	major: 1, minor: 1, revision: 1,
+	date: new Date("Apr 21, 2007"),
+	source: "http://TiddlyWiki.bidix.info/#RSSReaderPlugin",
+	author: "BidiX",
+	coreVersion: '2.2.0'
+};
+
+config.macros.rssReader = {
+	dateFormat: "DDD, DD MMM YYYY",
+	itemStyle: "display: block;border: 1px solid black;padding: 5px;margin: 5px;", //useed  '@@'+itemStyle+itemText+'@@'
+	msg:{
+		permissionDenied: "Permission to read preferences was denied.",
+		noRSSFeed: "No RSS Feed at this address %0",
+		urlNotAccessible: " Access to %0 is not allowed"
+	},
+	cache: [], 	// url => XMLHttpRequest.responseXML
+	desc: "noDesc",
+	
+	handler: function(place,macroName,params,wikifier,paramString,tiddler) {
+		var desc = params[0];
+		var feedURL = params[1];
+		var toFilter = (params[2] ? true : false);
+		var filterString = (toFilter?(params[2].substr(0,1) == ' '? tiddler.title:params[2]):'');
+		var place = createTiddlyElement(place, "div", "RSSReader");
+		wikify("^^<<rssFeedUpdate "+feedURL+" [[" + tiddler.title + "]]>>^^\n",place);
+		if (this.cache[feedURL]) {
+			this.displayRssFeed(this.cache[feedURL], feedURL, place, desc, toFilter, filterString);
+		}
+		else {
+			var r = loadRemoteFile(feedURL,config.macros.rssReader.processResponse, [place, desc, toFilter, filterString]);
+			if (typeof r == "string")
+				displayMessage(r);
+		}
+		
+	},
+
+	// callback for loadRemoteFile 
+	// params : [place, desc, toFilter, filterString]
+	processResponse: function(status, params, responseText, url, xhr) { // feedURL, place, desc, toFilter, filterString) {	
+		if (window.netscape){
+			try {
+				if (document.location.protocol.indexOf("http") == -1) {
+					netscape.security.PrivilegeManager.enablePrivilege("UniversalBrowserRead");
+				}
+			}
+			catch (e) { displayMessage(e.description?e.description:e.toString()); }
+		}
+		if (xhr.status == httpStatus.NotFound)
+		 {
+			displayMessage(config.macros.rssReader.noRSSFeed.format([url]));
+			return;
+		}
+		if (!status)
+		 {
+			displayMessage(config.macros.rssReader.noRSSFeed.format([url]));
+			return;
+		}
+		if (xhr.responseXML) {
+			// response is interpreted as XML
+			config.macros.rssReader.cache[url] = xhr.responseXML;
+			config.macros.rssReader.displayRssFeed(xhr.responseXML, params[0], url, params[1], params[2], params[3]);
+		}
+		else {
+			if (responseText.substr(0,5) == "<?xml") {
+				// response exists but not return as XML -> try to parse it 
+				var dom = (new DOMParser()).parseFromString(responseText, "text/xml"); 
+				if (dom) {
+					// parsing successful so use it
+					config.macros.rssReader.cache[url] = dom;
+					config.macros.rssReader.displayRssFeed(dom, params[0], url, params[1], params[2], params[3]);
+					return;
+				}
+			}
+			// no XML display as html 
+			wikify("<html>" + responseText + "</html>", params[0]);
+			displayMessage(config.macros.rssReader.msg.noRSSFeed.format([url]));
+		}
+	},
+
+	// explore down the DOM tree
+	displayRssFeed: function(xml, place, feedURL, desc, toFilter, filterString){
+		// Channel
+		var chanelNode = xml.getElementsByTagName('channel').item(0);
+		var chanelTitleElement = (chanelNode ? chanelNode.getElementsByTagName('title').item(0) : null);
+		var chanelTitle = "";
+		if ((chanelTitleElement) && (chanelTitleElement.firstChild)) 
+			chanelTitle = chanelTitleElement.firstChild.nodeValue;
+		var chanelLinkElement = (chanelNode ? chanelNode.getElementsByTagName('link').item(0) : null);
+		var chanelLink = "";
+		if (chanelLinkElement) 
+			chanelLink = chanelLinkElement.firstChild.nodeValue;
+		var titleTxt = "!![["+chanelTitle+"|"+chanelLink+"]]\n";
+		var title = createTiddlyElement(place,"div",null,"ChanelTitle",null);
+		wikify(titleTxt,title);
+		// ItemList
+		var itemList = xml.getElementsByTagName('item');
+		var article = createTiddlyElement(place,"ul",null,null,null);
+		var lastDate;
+		var re;
+		if (toFilter) 
+			re = new RegExp(filterString.escapeRegExp());
+		for (var i=0; i<itemList.length; i++){
+			var titleElm = itemList[i].getElementsByTagName('title').item(0);
+			var titleText = (titleElm ? titleElm.firstChild.nodeValue : '');
+			if (toFilter && ! titleText.match(re)) {
+				continue;
+			}
+			var descText = '';
+			descElem = itemList[i].getElementsByTagName('description').item(0);
+			if (descElem){
+				try{
+					for (var ii=0; ii<descElem.childNodes.length; ii++) {
+						descText += descElem.childNodes[ii].nodeValue;
+					}
+				}
+				catch(e){}
+				descText = descText.replace(/<br \/>/g,'\n');
+				if (desc == "asHtml")
+					descText = "<html>"+descText+"</html>";
+			}
+			var linkElm = itemList[i].getElementsByTagName("link").item(0);
+			var linkURL = linkElm.firstChild.nodeValue;
+			var pubElm = itemList[i].getElementsByTagName('pubDate').item(0);
+			var pubDate;
+			if (!pubElm) {
+				pubElm = itemList[i].getElementsByTagName('date').item(0); // for del.icio.us
+				if (pubElm) {
+					pubDate = pubElm.firstChild.nodeValue;
+					pubDate = this.formatDateString(this.dateFormat, pubDate);
+					}
+					else {
+						pubDate = '0';
+					}
+				}
+			else {
+				pubDate = (pubElm ? pubElm.firstChild.nodeValue : 0);
+				pubDate = this.formatDate(this.dateFormat, pubDate);
+			}
+			titleText = titleText.replace(/\[|\]/g,'');
+			var rssText = '*'+'[[' + titleText + '|' + linkURL + ']]' + '' ;
+			if ((desc != "noDesc") && descText){
+				rssText = rssText.replace(/\n/g,' ');
+				descText = '@@'+this.itemStyle+descText + '@@\n';				
+				if (version.extensions.nestedSliders){
+					descText = '+++[...]' + descText + '===';
+				}
+				rssText = rssText + descText;
+			}
+			var story;
+			if ((lastDate != pubDate) && ( pubDate != '0')) {
+				story = createTiddlyElement(article,"li",null,"RSSItem",pubDate);
+				lastDate = pubDate;
+			}
+			else {
+				lastDate = pubDate;
+			}
+			story = createTiddlyElement(article,"div",null,"RSSItem",null);
+			wikify(rssText,story);
+		}
+	},
+	
+	formatDate: function(template, date){
+		var dateString = new Date(date);
+		// template = template.replace(/hh|mm|ss/g,'');
+		return dateString.formatString(template);
+	},
+	
+	formatDateString: function(template, date){
+		var dateString = new Date(date.substr(0,4), date.substr(5,2) - 1, date.substr(8,2)
+			);
+		return dateString.formatString(template);
+	}
+	
+};
+
+config.macros.rssFeedUpdate = {
+	label: "Update",
+	prompt: "Clear the cache and redisplay this RssFeed",
+	handler: function(place,macroName,params) {
+		var feedURL = params[0];
+		var tiddlerTitle = params[1];
+		createTiddlyButton(place, this.label, this.prompt, 
+			function () {
+				if (config.macros.rssReader.cache[feedURL]) {
+					config.macros.rssReader.cache[feedURL] = null; 
+			}
+			story.refreshTiddler(tiddlerTitle,null, true);
+		return false;});
+	}
+};
+
+//}}}
+
+
+
+
//last update: RSSReaderPlugin v 1.1.1//
+
+!Description
+This plugin provides a RSSReader for TiddlyWiki
+* It accesses asynchronously an RSSFeed
+*Depending on the chanel item format, each item could be written as :
+**simple text wikified
+**html
+
+!Usage
+{{{
+<<rssReader noDesc|asHtml|asText rssUrl ['filtering string']>>
+	noDesc: only title of item is printed
+
+	asHtml: if you know that description contain html (links, img ...), 
+		the text is enclosed with <html> </html> tags
+
+ 	asText: if the description should not be interpreted as html the 
+		description is wikified
+
+	rssUrl: the rssFeed url that could be accessed. 
+	
+	'filtering string': if present, the rssfeed item title must contained 
+		this string to be displayed. 
+		If 'filering string' contained space characters only, the tiddler 
+		title is used for filtering.
+
+}}}
+
+For security reasons, if the TiddlyWiki is accessed from http, a ProxyService should be used to access an rssFeed from an other site.
+
+!examples
+| !reader | !RSSFeed type | !working from |
+| BidiXTWRSS | Description asHtml | file: or tiddlywiki.bidix.info |
+| [[Le Monde]] | Description asText | file: or tiddlywiki.bidix.info using proxy |
+| YahooNewsSport | Description asHtml | file: or tiddlywiki.bidix.info using proxy |
+| TiddlyWikiRSS | Description asHtml | file: or tiddlywiki.bidix.info using proxy |
+| [[Libération]] | noDesc | file: or tiddlywiki.bidix.info using proxy |
+| [[TestComment]] | asText and filters | file: or tiddlywiki.bidix.info using proxy |
+see : <<tag RSSFeed>> for the full list.
+
+!Revision history
+* V1.1.0 (2207/04/13)
+**No more import functions
+* V1.0.0 (2006/11/11)
+**refactoring using core loadRemoteFile function
+**import using new tiddlywiki:tiddler element
+**import and presentation preserved without EricShulman's NestedSliderPlugin
+**better display of items 
+* v0.3.0 (24/08/2006)
+** Filter on RSS item title
+** Place to display redefined for asynchronous processing
+* v0.2.2 (22/08/2006)
+**Haloscan feed has no pubDate.
+* v0.2.1 (08/05/2006)
+* v0.2.0 (01/05/2006)
+**Small adapations for del.icio.us feed
+* v0.1.1 (28/04/2006)
+**Bug : Channel without title 
+* v0.1.0 (24/04/2006)
+** initial release
+
+
+
+
+
+
! Foundations, not really a milestone yet
+
+We need following in a basically working / mockup state:
+
+* Proc layer, basic rendering, partly mockups
+* Backend
+** File backend, caching
+** Serializer
+** Scheduler
+* Support Libary
+** Plugin Loader
+** Other tools there
+* Infrastructure
+** Testsuite
+** Website
+
+!! Next Goals
+
+# Make a [[video player mockup]]
+
+
+
Roadmap and tasks
+
+
+
ToDo
+
+
+
/***
+
+''Inspired by [[TiddlyPom|http://www.warwick.ac.uk/~tuspam/tiddlypom.html]]''
+
+|Name|SplashScreenPlugin|
+|Created by|SaqImtiaz|
+|Location|http://tw.lewcid.org/#SplashScreenPlugin|
+|Version|0.21 |
+|Requires|~TW2.08+|
+!Description:
+Provides a simple splash screen that is visible while the TW is loading.
+
+!Installation
+Copy the source text of this tiddler to your TW in a new tiddler, tag it with systemConfig and save and reload. The SplashScreen will now be installed and will be visible the next time you reload your TW.
+
+!Customizing
+Once the SplashScreen has been installed and you have reloaded your TW, the splash screen html will be present in the MarkupPreHead tiddler. You can edit it and customize to your needs.
+
+!History
+* 20-07-06 : version 0.21, modified to hide contentWrapper while SplashScreen is displayed.
+* 26-06-06 : version 0.2, first release
+
+!Code
+***/
+//{{{
+var old_lewcid_splash_restart=restart;
+
+restart = function()
+{   if (document.getElementById("SplashScreen"))
+        document.getElementById("SplashScreen").style.display = "none";
+      if (document.getElementById("contentWrapper"))
+        document.getElementById("contentWrapper").style.display = "block";
+    
+    old_lewcid_splash_restart();
+   
+    if (splashScreenInstall)
+       {if(config.options.chkAutoSave)
+			{saveChanges();}
+        displayMessage("TW SplashScreen has been installed, please save and refresh your TW.");
+        }
+}
+
+
+var oldText = store.getTiddlerText("MarkupPreHead");
+if (oldText.indexOf("SplashScreen")==-1)
+   {var siteTitle = store.getTiddlerText("SiteTitle");
+   var splasher='\n\n<style type="text/css">#contentWrapper {display:none;}</style><div id="SplashScreen" style="border: 3px solid #ccc; display: block; text-align: center; width: 320px; margin: 100px auto; padding: 50px; color:#000; font-size: 28px; font-family:Tahoma; background-color:#eee;"><b>'+siteTitle +'</b> is loading<blink> ...</blink><br><br><span style="font-size: 14px; color:red;">Requires Javascript.</span></div>';
+   if (! store.tiddlerExists("MarkupPreHead"))
+       {var myTiddler = store.createTiddler("MarkupPreHead");}
+   else
+      {var myTiddler = store.getTiddler("MarkupPreHead");}
+      myTiddler.set(myTiddler.title,oldText+splasher,config.options.txtUserName,null,null);
+      store.setDirty(true);
+      var splashScreenInstall = true;
+}
+//}}}
+
+
+
/*{{{*/
+/* a contrasting background so I can see where one tiddler ends and the other begins */
+body {
+	background: [[ColorPalette::TertiaryLight]];
+}
+
+/* sexy colours and font for the header */
+.headerForeground {
+	color: [[ColorPalette::PrimaryPale]];
+}
+.headerShadow, .headerShadow a {
+	color: [[ColorPalette::PrimaryMid]];
+}
+.headerForeground, .headerShadow {
+	padding: 1em 1em 0;
+	font-family: 'Trebuchet MS' sans-serif;
+	font-weight:bold;
+}
+.headerForeground .siteSubtitle {
+	color: [[ColorPalette::PrimaryLight]];
+}
+.headerShadow .siteSubtitle {
+	color: [[ColorPalette::PrimaryMid]];
+}
+
+/* make shadow go and down right instead of up and left */
+.headerShadow {
+	left: 2px;
+	top: 3px;
+}
+
+/* prefer monospace for editing */
+.editor textarea {
+	font-family: 'Consolas' monospace;
+}
+
+/* sexy tiddler titles */
+.title {
+	font-size: 250%;
+	color: [[ColorPalette::PrimaryLight]];
+	font-family: 'Trebuchet MS' sans-serif;
+}
+
+/* more subtle tiddler subtitle */
+.subtitle {
+	padding:0px;
+	margin:0px;
+	padding-left:0.5em;
+	font-size: 90%;
+	color: [[ColorPalette::TertiaryMid]];
+}
+.subtitle .tiddlyLink {
+	color: [[ColorPalette::TertiaryMid]];
+}
+
+/* a little bit of extra whitespace */
+.viewer {
+	padding-bottom:3px;
+}
+
+/* don't want any background color for headings */
+h1,h2,h3,h4,h5,h6 {
+	background: [[ColorPalette::Background]];
+	color: [[ColorPalette::Foreground]];
+}
+
+/* give tiddlers 3d style border and explicit background */
+.tiddler {
+	background: [[ColorPalette::Background]];
+	border-right: 2px [[ColorPalette::TertiaryMid]] solid;
+	border-bottom: 2px [[ColorPalette::TertiaryMid]] solid;
+	margin-bottom: 1em;
+	padding-bottom: 2em;
+}
+
+/* make options slider look nicer */
+#sidebarOptions .sliderPanel {
+	border:solid 1px [[ColorPalette::PrimaryLight]];
+}
+
+
+/* the borders look wrong with the body background */
+#sidebar .button {
+	border-style: none;
+}
+
+/* displays the list of a tiddler's tags horizontally. used in ViewTemplate */
+.tagglyTagged li.listTitle {
+	display:none
+}
+.tagglyTagged li {
+	display: inline; font-size:90%;
+}
+.tagglyTagged ul {
+	margin:0px; padding:0px;
+}
+
+/* this means you can put line breaks in SidebarOptions for readability */
+#sidebarOptions br {
+	display:none;
+}
+/* undo the above in OptionsPanel */
+#sidebarOptions .sliderPanel br {
+	display:inline;
+}
+
+/* horizontal main menu stuff */
+#displayArea {
+	margin: 1em 15.7em 0em 1em; /* use the freed up space */
+}
+#topMenu br {
+	display: none;
+}
+#topMenu {
+	background: [[ColorPalette::PrimaryMid]];
+	color:[[ColorPalette::PrimaryPale]];
+}
+#topMenu {
+	padding:2px;
+}
+#topMenu .button, #topMenu .tiddlyLink, #topMenu a {
+	margin-left: 0.5em;
+	margin-right: 0.5em;
+	padding-left: 3px;
+	padding-right: 3px;
+	color: [[ColorPalette::PrimaryPale]];
+	font-size: 115%;
+}
+#topMenu .button:hover, #topMenu .tiddlyLink:hover {
+	background: [[ColorPalette::PrimaryDark]];
+}
+
+/* make it print a little cleaner */
+@media print {
+	#topMenu {
+		display: none ! important;
+	}
+	/* not sure if we need all the importants */
+	.tiddler {
+		border-style: none ! important;
+		margin:0px ! important;
+		padding:0px ! important;
+		padding-bottom:2em ! important;
+	}
+	.tagglyTagging .button, .tagglyTagging .hidebutton {
+		display: none ! important;
+	}
+	.headerShadow {
+		visibility: hidden ! important;
+	}
+	.tagglyTagged .quickopentag, .tagged .quickopentag {
+		border-style: none ! important;
+	}
+	.quickopentag a.button, .miniTag {
+		display: none ! important;
+	}
+}
+/*}}}*/
+
+
+
+
<<timeline better:true maxDays:14 maxEntries:20>>
+
+
+
/***
+|Name|TaskMacroPlugin|
+|Author|<<extension TaskMacroPlugin author>>|
+|Location|<<extension TaskMacroPlugin source>>|
+|License|<<extension TaskMacroPlugin license>>|
+|Version|<<extension TaskMacroPlugin versionAndDate>>|
+!Description
+A set of macros to help you keep track of time estimates for tasks.
+
+Macros defined:
+* {{{task}}}: Displays a task description and makes it easy to estimate and track the time spent on the task.
+* {{{taskadder}}}: Displays text entry field to simplify the adding of tasks.
+* {{{tasksum}}}: Displays a summary of tasks sandwiched between two calls to this macro.
+* {{{extension}}}: A simple little macro that displays information about a TiddlyWiki plugin, and that will hopefully someday migrate to the TW core in some form.
+Core overrides:
+* {{{wikify}}}: when wikifying a tiddler's complete text, adds refresh information so the tiddler will be refreshed when it changes
+* {{{config.refreshers}}}: have the built-in refreshers return true; also, add a new refresher ("fullContent") that redisplays a full tiddler whenever it or any nested tiddlers it shows are changed
+* {{{refreshElements}}}: now checks the return value from the refresher and only short-circuits the recursion if the refresher returns true
+!Plugin Information
+***/
+//{{{
+version.extensions.TaskMacroPlugin = {
+	major: 1, minor: 1, revision: 0,
+	date: new Date(2006,5-1,13),
+	author: "LukeBlanshard",
+	source: "http://labwiki.sourceforge.net/#TaskMacroPlugin",
+	license: "http://labwiki.sourceforge.net/#CopyrightAndLicense"
+}
+//}}}
+/***
+A little macro for pulling out extension info.  Use like {{{<<extension PluginName datum>>}}}, where {{{PluginName}}} is the name you used for {{{version.extensions}}} and {{{datum}}} is either {{{versionAndDate}}} or a property of the extension description object, such as {{{source}}}.
+***/
+//{{{
+config.macros.extension = {
+	handler: function( place, macroName, params, wikifier, paramString, tiddler ) {
+		var info  = version.extensions[params[0]]
+		var datum = params[1]
+		switch (params[1]) {
+		case 'versionAndDate':
+			createTiddlyElement( place, "span", null, null,
+				info.major+'.'+info.minor+'.'+info.revision+', '+info.date.formatString('DD MMM YYYY') )
+			break;
+		default:
+			wikify( info[datum], place )
+			break;
+		}
+	}
+}
+//}}}
+/***
+!Core Overrides
+***/
+//{{{
+window.wikify_orig_TaskMacroPlugin = window.wikify
+window.wikify = function(source,output,highlightRegExp,tiddler)
+{
+	if ( tiddler && tiddler.text === source )
+		addDisplayDependency( output, tiddler.title )
+	wikify_orig_TaskMacroPlugin.apply( this, arguments )
+}
+config.refreshers_orig_TaskMacroPlugin = config.refreshers
+config.refreshers = {
+	link: function() {
+		config.refreshers_orig_TaskMacroPlugin.link.apply( this, arguments )
+		return true
+	},
+	content: function() {
+		config.refreshers_orig_TaskMacroPlugin.content.apply( this, arguments )
+		return true
+	},
+	fullContent: function( e, changeList ) {
+		var tiddlers = e.refreshTiddlers
+		if ( changeList == null || tiddlers == null )
+			return false
+		for ( var i=0; i < tiddlers.length; ++i )
+			if ( changeList.find(tiddlers[i]) != null ) {
+				var title = tiddlers[0]
+				story.refreshTiddler( title, null, true )
+				return true
+			}
+		return false
+	}
+}
+function refreshElements(root,changeList)
+{
+	var nodes = root.childNodes;
+	for(var c=0; c<nodes.length; c++)
+		{
+		var e = nodes[c],type;
+		if(e.getAttribute)
+			type = e.getAttribute("refresh");
+		else
+			type = null;
+		var refresher = config.refreshers[type];
+		if ( ! refresher || ! refresher(e, changeList) )
+			{
+			if(e.hasChildNodes())
+				refreshElements(e,changeList);
+			}
+		}
+}
+//}}}
+/***
+!Global Functions
+***/
+//{{{
+// Add the tiddler whose title is given to the list of tiddlers whose
+// changing will cause a refresh of the tiddler containing the given element.
+function addDisplayDependency( element, title ) {
+	while ( element && element.getAttribute ) {
+		var idAttr = element.getAttribute("id"), tiddlerAttr = element.getAttribute("tiddler")
+		if ( idAttr && tiddlerAttr && idAttr == story.idPrefix+tiddlerAttr ) {
+			var list = element.refreshTiddlers
+			if ( list == null ) {
+				list = [tiddlerAttr]
+				element.refreshTiddlers = list
+				element.setAttribute( "refresh", "fullContent" )
+			}
+			list.pushUnique( title )
+			return
+		}
+		element = element.parentNode
+	}
+}
+
+// Lifted from Story.prototype.focusTiddler: just return the field instead of focusing it.
+Story.prototype.findEditField = function( title, field )
+{
+	var tiddler = document.getElementById(this.idPrefix + title);
+	if(tiddler != null)
+		{
+		var children = tiddler.getElementsByTagName("*")
+		var e = null;
+		for (var t=0; t<children.length; t++)
+			{
+			var c = children[t];
+			if(c.tagName.toLowerCase() == "input" || c.tagName.toLowerCase() == "textarea")
+				{
+				if(!e)
+					e = c;
+				if(c.getAttribute("edit") == field)
+					e = c;
+				}
+			}
+		return e
+		}
+}
+
+// Wraps the given event function in another function that handles the
+// event in a standard way.
+function wrapEventHandler( otherHandler ) {
+	return function(e) {
+		if (!e) var e = window.event
+		e.cancelBubble = true
+		if (e.stopPropagation) e.stopPropagation()
+		return otherHandler( e )
+	}
+}
+//}}}
+/***
+!Task Macro
+Usage:
+> {{{<<task orig cur spent>>description}}}
+All of orig, cur, and spent are optional numbers of hours.  The description goes through the end of the line, and is wikified.
+***/
+//{{{
+config.macros.task = {
+	NASCENT:	0, // Task not yet estimated
+	LIVE:		1, // Estimated but with time remaining
+	DONE:		2, // Completed: no time remaining
+	bullets:	["\u25cb", // nascent (open circle)
+			 "\u25ba", // live (right arrow)
+			 "\u25a0"],// done (black square)
+	styles:		["nascent", "live", "done"],
+
+	// Translatable text:
+	lingo: {
+		spentTooBig:	"Spent time %0 can't exceed current estimate %1",
+		noNegative:	"Times may not be negative numbers",
+		statusTips:	["Not yet estimated", "To do", "Done"], // Array indexed by state (NASCENT/LIVE/DONE)
+		descClickTip:	" -- Double-click to edit task description",
+		statusClickTip:	" -- Double-click to mark task complete",
+		statusDoneTip:	" -- Double-click to adjust the time spent, to revive the task",
+		origTip:	"Original estimate in hours",
+		curTip:		"Current estimate in hours",
+		curTip2:	"Estimate in hours", // For when orig == cur
+		clickTip:	" -- Click to adjust",
+		spentTip:	"Hours spent on this task",
+		remTip:		"Hours remaining",
+		curPrompt:	"Estimate this task in hours, or adjust the current estimate by starting with + or -.\n\nYou may optionally also set or adjust the time spent by putting a second number after the first.",
+		spentPrompt:	"Enter the number of hours you've spent on this task, or adjust the current number by starting with + or -.\n\nYou may optionally also set or adjust the time remaining by putting a second number after the first.",
+		remPrompt:	"Enter the number of hours it will take to finish this task, or adjust the current estimate by starting with + or -.\n\nYou may optionally also set or adjust the time spent by putting a second number after the first.",
+		numbersOnly:	"Enter numbers only, please",
+		notCurrent:	"The tiddler has been modified since it was displayed, please redisplay it before doing this."
+	},
+
+	// The macro handler
+	handler: function( place, macroName, params, wikifier, paramString, tiddler )
+	{
+		var start = wikifier.matchStart, end = wikifier.nextMatch
+
+		var origStr	= params.length > 0? params.shift() : "?"
+		var orig	= +origStr // as a number
+		var cur		= params.length > 1? +params.shift() : orig
+		var spent	= params.length > 0? +params.shift() : 0
+		if ( spent > cur )
+			throw Error( this.lingo.spentTooBig.format([spent, cur]) )
+		if ( orig < 0 || cur < 0 || spent < 0 )
+			throw Error( this.lingo.noNegative )
+		var rem		= cur - spent
+		var state	= isNaN(orig+rem)? this.NASCENT : rem > 0? this.LIVE : this.DONE
+		var table	= createTiddlyElement( place, "table", null, "task "+this.styles[state] )
+		var tbody	= createTiddlyElement( table, "tbody" )
+		var row		= createTiddlyElement( tbody, "tr" )
+		var statusCell	= createTiddlyElement( row,   "td", null, "status", this.bullets[state] )
+		var descCell	= createTiddlyElement( row,   "td", null, "description" )
+
+		var origCell	= state==this.NASCENT || orig==cur? null
+				: createTiddlyElement( row, "td", null, "numeric original" )
+		var curCell	= createTiddlyElement( row, "td", null, "numeric current" )
+		var spentCell	= createTiddlyElement( row, "td", null, "numeric spent" )
+		var remCell	= createTiddlyElement( row, "td", null, "numeric remaining" )
+
+		var sums = config.macros.tasksum.tasksums
+		if ( sums && sums.length ) {
+			var summary = [(state == this.NASCENT? NaN : orig), cur, spent]
+			summary.owner = tiddler
+			sums[0].push( summary )
+		}
+
+		// The description goes to the end of the line
+		wikifier.subWikify( descCell, "$\\n?" )
+		var descEnd = wikifier.nextMatch
+
+		statusCell.setAttribute( "title", this.lingo.statusTips[state] )
+		descCell.setAttribute(   "title", this.lingo.statusTips[state]+this.lingo.descClickTip )
+		if (origCell) {
+			createTiddlyElement( origCell, "div", null, null, orig )
+			origCell.setAttribute( "title", this.lingo.origTip )
+			curCell.setAttribute( "title", this.lingo.curTip )
+		}
+		else {
+			curCell.setAttribute( "title", this.lingo.curTip2 )
+		}
+		var curDivContents = (state==this.NASCENT)? "?" : cur
+		var curDiv = createTiddlyElement( curCell, "div", null, null, curDivContents )
+		spentCell.setAttribute( "title", this.lingo.spentTip )
+		var spentDiv = createTiddlyElement( spentCell, "div", null, null, spent )
+		remCell.setAttribute( "title", this.lingo.remTip )
+		var remDiv = createTiddlyElement( remCell, "div", null, null, rem )
+
+		// Handle double-click on the description by going
+		// into edit mode and selecting the description
+		descCell.ondblclick = this.editDescription( tiddler, end, descEnd )
+
+		function appTitle( el, suffix ) {
+			el.setAttribute( "title", el.getAttribute("title")+suffix )
+		}
+
+		// For incomplete tasks, handle double-click on the bullet by marking the task complete
+		if ( state != this.DONE ) {
+			appTitle( statusCell, this.lingo.statusClickTip )
+			statusCell.ondblclick = this.markTaskComplete( tiddler, start, end, macroName, orig, cur, state )
+		}
+		// For complete ones, handle double-click on the bullet by letting you adjust the time spent
+		else {
+			appTitle( statusCell, this.lingo.statusDoneTip )
+			statusCell.ondblclick = this.adjustTimeSpent( tiddler, start, end, macroName, orig, cur, spent )
+		}
+
+		// Add click handlers for the numeric cells.
+		if ( state != this.DONE ) {
+			appTitle( curCell, this.lingo.clickTip )
+			curDiv.className = "adjustable"
+			curDiv.onclick = this.adjustCurrentEstimate( tiddler, start, end, macroName,
+				orig, cur, spent, curDivContents )
+		}
+		appTitle( spentCell, this.lingo.clickTip )
+		spentDiv.className = "adjustable"
+		spentDiv.onclick = this.adjustTimeSpent( tiddler, start, end, macroName, orig, cur, spent )
+		if ( state == this.LIVE ) {
+			appTitle( remCell, this.lingo.clickTip )
+			remDiv.className = "adjustable"
+			remDiv.onclick = this.adjustTimeRemaining( tiddler, start, end, macroName, orig, cur, spent )
+		}
+	},
+
+	// Puts the tiddler into edit mode, and selects the range of characters
+	// defined by start and end.  Separated for leak prevention in IE.
+	editDescription: function( tiddler, start, end ) {
+		return wrapEventHandler( function(e) {
+			story.displayTiddler( null, tiddler.title, DEFAULT_EDIT_TEMPLATE )
+			var tiddlerElement = document.getElementById( story.idPrefix + tiddler.title )
+			window.scrollTo( 0, ensureVisible(tiddlerElement) )
+			var element = story.findEditField( tiddler.title, "text" )
+			if ( element && element.tagName.toLowerCase() == "textarea" ) {
+				// Back up one char if the last char's a newline
+				if ( tiddler.text[end-1] == '\n' )
+					--end
+				element.focus()
+				if ( element.setSelectionRange != undefined ) { // Mozilla
+					element.setSelectionRange( start, end )
+					// Damn mozilla doesn't scroll to visible.  Approximate.
+					var max = 0.0 + element.scrollHeight
+					var len = element.textLength
+					var top = max*start/len, bot = max*end/len
+					element.scrollTop = Math.min( top, (bot+top-element.clientHeight)/2 )
+				}
+				else if ( element.createTextRange != undefined ) { // IE
+					var range = element.createTextRange()
+					range.collapse()
+					range.moveEnd("character", end)
+					range.moveStart("character", start)
+					range.select()
+				}
+				else // Other? Too bad, just select the whole thing.
+					element.select()
+				return false
+			}
+			else
+				return true
+		} )
+	},
+
+	// Modifies a task macro call such that the task appears complete.
+	markTaskComplete: function( tiddler, start, end, macroName, orig, cur, state ) {
+		var macro = this, text = tiddler.text
+		return wrapEventHandler( function(e) {
+			if ( text !== tiddler.text ) {
+				alert( macro.lingo.notCurrent )
+				return false
+			}
+			if ( state == macro.NASCENT )
+				orig = cur = 0
+			// The second "cur" in the call below bumps up the time spent
+			// to match the current estimate.
+			macro.replaceMacroCall( tiddler, start, end, macroName, orig, cur, cur )
+			return false
+		} )
+	},
+
+	// Asks the user for an adjustment to the current estimate, modifies the macro call accordingly.
+	adjustCurrentEstimate: function( tiddler, start, end, macroName, orig, cur, spent, curDivContents ) {
+		var macro = this, text = tiddler.text
+		return wrapEventHandler( function(e) {
+			if ( text !== tiddler.text ) {
+				alert( macro.lingo.notCurrent )
+				return false
+			}
+			var txt = prompt( macro.lingo.curPrompt, curDivContents )
+			if ( txt != null ) {
+				var a = macro.breakInput( txt )
+				cur = macro.offset( cur, a[0] )
+				if ( a.length > 1 )
+					spent = macro.offset( spent, a[1] )
+				macro.replaceMacroCall( tiddler, start, end, macroName, orig, cur, spent )
+			}
+			return false
+		} )
+	},
+
+	// Asks the user for an adjustment to the time spent, modifies the macro call accordingly.
+	adjustTimeSpent: function( tiddler, start, end, macroName, orig, cur, spent ) {
+		var macro = this, text = tiddler.text
+		return wrapEventHandler( function(e) {
+			if ( text !== tiddler.text ) {
+				alert( macro.lingo.notCurrent )
+				return false
+			}
+			var txt = prompt( macro.lingo.spentPrompt, spent )
+			if ( txt != null ) {
+				var a = macro.breakInput( txt )
+				spent = macro.offset( spent, a[0] )
+				var rem = cur - spent
+				if ( a.length > 1 ) {
+					rem = macro.offset( rem, a[1] )
+					cur = spent + rem
+				}
+				macro.replaceMacroCall( tiddler, start, end, macroName, orig, cur, spent )
+			}
+			return false
+		} )
+	},
+
+	// Asks the user for an adjustment to the time remaining, modifies the macro call accordingly.
+	adjustTimeRemaining: function( tiddler, start, end, macroName, orig, cur, spent ) {
+		var macro = this
+		var text  = tiddler.text
+		var rem   = cur - spent
+		return wrapEventHandler( function(e) {
+			if ( text !== tiddler.text ) {
+				alert( macro.lingo.notCurrent )
+				return false
+			}
+			var txt = prompt( macro.lingo.remPrompt, rem )
+			if ( txt != null ) {
+				var a = macro.breakInput( txt )
+				var newRem = macro.offset( rem, a[0] )
+				if ( newRem > rem || a.length > 1 )
+					cur += (newRem - rem)
+				else
+					spent += (rem - newRem)
+				if ( a.length > 1 )
+					spent = macro.offset( spent, a[1] )
+				macro.replaceMacroCall( tiddler, start, end, macroName, orig, cur, spent )
+			}
+			return false
+		} )
+	},
+
+	// Breaks input at spaces & commas, returns array
+	breakInput: function( txt ) {
+		var a = txt.trim().split( /[\s,]+/ )
+		if ( a.length == 0 )
+			a = [NaN]
+		return a
+	},
+
+	// Adds to, subtracts from, or replaces a numeric value
+	offset: function( num, txt ) {
+		if ( txt == "" || typeof(txt) != "string" )
+			return NaN
+		if ( txt.match(/^[+-]/) )
+			return num + (+txt)
+		return +txt
+	},
+
+	// Does some error checking, then replaces the indicated macro
+	// call within the text of the given tiddler.
+	replaceMacroCall: function( tiddler, start, end, macroName, orig, cur, spent )
+	{
+		if ( isNaN(cur+spent) ) {
+			alert( this.lingo.numbersOnly )
+			return
+		}
+		if ( spent < 0 || cur < 0 ) {
+			alert( this.lingo.noNegative )
+			return
+		}
+		if ( isNaN(orig) )
+			orig = cur
+		if ( spent > cur )
+			cur = spent
+		var text = tiddler.text.substring(0,start) + "<<" + macroName + " " +
+			orig + " " + cur + " " + spent + ">>" + tiddler.text.substring(end)
+		var title = tiddler.title
+		store.saveTiddler( title, title, text, config.options.txtUserName, new Date(), undefined )
+		//story.refreshTiddler( title, null, true )
+		if ( config.options.chkAutoSave )
+			saveChanges()
+	}
+}
+//}}}
+/***
+!Tasksum Macro
+Usage:
+> {{{<<tasksum "start" ["here" [intro]]>>}}}
+or:
+> {{{<<tasksum "end" [intro]>>}}}
+Put one of the {{{<<tasksum start>>}}} lines before the tasks you want to summarize, and an {{{end}}} line after them.  By default, the summary goes at the end; if you include {{{here}}} in the start line, the summary will go at the top.  The intro argument, if supplied, replaces the default text introducing the summary.
+***/
+//{{{
+config.macros.tasksum = {
+
+	// Translatable text:
+	lingo: {
+		unrecVerb:	"<<%0>> requires 'start' or 'end' as its first argument",
+		mustMatch:	"<<%0 end>> must match a preceding <<%0 start>>",
+		defIntro:	"Task summary:",
+		nascentSum:	"''%0 not estimated''",
+		doneSum:	"%0 complete (in %1 hours)",
+		liveSum:	"%0 ongoing (%1 hours so far, ''%2 hours remaining'')",
+		overSum:	"Total overestimate: %0%.",
+		underSum:	"Total underestimate: %0%.",
+		descPattern:	"%0 %1. %2",
+                origTip:	"Total original estimates in hours",
+		curTip:		"Total current estimates in hours",
+		spentTip:	"Total hours spent on tasks",
+		remTip:		"Total hours remaining"
+	},
+
+	// The macro handler
+	handler: function( place, macroName, params, wikifier, paramString, tiddler )
+	{
+		var sums = this.tasksums
+		if ( params[0] == "start" ) {
+			sums.unshift([])
+			if ( params[1] == "here" ) {
+				sums[0].intro = params[2] || this.lingo.defIntro
+				sums[0].place = place
+				sums[0].placement = place.childNodes.length
+			}
+		}
+		else if ( params[0] == "end" ) {
+			if ( ! sums.length )
+				throw Error( this.lingo.mustMatch.format([macroName]) )
+			var list = sums.shift()
+			var intro = list.intro || params[1] || this.lingo.defIntro
+			var nNascent=0, nLive=0, nDone=0, nMine=0
+			var totLiveSpent=0, totDoneSpent=0
+			var totOrig=0, totCur=0, totSpent=0
+			for ( var i=0; i < list.length; ++i ) {
+				var a = list[i]
+				if ( a.length > 3 ) {
+					nNascent 	+= a[0]
+					nLive 		+= a[1]
+					nDone 		+= a[2]
+					totLiveSpent 	+= a[3]
+					totDoneSpent 	+= a[4]
+					totOrig 	+= a[5]
+					totCur 		+= a[6]
+					totSpent 	+= a[7]
+					if ( a.owner == tiddler )
+						nMine	+= a[8]
+				}
+				else {
+					if ( a.owner == tiddler )
+						++nMine
+					if ( isNaN(a[0]) ) {
+						++nNascent
+					}
+					else {
+						if ( a[1] > a[2] ) {
+							++nLive
+							totLiveSpent += a[2]
+						}
+						else {
+							++nDone
+							totDoneSpent += a[2]
+						}
+						totOrig  += a[0]
+						totCur   += a[1]
+						totSpent += a[2]
+					}
+				}
+			}
+
+			// If we're nested, push a summary outward
+                        if ( sums.length ) {
+				var summary = [nNascent, nLive, nDone, totLiveSpent, totDoneSpent,
+						totOrig, totCur, totSpent, nMine]
+				summary.owner = tiddler
+				sums[0].push( summary )
+			}
+
+			var descs = [], styles = []
+			if ( nNascent > 0 ) {
+				descs.push( this.lingo.nascentSum.format([nNascent]) )
+				styles.push( "nascent" )
+			}
+			if ( nDone > 0 )
+				descs.push( this.lingo.doneSum.format([nDone, totDoneSpent]) )
+			if ( nLive > 0 ) {
+				descs.push( this.lingo.liveSum.format([nLive, totLiveSpent, totCur-totSpent]) )
+				styles.push( "live" )
+			}
+			else
+				styles.push( "done" )
+			var off = ""
+			if ( totOrig > totCur )
+				off = this.lingo.overSum.format( [Math.round(100.0*(totOrig-totCur)/totCur)] )
+			else if ( totCur > totOrig )
+				off = this.lingo.underSum.format( [Math.round(100.0*(totCur-totOrig)/totOrig)] )
+
+			var top		= (list.intro != undefined)
+			var table	= createTiddlyElement( null, "table", null, "tasksum "+(top?"top":"bottom") )
+			var tbody	= createTiddlyElement( table, "tbody" )
+			var row		= createTiddlyElement( tbody, "tr", null, styles.join(" ") )
+			var descCell	= createTiddlyElement( row,   "td", null, "description" )
+
+			var description = this.lingo.descPattern.format( [intro, descs.join(", "), off] )
+			wikify( description, descCell, null, tiddler )
+
+			var origCell	= totOrig == totCur? null
+					: createTiddlyElement( row, "td", null, "numeric original", totOrig )
+			var curCell	= createTiddlyElement( row, "td", null, "numeric current", totCur )
+			var spentCell	= createTiddlyElement( row, "td", null, "numeric spent", totSpent )
+			var remCell	= createTiddlyElement( row, "td", null, "numeric remaining", totCur-totSpent )
+
+			if ( origCell )
+				origCell.setAttribute( "title", this.lingo.origTip )
+			curCell  .setAttribute( "title", this.lingo.curTip )
+			spentCell.setAttribute( "title", this.lingo.spentTip )
+			remCell  .setAttribute( "title", this.lingo.remTip )
+
+			// Discard the table if there are no tasks
+			if ( list.length > 0 ) {
+				var place = top? list.place : place
+				var placement = top? list.placement : place.childNodes.length
+				if ( placement >= place.childNodes.length )
+					place.appendChild( table )
+				else
+					place.insertBefore( table, place.childNodes[placement] )
+			}
+		}
+		else
+			throw Error( this.lingo.unrecVerb.format([macroName]) )
+
+		// If we're wikifying, and are followed by end-of-line, swallow the newline.
+		if ( wikifier && wikifier.source.charAt(wikifier.nextMatch) == "\n" )
+			++wikifier.nextMatch
+	},
+
+	// This is the stack of pending summaries
+	tasksums: []
+}
+//}}}
+/***
+!Taskadder Macro
+Usage:
+> {{{<<taskadder ["above"|"below"|"focus"|"nofocus"]...>>}}}
+Creates a line with text entry fields for a description and an estimate.  By default, puts focus in the description field and adds tasks above the entry fields.  Use {{{nofocus}}} to not put focus in the description field.  Use {{{below}}} to add tasks below the entry fields.
+***/
+//{{{
+config.macros.taskadder = {
+
+	// Translatable text:
+	lingo: {
+		unrecParam:	"<<%0>> doesn't recognize '%1' as a parameter",
+		descTip:	"Describe a new task",
+		curTip:		"Estimate how long in hours the task will take",
+		buttonText:	"add task",
+		buttonTip:	"Add a new task with the description and estimate as entered",
+		notCurrent:	"The tiddler has been modified since it was displayed, please redisplay it before adding a task this way.",
+
+		eol:		"eol"
+	},
+
+	// The macro handler
+	handler: function( place, macroName, params, wikifier, paramString, tiddler )
+	{
+		var above = true
+		var focus = false
+
+		while ( params.length > 0 ) {
+			var p = params.shift()
+			switch (p) {
+			case "above": 	above = true;  break
+			case "below": 	above = false; break
+			case "focus": 	focus = true;  break
+			case "nofocus":	focus = false; break
+			default:	throw Error( this.lingo.unrecParam.format([macroName, p]) )
+			}
+		}
+
+		// If we're followed by end-of-line, swallow the newline.
+		if ( wikifier.source.charAt(wikifier.nextMatch) == "\n" )
+			++wikifier.nextMatch
+
+		var where	= above? wikifier.matchStart : wikifier.nextMatch
+
+		var table	= createTiddlyElement( place, "table", null, "task" )
+		var tbody	= createTiddlyElement( table, "tbody" )
+		var row		= createTiddlyElement( tbody, "tr" )
+		var statusCell	= createTiddlyElement( row,   "td", null, "status" )
+		var descCell	= createTiddlyElement( row,   "td", null, "description" )
+		var curCell	= createTiddlyElement( row,   "td", null, "numeric" )
+		var addCell	= createTiddlyElement( row,   "td", null, "addtask" )
+
+		var descId	= this.generateId()
+		var curId	= this.generateId()
+		var descInput	= createTiddlyElement( descCell, "input", descId )
+		var curInput	= createTiddlyElement( curCell,  "input", curId  )
+
+		descInput.setAttribute( "type", "text" )
+		curInput .setAttribute( "type", "text" )
+		descInput.setAttribute( "size", "40")
+		curInput .setAttribute( "size", "6" )
+		descInput.setAttribute( "autocomplete", "off" );
+		curInput .setAttribute( "autocomplete", "off" );
+		descInput.setAttribute( "title", this.lingo.descTip );
+		curInput .setAttribute( "title", this.lingo.curTip  );
+
+		var addAction	= this.addTask( tiddler, where, descId, curId, above )
+		var addButton	= createTiddlyButton( addCell, this.lingo.buttonText, this.lingo.buttonTip, addAction )
+
+		descInput.onkeypress = this.handleEnter(addAction)
+		curInput .onkeypress = descInput.onkeypress
+		addButton.onkeypress = this.handleSpace(addAction)
+		if ( focus || tiddler.taskadderLocation == where ) {
+			descInput.focus()
+			descInput.select()
+		}
+	},
+
+	// Returns a function that inserts a new task macro into the tiddler.
+	addTask: function( tiddler, where, descId, curId, above ) {
+		var macro = this, oldText = tiddler.text
+		return wrapEventHandler( function(e) {
+			if ( oldText !== tiddler.text ) {
+				alert( macro.lingo.notCurrent )
+				return false
+			}
+			var desc	= document.getElementById(descId).value
+			var cur		= document.getElementById(curId) .value
+			var init	= tiddler.text.substring(0,where) + "<<task " + cur + ">> " + desc + "\n"
+			var text	= init + tiddler.text.substring(where)
+			var title	= tiddler.title
+			tiddler.taskadderLocation = (above? init.length : where)
+			try {
+				store.saveTiddler( title, title, text, config.options.txtUserName, new Date(), undefined )
+				//story.refreshTiddler( title, null, true )
+			}
+			finally {
+				delete tiddler.taskadderLocation
+			}
+			if ( config.options.chkAutoSave )
+				saveChanges()
+		} )
+	},
+
+	// Returns an event handler that delegates to two other functions: "matches" to decide
+	// whether to consume the event, and "addTask" to actually perform the work.
+	handleGeneric: function( addTask, matches ) {
+		return function(e) {
+			if (!e) var e = window.event
+			var consume = false
+			if ( matches(e) ) {
+				consume = true
+				addTask( e )
+			}
+			e.cancelBubble = consume;
+			if ( consume && e.stopPropagation ) e.stopPropagation();
+			return !consume;
+		}
+	},
+
+	// Returns an event handler that handles enter keys by calling another event handler
+	handleEnter: function( addTask ) {
+		return this.handleGeneric( addTask, function(e){return e.keyCode == 13 || e.keyCode == 10} ) // Different codes for Enter
+	},
+
+	// Returns an event handler that handles the space key by calling another event handler
+	handleSpace: function( addTask ) {
+		return this.handleGeneric( addTask, function(e){return (e.charCode||e.keyCode) == 32} )
+	},
+
+	counter: 0,
+	generateId: function() {
+		return "taskadder:" + String(this.counter++)
+	}
+}
+//}}}
+/***
+!Stylesheet
+***/
+//{{{
+var stylesheet = '\
+.viewer table.task, table.tasksum {\
+	width: 100%;\
+	padding: 0;\
+	border-collapse: collapse;\
+}\
+.viewer table.task {\
+	border: none;\
+	margin: 0;\
+}\
+table.tasksum, .viewer table.tasksum {\
+	border: solid 2px #999;\
+	margin: 3px 0;\
+}\
+table.tasksum td {\
+	text-align: center;\
+	border: 1px solid #ddd;\
+	background-color: #ffc;\
+	vertical-align: middle;\
+	margin: 0;\
+	padding: 0;\
+}\
+.viewer table.task tr {\
+	border: none;\
+}\
+.viewer table.task td {\
+	text-align: center;\
+	vertical-align: baseline;\
+	border: 1px solid #fff;\
+	background-color: inherit;\
+	margin: 0;\
+	padding: 0;\
+}\
+td.numeric {\
+	width: 3em;\
+}\
+table.task td.numeric div {\
+	border: 1px solid #ddd;\
+	background-color: #ffc;\
+	margin: 1px 0;\
+	padding: 0;\
+}\
+table.task td.original div {\
+	background-color: #fdd;\
+}\
+table.tasksum td.original {\
+	background-color: #fdd;\
+}\
+table.tasksum td.description {\
+	background-color: #e8e8e8;\
+}\
+table.task td.status {\
+	width: 1.5em;\
+	cursor: default;\
+}\
+table.task td.description, table.tasksum td.description {\
+	width: auto;\
+	text-align: left;\
+	padding: 0 3px;\
+}\
+table.task.done td.status,table.task.done td.description {\
+	color: #ccc;\
+}\
+table.task.done td.current, table.task.done td.remaining {\
+	visibility: hidden;\
+}\
+table.task.done td.spent div, table.tasksum tr.done td.current,\
+table.tasksum tr.done td.spent, table.tasksum tr.done td.remaining {\
+	background-color: #eee;\
+	color: #aaa;\
+}\
+table.task.nascent td.description {\
+	color: #844;\
+}\
+table.task.nascent td.current div, table.tasksum tr.nascent td.numeric.current {\
+	font-weight: bold;\
+	color: #c00;\
+	background-color: #def;\
+}\
+table.task.nascent td.spent, table.task.nascent td.remaining {\
+	visibility: hidden;\
+}\
+td.remaining {\
+	font-weight: bold;\
+}\
+.adjustable {\
+	cursor: pointer; \
+}\
+table.task input {\
+	display: block;\
+	width: 100%;\
+	font: inherit;\
+	margin: 2px 0;\
+	padding: 0;\
+	border: 1px inset #999;\
+}\
+table.task td.numeric input {\
+	background-color: #ffc;\
+	text-align: center;\
+}\
+table.task td.addtask {\
+	width: 6em;\
+	border-left: 2px solid white;\
+	vertical-align: middle;\
+}\
+'
+setStylesheet( stylesheet, "TaskMacroPluginStylesheet" )
+//}}}
+
+
+
+
!!Changes in 1.1.0
+* Made the macros work in nested tiddlers (ie when one tiddler includes another using {{{<<tiddler>>}}} or something similar):
+** Task summaries in the outer tiddler include the tasks from the inner one
+** Using the editing shortcuts on the tasks as displayed in the outer tiddler correctly changes the inner tiddler and also redisplays the outer one
+** Added sanity checks to the editing shortcuts so they will refuse to work if the tiddler has been modified behind their backs
+* Made some small usability fixes:
+** The "add task" button now responds to the Space key (hat tip: Daniel Baird)
+** Double-clicking on a completed task's bullet now does the same thing as clicking on the elapsed time: it lets you adjust the time spent, giving you the option of resurrecting the task (hat tip: ~JackF)
+** Reworked the focus handling of the taskadder macro so it works more intuitively, by refocusing on the same adder you just used
+
+
+
+
The task macro provided by the TaskMacroPlugin is for planning, estimating, and tracking detailed tasks such as those required for writing software.  It is inspired by [[Joel Spolsky|http://www.joelonsoftware.com/articles/fog0000000245.html]]'s method for scheduling software development, also popularized by [[Voo2do|http://voo2do.com]] and [[XPlanner|http://xplanner.org]].
+
+For changes since the previous version, see the TaskMacroReleaseNotes.
+
+This tutorial leads you through the use of the task macro itself, and supporting macros that summarize lists of tasks and simplify the adding of tasks to a list.  Follow along by clicking the links below.  Or click the little down-arrow next to this tiddler's title, above, and choose "Open all" to have all the tutorial sections displayed at once.
+
+
+
+
+
<!---
+Includes portions of [[TagglyTaggingViewTemplate|http://simonbaird.com/mptw/#TagglyTaggingViewTemplate]], v1.2 (16-Jan-2006).
+Also adds a pair of tasksum macros around the tiddler, to summarize any contained tasks at the top.  Removes the "-" in front of closeTiddler, which can easily bite you if you have a focusable element in a tiddler, such as a taskadder entry field.
+Portions written by Luke Blanshard are hereby released into the public domain.
+--->
+<!--{{{-->
+<div class="toolbar" macro="toolbar closeTiddler closeOthers +editTiddler permalink references jump newHere"></div>
+<div class="tagglyTagged" macro="tags"></div>
+<div><span class="title" macro="view title"></span><span class="miniTag" macro="miniTag"></span></div>
+<div macro="tasksum start here"></div>
+<div class="viewer" macro="view text wikified"></div>
+<div macro="tasksum end"></div>
+<div class="tagglyTagging" macro="tagglyListWithSort"></div>
+<!--}}}-->
+
+
+
+
! Things which are imminent to do
+
+<<task 1 1 0.25>> Testsuite: Valgrind suppression file generation, glibc/pthreads leak some memory at the end of the applications, this is ok, we have to integrate this as suppressions into the testsuite, initial work done by cehteh
+<<task >> Testsuite: expected 'out:' and 'err:' should be shell glob or regex lines not exact strings. The output shall be matched against the current 'out:' or 'err:' line, on success the check continues with the actual expected glob, on fail the next glob is tried. When that fails the test is counted as failure.
+<<task >> Testsuite: when no expected 'err:' statements are in a test then stderr, including valgrind reports gets ignored, this is a bug. stderr should be filtered for nobug logging events but everything else should be checked for unexpected output.
+<<task >> Website: asciidoc switchover, git integration, rebuild website on push
+<<taskadder>>
+
+
+
+
/***
+''TextAreaPlugin for TiddlyWiki version 2.0''
+^^author: Eric Shulman - ELS Design Studios
+source: http://www.elsdesign.com/tiddlywiki/#TextAreaPlugin
+license: [[Creative Commons Attribution-ShareAlike 2.5 License|http://creativecommons.org/licenses/by-sa/2.5/]]^^
+
+This plugin 'hijacks' the TW core function, ''Story.prototype.focusTiddler()'', so it can add special 'keyDown' handlers to adjust several behaviors associated with the textarea control used in the tiddler editor.  Specifically, it:
+* Adds text search INSIDE of edit fields.^^
+Use ~CTRL-F for "Find" (prompts for search text), and ~CTRL-G for "Find Next" (uses previous search text)^^
+* Enables TAB characters to be entered into field content^^
+(instead of moving to next field)^^
+* Option to set cursor at top of edit field instead of auto-selecting contents^^
+(see configuration section for checkbox)^^
+!!!!!Configuration
+<<<
+<<option chkDisableAutoSelect>> place cursor at start of textarea instead of pre-selecting content
+<<option chkTextAreaExtensions>> add control-f (find), control-g (find again) and allow TABs as input in textarea
+<<<
+!!!!!Installation
+<<<
+Import (or copy/paste) the following tiddlers into your document:
+''TextAreaPlugin'' (tagged with <<tag systemConfig>>)
+<<<
+!!!!!Revision History
+<<<
+''2006.01.22 [1.0.1]''
+only add extra key processing for TEXTAREA elements (not other edit fields).
+added option to enable/disable textarea keydown extensions (default is "standard keys" only)
+''2006.01.22 [1.0.0]''
+Moved from temporary "System Tweaks" tiddler into 'real' TextAreaPlugin tiddler.
+<<<
+!!!!!Code
+***/
+//{{{
+version.extensions.textAreaPlugin= {major: 1, minor: 0, revision: 1, date: new Date(2006,1,23)};
+//}}}
+
+//{{{
+if (!config.options.chkDisableAutoSelect) config.options.chkDisableAutoSelect=false; // default to standard action
+if (!config.options.chkTextAreaExtensions) config.options.chkTextAreaExtensions=false; // default to standard action
+
+// Focus a specified tiddler. Attempts to focus the specified field, otherwise the first edit field it finds
+Story.prototype.focusTiddler = function(title,field)
+{
+	var tiddler = document.getElementById(this.idPrefix + title);
+	if(tiddler != null)
+		{
+		var children = tiddler.getElementsByTagName("*")
+		var e = null;
+		for (var t=0; t<children.length; t++)
+			{
+			var c = children[t];
+			if(c.tagName.toLowerCase() == "input" || c.tagName.toLowerCase() == "textarea")
+				{
+				if(!e)
+					e = c;
+				if(c.getAttribute("edit") == field)
+					e = c;
+				}
+			}
+		if(e)
+			{
+			e.focus();
+			e.select(); // select entire contents
+
+			// TWEAK: add TAB and "find" key handlers
+			if (config.options.chkTextAreaExtensions) // add extra key handlers
+				addKeyDownHandlers(e);
+
+			// TWEAK: option to NOT autoselect contents
+			if (config.options.chkDisableAutoSelect) // set cursor to start of field content
+				if (e.setSelectionRange) e.setSelectionRange(0,0); // for FF
+				else if (e.createTextRange) { var r=e.createTextRange(); r.collapse(true); r.select(); } // for IE
+
+			}
+		}
+}
+//}}}
+
+//{{{
+function addKeyDownHandlers(e)
+{
+	// exit if not textarea or element doesn't allow selections
+	if (e.tagName.toLowerCase()!="textarea" || !e.setSelectionRange) return;
+
+	// utility function: exits keydown handler and prevents browser from processing the keystroke
+	var processed=function(ev) { ev.cancelBubble=true; if (ev.stopPropagation) ev.stopPropagation(); return false; }
+
+	// capture keypress in edit field
+	e.onkeydown = function(ev) { if (!ev) var ev=window.event;
+
+		// process TAB
+		if (!ev.shiftKey && ev.keyCode==9) { 
+			// replace current selection with a TAB character
+			var start=e.selectionStart; var end=e.selectionEnd;
+			e.value=e.value.substr(0,start)+String.fromCharCode(9)+e.value.substr(end);
+			// update insertion point, scroll it into view
+			e.setSelectionRange(start+1,start+1);
+			var linecount=e.value.split('\n').length;
+			var thisline=e.value.substr(0,e.selectionStart).split('\n').length-1;
+			e.scrollTop=Math.floor((thisline-e.rows/2)*e.scrollHeight/linecount);
+			return processed(ev);
+		}
+
+		// process CTRL-F (find matching text) or CTRL-G (find next match)
+		if (ev.ctrlKey && (ev.keyCode==70||ev.keyCode==71)) {
+			// if ctrl-f or no previous search, prompt for search text (default to previous text or current selection)... if no search text, exit
+			if (ev.keyCode==70||!e.find||!e.find.length)
+				{ var f=prompt("find:",e.find?e.find:e.value.substring(e.selectionStart,e.selectionEnd)); e.focus(); e.find=f?f:e.find; }
+			if (!e.find||!e.find.length) return processed(ev);
+			// do case-insensitive match with 'wraparound'...  if not found, alert and exit 
+			var newstart=e.value.toLowerCase().indexOf(e.find.toLowerCase(),e.selectionStart+1);
+			if (newstart==-1) newstart=e.value.toLowerCase().indexOf(e.find.toLowerCase());
+			if (newstart==-1) { alert("'"+e.find+"' not found"); e.focus(); return processed(ev); }
+			// set new selection, scroll it into view, and report line position in status bar
+			e.setSelectionRange(newstart,newstart+e.find.length);
+			var linecount=e.value.split('\n').length;
+			var thisline=e.value.substr(0,e.selectionStart).split('\n').length;
+			e.scrollTop=Math.floor((thisline-1-e.rows/2)*e.scrollHeight/linecount);
+			window.status="line: "+thisline+"/"+linecount;
+			return processed(ev);
+		}
+	}
+}
+//}}}
+
+
+
! Proc layer
+ by ichtho
+
+! Backend
+ by cehteh
+!! File handling
+Opening and accessing huge files for reading and writing
+!!! Manageing File opening, desciptors and handles
+In progress
+!!! Mmaping backend, caching
+Design finished, nothing implemented yet.
+!! Serializer
+Some ideas, nothing done yet.
+!! Scheduler
+Design ideas, nothing done yet.
+
+! Support Libary
+by cehteh and ichthyo
+
+Ongoing efforts as needed, some things already deprecated ;)
+!! Plugin Loader
+Basic implementation finished, not final yet.
+
+! Infrastructure
+!! Testsuite
+Needs some improvements, see [[Tasks]]
+!! Website
+A mockup website is online, raffa experimenting with asciidoc which looks good so far. git integration and automatic generation on push to be done see [[Tasks]]
+!! git / mob repos
+gitweb is up, git repos are established, mob repos are not yet up.
+!! automatic generation and checkout of tiddlywikis and doxygen docs on the server
+currently only a manual rsync script in admin/
+!! automatic builds/test on server, status page
+will be done on the 'devel' vserver. nothing done yet.
+!! Developer Documentation
+Someone might pickup a Doxygen-Maintainer. This is not writing actual documentation but bringing the Documentation comments in the source to a good shape, add formatting tags, ensureing that all docs are properly generated, maintaining a glossary and index, define the order etc.
+
+
+
+
Use the backend, gmerlin/avdecoder and a Player widget to playback videos. This should be a small application which can open and playback many videos from on instance in parallel. Later on scrubbing for this videos might be supported.
+
+The idea here is to show and measure backend and scheduler performance and beeing a proof of concept for the design. It will run independent of the Proc layer but needs quite some work on the backend to be done.
+
+
+ + + + + + + + + +