On Friday, March 20, 2015 at 12:25:54 PM UTC-7, David Bakin wrote:
>
> Here's my state: I have several useful TWC wikis in progress ... some
> have several hundred tiddlers. Even though there's very little theming
> done I have only read that a) TWC tiddlers can't be directly imported to
> TW5 and b) there's a tool "in progress" that will convert "most" tiddlers
> (but no specification of what gets converted and what doesn't).
>
> I'm willing to learn the new markup language, and in fact, I'm willing to
> start new wikis from scratch (new topics) but my blocking issue is that I
> do rely on several TWC plugins and I have no idea what the equivalent is in
> TW5 or if it is available. So in the interests of progressing, I hope
> you'll be able to answer for me what the equivalent of the following is in
> TW5 or what I should be doing instead:
>
One of the best features of TWC (and TW5 in 'standalone' single file use),
is that all the programming for the system is self-contained in the same
file with your document data, so that there is no risk of "version skew"
when upgrading. You can continue to use your existing TWC documents even
as you get "up to speed" creating new TW5 documents from scratch. As you
learn more TW5 syntax and techniques, you will eventually become
comfortable enough with TW5 that you will be able to tackle the migration
of your existing TWC content. Of course, you can always decide that you
don't need to convert your TWC documents, and just use TW5 for new things.
a) The single most important plugin I use is SharedTiddlers, which lets me
> have a "base" wiki which contains nearly all the plugins I use (except
> SharedTiddlers itself...) and then a bunch of topic wikis that refer to the
> "base" for all enhancments ... plugins, configuration, etc. That way
> when I introduce a new plugin to my repertoire ... or a plugin is upgraded
> ... I do it in one place - base.html - and it is available in all my wikis
> instantly and automatically. Does SharedTiddlers exist in TW5 or is there
> another way to get this vital functionality?
>
Jeremy has talked quite a bit about Ward Cunningham's "Federated Wiki"
concept, which can readily support a SharedTiddlers model of use.
However... the implementation is not yet there. One of the major concerns
is about security... because TWC allows some embedded scripting (e.g.,
onClick handlers in HTML code, evaluated parameters in TWC macros, etc.)
within tiddlers, it is a possible vector for malicious code... especially
in a "SharedTiddlers" situation, where the tiddlers can be coming from
non-trusted sources. Some of the TW5 strategies for closing this security
gap include "sanitizing" the tiddler content to remove all embedded
<script>...</script> elements, as well as all "onXXX" handlers in HTML code.
b) TextArea - to adjust the size of the area of the new tiddler I'm
> creating.
>
Most modern browsers now include a small "stretch box" on textarea input
fields. Simple grab the lower right corner of the text box and you can
resize it. This is a browser-level feature, and is completely independent
of TiddlyWiki code.
> c) RearrangeTiddlers - I just like to organize several tiddlers I'm
> reading at the moment.
>
I like this feature too (that why I wrote it!). In TW5, the current
contents of the "story river" are continuously tracked in [[$:/StoryList]].
Editing the tiddlers listed there to change their order will immediately
update the order the tiddlers current displayed in the story river.
However, there is not YET any "drag and drop" handling to achieve this
interactively. TW5 has some built-in handling for drag-and-drop, via the
$dropzone widget, so there is some potential for creating a plugin to
enable dragging tiddlers for re-ordering... but this has not yet been
implemented... and may need some additional core changes to make it work
right.
d) ForEachTiddler - I've written little utilities like a macro that deletes
> all tiddlers with a given tag.
>
One of the most powerful new features of TW5 is the <$list> widget. It
selects a set of tiddlers by using a "filter" (another powerful features of
TW5), and then loops over that set of tiddlers, rendering specified content
for each tiddler that is selected. For your indicated use-case, you could
write something like:
<$list filter="[tag[SomeTag]]">
<$action-deletetiddler {{!!title}}/>
</$list>
However, since deleting a set of tiddlers is a fairly common activity, the
<$action-deletetiddler> widget also directly supports filtering for
deleting multiple tiddlers, so you could write this in just one line:
<$action-deletetiddler $filter="[tag[sometag]]"/>
To make sure that the above is only invoked when you explicitly choose to
delete tiddlers, you can wrap the above line inside a <$button> widget,
like this:
<$button>
<$action-deletetiddler $filter="[tag[sometag]]"/>
Delete tiddlers
</$button>
This creates a pushbutton labelled "Delete tiddlers". Pushing the button
triggers the contained <$action-deletetiddler> widget.
e) DisableWikiLinks - sometimes it's more convenient than using individual
> markup
>
f) MathJax - I can move up to KaTeX ... I assume the markup to signal TeX
> is similar, so this probably isn't a problem.
>
Not personally familiar with either MathJax or KaTeX syntax, but yes, my
impression is that they are similar.
Really, the lack of documentation and the different plugin support are the
> major major blockers for me. I just isn't practical to search google
> groups to find answers to questions like "what's available" - things are so
> scattered.
>
There are quite a few people that are working on improving the
documentation... but this takes time. There has recently been alot of
refactoring in the documentation at www.TiddlyWiki.com, but it's still a
work in progress, and there's lots of opportunities for improvement.
Myself, I am working on a full-blown book project: "Inside TiddlyWiki: The
Missing Manual", but it also is a work-in-progress, and it will be some
time (months) before it is ready for public consumption. This is a group
funded project, with initial funds raised through an IndieGoGo campaign,
and continued fundraising through direct PayPal contributions here:
http://TiddlyTools.github.com/fundraising.html#MakeADonation
I will very much appreciate your help in getting me going on TW5 by letting
> me know what the right way to handle each of the needs that the above TWC
> plugins do for me. And also, am I right that I might as well NOT convert
> my old TWC wikis? Or does the tool to do the conversion actual exist and
> work?
>
Unfortuantely, migrating content is not currently a 'one click' operation.
You can drag-and-drop a TWC file onto an open TW5 document and it will
import all the tiddlers from the TWC file (you can select which ones).
However, the content in those TWC tiddlers is not "massaged" into TW5
syntax, which is left for you to do manually. There is also a TWC parser
plugin for TW5, which enables most (but not all) TWC syntax to be rendered
without converting to TW5 syntax (see
http://tiddlywiki.com/plugins/tiddlywiki/tw2parser/ for a demo). Note also
that there is no direct support in TW5 for TWC <<macro>> syntax --
especially if the macro was defined in a TWC plugin -- so there is still
some manual conversion and re-implementation that will be needed to
completely migrate from TWC to TW5.
Of course, as I noted above, you can continue to use your existing TWC
documents as long as you like, and only migrate when you are up-to-speed
with TW5.
I hope my answers have given you some confidence in moving forward to
TW5... if not for all your existing documents, then at least for any new
documents you create from scratch.
enjoy,
-e
Eric Shulman
TiddlyTools / ELS Design Studios
"Inside TiddlyWiki: The Missing Manual"
https://www.indiegogo.com/projects/inside-tiddlywiki-the-missing-manual/x/8816263
Note: the IndieGogo funding campaign has ended,
but direct fundraising continues below...
YOUR DONATIONS ARE VERY IMPORTANT!
HELP ME TO HELP YOU - MAKE A CONTRIBUTION TO MY "TIP JAR"...
http://TiddlyTools.github.com/fundraising.html#MakeADonation
Professional TiddlyWiki Consulting Services...
Analysis, Design, and Custom Solutions:
http://www.TiddlyTools.com/#Contact
--
You received this message because you are subscribed to the Google Groups
"TiddlyWiki" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/tiddlywiki.
For more options, visit https://groups.google.com/d/optout.
