Tiddler Toddler - an absolute beginner's guide to Classic TiddlyWiki The information here applies to "classic" TiddlyWiki. For information on the latest version of TiddlyWiki (TiddlyWiki5), please visit http://tiddlywiki.com.

A lapsed journalist, I've worked in the media for 25 years in NZ and the UK. In that time I’ve led organisational culture change and workflow projects; founded (and closed down) allaboutthestory.com, an experimental online content marketplace; and been a journalism tutor, chief/layout/downtable sub-editor, reporter and radio presenter.

I came across ~TiddlyWiki while working in London years ago and, being a non-coder, struggled with it in the beginning. This site is a documentation of my learning process.

I'm unable to update this site at the moment, so apologies for anything that's out of date.

[[About me|http://juliestarr.co.nz]]

Open MainMenu for editing. 
Position the cursor where you want the line, or rule, to appear. 
Type in four hyphens ---- (open the MainMenu tiddler on TiddlerToddler to see what it looks like).
Close MainMenu.
You should now see the line where you wanted it on the menu.

Find MainMenu and open it for editing. (If you can't see it anywhere, try searching for it or looking on the Timeline or All on the lower right-hand menu).

Decide where in the menu list you want the new item to appear.

Type in the name of the tiddler you want to appear there. 

For it to work as a link, you will have to insert two square brackets on either side of the name like this:
""" [[Add Menu Item]] """

You don't need to use square brackets if the name of the tiddler is a [[WikiWord|WikiWords]].

Click on Done. You should now see the tiddler listed on your menu.

Your username appears on the tiddlers you create and edit. You will have provided a username when you first created your ~TiddlyWiki, but occasionally you may be asked for it again. 

Click on Options on the top right-hand menu. A blue box appears. Where it says 'your username for signing your edits.....' type your name in the white box. That's done. No need to hit a Done or Save button. You can close the blue box by clicking on Options again. You can also leave it open, if you prefer.

To select autosave, go to Options on the top right-hand menu. A blue box will open. Look around halfway down and click on 'autosave'. 

Job done. Your ~TiddlyWiki will now save every time you make a change.

If you are doing a lot of work, and the flood of save prompts starts driving you nuts, go back into Options and unclick autosave. You can go back in later and re-select it.

Open the PageTemplate tiddler. This is a 'shadow' tiddler which you can find either by using the search box (top right) or looking under More>Shadowed on the lower right-hand menu.

This tiddler contains a bunch of code which determines how your ~TiddlyWiki looks.

The first line of code determines the colour of your header. It looks like this:
>"""<div class='header' macro='gradient vert [[ColorPalette::PrimaryLight]] [[ColorPalette::PrimaryMid]]'>"""

To change the colour, strip out everything after: 
>"""<div class='header' macro='gradient vert"""

Now add the new colour, like this: 
>"""<div class='header' macro='gradient vert #014'>"""

The colour I've put in (#014) is the colour of the header on Tiddler Toddler.

Where do you find the code for colours? Take a look at the ColorPalette tiddler - it's another shadow tiddler and it lists the colours available in your ~TiddlyWiki. To see the colours (rather than a list of their names) try [[this on FND's DevPad site|http://devpad.tiddlyspot.com/#PaletteViewMacro]], the [[TiddlyWiki Tutorial|http://www.blogjones.com/TiddlyWikiTutorial.html#StyleSheetColors]] and [[Morris Gray|http://tiddlyspot.com/twhelp/#UsingColor]].

Or take a look at a chart of Hex HTML colour codes such as at [[Visibone|http://html-color-codes.com/]], [[WebMonkey|http://www.webmonkey.com/reference/Color_Charts]] or [[ColorSchemer|http://www.colorschemer.com/online.html]].. 

If you take a fancy to, say, 99CC00, you can change the header like this:

>"""<div class='header' macro='gradient vert #99CC00'>"""

By default, every time you 'save changes' on your ~TiddlyWiki a backup copy will also be saved - into the same folder. A great long list of back-up versions can soon build up, cluttering up the folder.

An easy solution is to create a back-up folder to hold all the back-up files.

Go to 'options' on the right-hand top menu. Click on 'AdvancedOptions' at the bottom of the blue box.

You'll see a table open up. About three lines down you'll see 'Name of folder to use for backups'.

Type in a name (NB this is literally a name, not the address of the folder). I, rather unimaginatively, call my folder Tiddly Back-ups.

Close the AdvancedOptions tiddler.

Now go to the folder you keep your TiddlyWiki in. You should see a new folder has been created in there with the name you just typed in. From now on your backups will be stored in this folder.

I don't know much about colour yet. Here's what I do know.
*RGB colour is used online (for publishing images etc). RGB stands for Red, Green, Blue.
*CMYK colour is used in print. CMYK colour stands for Cyan, Magenta, Yellow, blacK.
*Hex code colours are used in ~TiddlyWikis and websites  (headers, backgrounds, text etc).
To find the code for colours you like, you can look at sites like [[Visibone|http://html-color-codes.com/]], [[WebMonkey|http://www.webmonkey.com/2010/02/color_charts/]] or [[ColorSchemer|http://www.colorschemer.com/online.html]].. 

To see the code for the colours used as default in ~TiddlyWikis, look at the ColorPalette tiddler - it's a shadow tiddler. To see the colours (rather than a list of their names) try [[this on FND's DevPad site|http://devpad.tiddlyspot.com/#PaletteViewMacro]] and [[Morris Gray|http://tiddlyspot.com/twhelp/#UsingColor]].

You'll notice that the ~TiddlyWiki colours have a slightly different format than regular Hex colours. FFFFFF becomes FFF, for example. I have no idea why yet. Buzz me if you know.

There are several ways you can change the colour scheme of your Tiddlywiki: 
*You can change how individual elements of your ~TiddlyWIki look - such as the [[colour of the header|Change Colour of Header]] at the top of the page or where the menu sits - by tweaking code in certain shadow tiddlers. Aside from changing the [[colour of the header|Change Colour of Header]], I can't help much with this side of things, so try [[Get Help]], the [[mailing list|http://groups.google.com/group/TiddlyWiki]] and the [[documentation wiki|http://www.tiddlywiki.org]]. 
*You can use CSS and Style Sheets. I would if I could, but I can't so I don't. But I have a book on the subject now, though, so who knows, I may break out into CSS at any time.

Well, it's hardly an extreme makeover and I shan't be applying for any website design of the year awards.

But I'm happy to report that I've figured out not only how to change the colour of Tiddler Toddler's header (a dashing darkish blue snappily titled #014), but also what the header is called. (I previously thought of it as the Big Blue Space at the Top of the Page.)

Progress indeed.

And, I found out that you can put pictures, images, logos etc in the header if you want, which is great and super easy as it turns out: you just [[paste in a link|Insert Picture]] like you would in a tiddler. Child's play.

I've also managed, I hope, to dig out some of the glaring misinformation I've had on this site dating back to a hellish week where I managed to lose many things and get thoroughly muddled between live Tiddler Toddler and a local copy. I carefully compounded the confusion by writing (incorrectly) about it, mislabelling the tiddlers and leaving them lying around for unwary ~TiddlyWiki travellers to trip over.

Bad Tiddler Toddler.

If I'm not mistaken, I believe I haven't lost anything for well over a week - a personal best. Blimey. Mind you, I've done a load of work today locally and haven't checked online yet to see if it's all uploading in a suitable manner. Fingers crossed.

Now that I've temporarily sated my need for ~TiddlyWiki prettification, I've got my eye on a few projects for the new year. In no particular order:

a glossary (nice idea, shame I don't know what anything's properly called - except the header)
a way of organising the [[I Want To...]] tiddler into an A-Z menu thingy (what's that called?)
a horizontal menu with dropdown submenus (the very height of sophistication, if you ask me)
a way to display pictures with a nice bit of wraparound on them so the tiddler text doesn't bang into them, plus a caption that sits closer to the bottom edge (or on the picture itself)
some proper website accoutrements like RSS buttons and blogrolls
a comments or message function (so you can tell me when I don't make sense, and when I do)

That should keep me quiet for a while.

I'm also planning to contribute more to the [[community wiki|http://www.tiddlywiki.org]] like I said I would but haven't really, very much (bad Tiddler Toddler), mostly because I don't know how to do much. Onwards...

Meantime, happy holidays one and all.

New Year's resolution? Don't drink and type.

I don't know how to set up comments on Tiddler Toddler yet. In the meantime, you are welcome to email me: julie@juliestarr.co.nz

!!Links Within Your ~TiddlyWiki

To create a link within your ~TiddlyWiki to another tiddler, put two double brackets on either side of the name of the tiddler """[[like this]]""". 

> ''TOP TIP'' If you ever want to see how someone else has created links, or styled text or anything else, you can click on Edit to open the tiddler in edit mode, where you'll be able to see the formatting they've used. It's perfectly okay to go into someone else's tiddler if it's in a help file.

You can also use WikiWords, which are a feature of ~TiddlyWiki. 

The advantage of using ~WikiWords  - words containing more than one capital letter - is that they automatically work as links, so you don't have to put square brackets around them when you add them to a menu or include them as a link in a tiddler.

FormatText, on the left-hand menu, is an example of a [[WikiWord|WikiWords]] on this site. If you open this tiddler in Edit mode, you'll see that I didn't have to put square brackets around FormatText it to make it work as a link.

Trouble is, they act as links even if you didn't mean to create a ~WikiWord. If you typed in CMSs as an abbreviation, say, or Ctrl-B, they will work as WikiWords even if you didn't mean them to.

The way around this is to put a tilde character (~) in front of the words in question. If you put a tilde in front of ~CMSs it behaves like an ordinary word, same for ~Ctrl-B or ~TiddlyWiki or ~WikiWord. Click on Edit to see how this was done.

!!External Links
Type two square brackets either side of the url you want to link to. Inside the brackets, insert the text you want readers to see plus a 'post' character (|) before the url, like this """[[New York Times|http://www.nytimes.com]]""". 

''NB'' You must include """http://""" in the url.

!!Text links
Sometimes you want to create links where the reader can click on a word or phrase and be directed to a tiddler or an external website. 

For example, you might want to write click [[here|FormatText]] to learn how to format text. Or, you might want to write about something you saw in the [[Herald|http://www.nzherald.co.nz]] but not have to spell out the url for the Herald in the text. 

To do this, type two square brackets on either side of the tiddler name or url you want to link to. Inside the brackets, insert the text you want readers to see plus a 'post' character (|) before the tiddler name or url, like this """[[New York Times|http://www.nytimes.com]]""".

Click on 'new tiddler' on the top right-hand menu. A new tiddler will open in the main viewing area.

To name the tiddler, type over the words 'new tiddler' in the top text box.

Now you can type whatever you want into the main text box.

Once you're ready, click on Done (grey menu at top right of tiddler). The tiddler will display in read mode.

Seen a mistake? Just double click anywhere in the tiddler and it will open again in edit mode. Make your changes, and click Done again.

Want your new tiddler to appear on the menu? See [[Add Menu Item]]

Yep, it's a bit tricky that.

While you're working inside a tiddler, ~Ctrl-Z works just as you would expect. It will undo a string of actions (don't know how many, haven't counted).

But once you've closed the tiddler, which saves your changes, that's it. ~Ctrl-Z is effectively re-set to 0. In a nutshell, ~Ctrl-Z works inside tiddlers but not outside them.

Similarly, once you've deleted a tiddler, that's it. It's gone. There's no edit trail on ~TiddlyWiki. There are, however, backups so all is not necessarily lost.

The moral of the story is: be careful, save often and keep copies of key pieces of text elsewhere if you're going to be re-organising a lot of tiddlers and don't want to risk losing anything during a senior moment.

Oops. I've done it again.

I could have sworn I wrote a blog last week called Day Four: A (Fleeting) Splash of Colour.

Fleeting's right. It's disappeared already. Got up on small legs and scarpered.

No, not really. I just got caught in a classic double Tiddly trap - I thought I was working on my online version but I was really working on my offline version.

There I was, making a tweak or two on my offline version when I decided to hit Upload so the rest of the world could marvel at my tweaks.

As it turns out, though, I'd added the tweaks to an out-of-date offline version and it over-wrote the up-to-date online version, so my blog was obliterated.

Silly billy.

Saving, as it transpires, is something that requires one's full attention.

So, here's what I've learned since I put Tiddler Toddler online at [[Tiddlyspot|http://tiddlyspot.com]].

1. You have to create your Tiddlyspot TW in Tiddlyspot. You can't prepare one earlier and pull it out of the oven fully cooked and throw it online. But if you have prepared one earlier, all is not lost. See 3.

2. Once you've created your Tiddlyspot TW you can download a copy of it to your hard drive, and the two will stay linked for ever, like telepathic alien twins (only not evil or bent on world domination)

3. You can then, if you wish, transfer the contents of a TW you've prepared earlier into your new downloaded telepathic twin, and upload it to the online twin for all the world to see.

4. Next, you must figure out how to make the telepathic twins do what ''you'' want them to do, instead of what they've sensibly been programmed to do. This will come easily to you if you understand [[Fermat's Last Theorem|http://en.wikipedia.org/wiki/Fermat's_last_theorem]] and start every day with an invigorating algebra workout.

5. No idea what comes next. Still working on 4.

Anyway, I've just had a thought. Maybe my Day Four blog is lurking in a back-up file somewhere, and if it is, maybe I'll be able to figure out how to reinstate it to its rightful place.

Watch this space.

I feel clever. I have successfully followed Jeremy's dowload instructions and am now inside my very own TiddlyWiki. What a beautiful, clean little thing it is.

No idea what to do next.

Jeremy says I can't break anything so I click around.

I click on blue words that look like links, thinking 'ah, these will lead me to easy-peasy instructions on how to use this ~TiddlyWiki'. Instead a box opens saying 'this tiddler doesn't exist yet'.

Would I like to create it?

Um, don't know. I don't think so.

I spy 'new tiddler' over on the right.

I try to name my tiddler by highlighting the headline and typing over it, like I would in Word. Nothing happens. I click around some more.

I return to 'new tiddler' and this time notice that the words of the headline appear again in a text box immediately below it. A penny drops. I type my tiddler name in that text box. Marvellous. Inspired, I bang out some text in the main text box below it.

Now what? Hit Done, I guess. Done it is. By crikey, I have my first tiddler.

I decide I want to make the first line bold.

I can't find a bold button. ~Ctrl-B opens a bookmark menu. //Hmmm//. I need help. Back to the beginning, skim-read Jeremy's opening blurb, follow the links to Dave Gifford's wonderful [[TiddlyWiki for the Rest of Us|http://www.giffmex.org/twfortherestofus.html]].

I see something about formatting. It looks like putting double quote marks either side of a word will make it bold.
It doesn't. Que?

20 minutes later, having tried every single symbol key on my keyboard to see what it does, I discover bullet points and how to make a nice subhead using ! which I'm quite pleased with.

I also learn that a semi-colon at the beginning of a phrase will make the phrase bold. Still no idea how to make a single word bold.

I want to name my ~TiddlyWiki, but I can't figure out how. Off to tiddlywiki.org and assorted help files and look for 'name', 'title', 'big blue area at the top of the page'.

Nothing. Sigh.

Have another crack at formatting text, this time checking out Morris Gray's excellent [[TW Help - TiddlyWiki help file for beginners|http://tiddlyspot.com/twhelp/]]. Ah, turns out two single quotes before and after a word makes it bold, not a double quote. Easy once you know how.

I click on Close all and everything disappears. Wait a minute, what happened to those menu items I created?

All that's left is GettingStarted. I take another look at it. Suddenly everything falls into place, it's all right there, SiteTitle, SiteSubtitle, MainMenu and DefaultTiddlers. I'm away laughing.

Four hours later I have a perfectly nice little ~TiddlyWiki, basic to be fair, but with some nice simple formatting, a nifty little left-hand menu and my default tiddlers sorted.

I am as pleased as punch.

If my colleague is going to warm to ~TiddlyWiki, I'm going to have to make it easy for him to get up and running quickly. I make some simple instructions based on all the things I just spent four hours trying to figure out, and put them on the left-hand menu.

On the other hand, he might just read the instructions properly in the first place and get straight into the fun stuff.

I never did find Day Four: A (Fleeting) Splash of Colour. Looked through plenty of backup files but there was no sign of it (which shows up the weakness in backups - they're only as good as the person who has to try and find them). 

Yet I would swear, on anything you like, that I'd saved it, saved it, saved it and downloaded a local copy so there could be no possibility of loss.

I've no idea what it is I've been doing wrong but since I launched this ~TiddlyWiki on Tiddlyspot I've lost a lot of work.

I suspect the scale of the problem is directly proportional to how much Scrabulous I'm playing over on Facebook while I'm working on my ~TiddlyWiki - flitting back and forth between the two is clearly not something a beginner like me should be attempting.

My previous regime was to work on Tiddlyspot and download to my local copy at the end of each session. 

Now I'm going to try working in the local copy and uploading at the end of each session.

Fingers crossed.

Being an absolute beginner in TiddlyWorld is, for me, like being in a foreign country where few people speak English.  

It's a bit like being on the wrong bus at 4pm on the way out of Katowice, Poland - you know you're going somewhere, you're just not sure where or whether there'll be food and a bed there.

I don't really understand what people are talking about in TiddlyWorld, what with their Gimcrack'd servers and MonkeyPirates and Lewcidness, but I can get around, slowly, by watching what others do and picking out the few words and phrases I do know.

The sense of achievement some days is considerable; the loss of four hours' work just hurts.

I will persevere though, because I detect the promise of charming simplicity beneath this layer of learning. 

Anyway, having spent a fair few hours of my life formatting text for newspaper stories, I'm finding it no more or less cumbersome to shove a > in front of some text to indent it, than learn a shortcut or find a tool palette in InDesign that will do the trick.

And I love being able to carve up my work into manageable chunks.

And I love how fast it is to open a tiddler, edit it and see the changes. There's nought like instant gratification of an afternoon.

Have found Jim Ventor's tid-help a godsend and like what he's setting up for his students.

I think I have tiddly envy.

I create another TW as a place to document my faltering early steps and write and amass help files for newbie users like me. I want to use some of these help tiddlers on my main tiddlies.

I work for hours, creating the site, the menu,  a small raft of tiddlers containing simple instructions on how to format text, create menu items, create links. 

It is a thing of great beauty and all is right with the world.

I hit refresh on my browser toolbar. I don't know why.

'Are you sure you want to navigate away from this page?' Sure.

Eh?

Everything's gone. All of it. Gone. 

Note to self: SAVE, SAVE, SAVE 

Note to Jeremy: an edit trail? please?

I give up, pack up and go to the beach for two days. It seems to help.

[[Welcome]]
[[What's a TiddlyWiki?]]
[[How it Works]]

Open the tiddler for editing. Click on Delete (grey menu top right of tiddler).

Bye bye tiddler.

WikiWords - words with more than one capital letter - automatically work as links. They're a quick way of including links throughout your site.

But you don't have to use them.

To 'disable' the linking function of a WikiWord, put a tilde (~) in front of it. Then ~TiddlyWiki and any other ~WikiWord will behave like ordinary words. Click on Edit to have a look inside this tiddler to see how that was done.

Once you've [[created|Host a TiddlyWiki on Tiddlyspot]] a Tiddlyspot ~TiddlyWiki, you can download a local copy of it so you can work on it offline and later upload from the local copy to Tiddlyspot as and when you like. 

In the TiddlySpot ~TiddlyWiki, click on 'download' on the top right-hand menu and follow the instructions.

Type the text for 'Download a Local Copy of a Tiddlyspot TiddlyWiki'

To open a tiddler for editing, click on Edit (grey menu at top right of tiddler), or double click anywhere in the text.

You can now type in the tiddler. To find out how to format text - make words bold, italic etc - look at FormatText.

To save your edits, click on Done (grey menu at top right of tiddler). You must do this before navigating away from the page otherwise you may lose your work. 

Before leaving the site, click on Save Changes (right-hand top menu) This is important! (see [[blog|Tiddler Toddler's Blog]])

There are a few ways of finding a tiddler.
*Look on the main menu (that's the left-hand menu on this ~TiddlyWiki)
*Type a keyword or the tiddler's name in the search box (top right)  
*Select the All tab on the lower right-hand menu to see an alphabetical list of all tiddlers
*Select the Tags tab on the lower right-hand menu to see alphabetical list of tags
*Click on a tag (displayed in grey box in tiddler) to see and open other tiddlers with that tag

Got a brand new //Classic// ~TiddlyWiki? Great. 

You'll see a tiddler in front of you called GettingStarted.

In there are four key tiddlers to help you set up your ~TiddlyWiki.

In SiteTitle, you can give your ~TiddlyWiki Classic a name, which will appear in the header (the big blue space at the top of the page). Click [[here|Name TiddlyWiki]] to find out how.

In SiteSubtitle, you can give your ~TiddlyWiki a secondary name, or subtitle, which will also appear in the header (the smaller words up there). 

In MainMenu, you can list the tiddlers you want to see displayed in the menu, which for the moment is on the left-hand side of the page. Click [[here|Add Menu Item]] for more information on that.

In DefaultTiddlers, you can list the tiddlers you want to have automatically opened whenever you open your ~TiddlyWiki. Click [[here|Set Tiddlers to Open When TiddlyWiki Does]] to find out how.

You don't have to take care of all these right now, you can chip away at them whenever you're ready. Just make a note of the tiddler GettingStarted and you can always find it again (either by using the Search box - top right - or looking under the All tab on the lower right-hand menu).

Next, you'll need to enter a ''username'' which will appear on the tiddlers that you create or edit. Just type your name into the white box provided in DefaultTiddlers.

Now you'll want to get on with creating tiddlers. Here are a few help files to get you started. There are more on the left-hand menu and you can check out [[Get Help]] or go to [[tiddlywiki.org|tiddlywiki.org]] to look through the resources and [[FAQ|http://www.tiddlywiki.org/wiki/TiddlyWiki_FAQ]] there.

Good luck! 

[[Add Menu Item]]
[[Create Tiddler]]
[[Create Links]]
[[Delete Tiddler]]
[[Edit Tiddler]]
[[Find Tiddler]]
FormatText
[[Save TiddlyWiki]]
[[Tag Tiddler]]
[[WikiWords]]

Formatting, or styling, is often called markup, a term which also describes the formatting used to create links, make images display and so on. You'll find more [[TiddlyWiki markup|http://http://oldwiki.tiddlywiki.org/wiki/TiddlyWiki_Markup]] on the old documentation wiki. You can click on Edit (grey menu top right above tiddler) to look inside this tiddler and see how to create the formatting below. In fact, you can click inside any tiddler anywhere to see how the formatting was done.

;bold sentence 
''bold'' word (that's two single quote marks either side of the word, not one double quote mark)

''b''old le''t''ter (two single quote marks either side of the letter)

//italics// 

--Strike--

__Underline__

*bullet point
**bullet points
#numbered list
##numbered lists
!big headline
!!medium headline
!!!small headline
: indent text

>indent a block quote
>>further indent a block quote
>>>further indent a block quote 

To insert a horizontal rule, type """----""" (four hyphens).
----

There are plenty of useful guides around still for //Classic// ~TiddlyWiki. They include:
*Jim Ventola's [[TidHelp|http://tidhelp.tiddlyspot.com/]]
* Dave Gifford's [[TiddlyWiki for the Rest of Us|http://www.giffmex.org/twfortherestofus.html]]
* Morris Gray's [[TW Help - TiddlyWiki help file for beginners|http://tiddlyspot.com/twhelp/]]
* Screencasts from [[JimVentola|http://faculty.massasoit.mass.edu/jventola/videocasts/tidhelp2/tidhelp2.html]] and [[LeonKilat|http://max.limpag.com/2006/09/07/using-a-tiddlywiki-a-video-guide/]].

There are, I think, even more good guides for the latest version of ~TiddlyWiki (~TiddlyWiki5). You'll find out what you need about that at http://tiddlywiki.com.

There is a community [[documentation wiki|http://www.tiddlywiki.org/]], including a [[FAQ|http://www.tiddlywiki.org/wiki/TiddlyWiki_FAQ]].  And you can join the [[support forum|http://groups.google.com/group/TiddlyWiki]], which is an excellent place to ask questions and get help. Don't be put off if you notice some of the other questions are about way more advanced topics,  just dive in, the people are friendly and answer quickly.

Yep, this is do-able, thanks to Eric Shulman's [[TiddlyTools|http://www.tiddlytools.com/]].

What you want is the ~TiddlyTools ''~SinglePageModePlugin''.

Either import the [[SinglePageModePlugin|http://www.tiddlytools.com/#SinglePageModePlugin]] tiddler or copy its contents (the whole shebang) and create a tiddler called ~SinglePageModePlugin in your own ~TiddlyWiki to paste it into. Make sure you tag your new tiddler with systemConfig.

Save (don't miss this out!). Then refresh (you may need to do this to activate the plugin - I did).

Now go to Options>Advanced Options and you should see these:
:Display one tiddler at a time	
:Automatically permalink current tiddler	
:Always open tiddlers at the top of the page
Check the ones you want to apply. Close Advanced Options.

Job done.

To host a ~TiddlyWiki on Tiddlyspot, start by going to [[Tiddlyspot|http://tiddlyspot.com]]  and following the instructions. You can [[choose|Make Tiddlyspot TiddlyWiki Private]] whether you want other people to be able to see the ~TiddlyWIki, or only specific people that you have identified.

''You have to create the ~TiddlyWiki on Tiddlyspot'' (rather than creating it on your hard drive and uploading it to Tiddlyspot), but after that you can download a local copy to work on offline and upload  back to Tiddlyspot as and when you like. 

If you want to import tiddlers you've created elsewhere into Tiddlyspot, you'll have to import them into your local copy first then upload them.

Here's one way of doing so (there are more sophisticated methods - ask the folks at the [[mailing list|http://groups.google.com/group/TiddlyWiki]] - but this works):
#In the local copy (downloaded from Tiddlyspot by clicking 'download' on top right-hand menu) click on the 'backstage' button (top right corner in the header). 
#Select Import.
#Follow the instructions to find the file you want to Import from. Click on Open. A dialog box will open which displays a warning and asks you to Allow or Deny (at least that's what I get). 
#Choose Allow. 
#Now another box opens, titled Import Tiddlers from Another File or Server. Give the workspace a name, or choose default, and click on Open.
#Next a box will open which lists all the tiddlers in the ~TiddlyWiki you are importing from. Tick the boxes of the ones you want to import. Then click on Import.
#Another dialog box will open listing those tiddlers you've selected and showing progress of Import. It will say the Import is finished once it's done.
#Click on Close (top right corner, where you found the backstage button).
You should be able to see the tiddlers you've imported. To upload them to Tiddlyspot:
#Click on 'upload' (top right menu). You'll see another dialog box or two with a warning and buttons saying Allow or Deny. 
#Choose Allow. 
You should see a yellow box open now which says:
Backup saved
Main TiddlyWiki file saved
About to upload on http://tiddlywikiname.tiddlyspot.com/index.html ...

When it's done, it will also say this:
Main TiddlyWiki file uploaded

When you open the Tiddlyspot ~TiddlyWiki you should see the tiddlers you uploaded. (It might pay to close the local copy first, to avoid confusion - see [[blog|Day Five: Where Did Day Four Go?]].)

A ~TiddlyWiki is a file like any other, you can work on it, give it a name, [[save|Save TiddlyWiki]] it, close it and re-open it in the normal way. It's just like a document.

The only difference is that it is an html file. So when you save it, it will be given an .html extension (just as a Word file has a .doc extension and an Excel file has a .xls extension).

Html files open in a browser - Firefox, Internet Explorer, Safari - and this is where you work on them (just as .doc files open in Word and .xls files open in Excel).

You don't have to be connected to the internet to work on your ~TiddlyWiki. You can work in your browser even if you are offline. Either way, I'm told it works best in [[Firefox|http://www.mozilla-europe.org/en/products/firefox/]] which is what I use, and very happily too. 

If you do want your ~TiddlyWiki to be online, you can have it hosted for free at [[tiddlyspot.com|http://tiddlyspot.com]], or arrange to have it hosted elsewhere. It's then a website. You can [[choose|Make Tiddlyspot TiddlyWiki Private]] whether you want other people to be able to see it, or only specific people that you have identified.

Here are a few help files to get you started. There are more on the left-hand menu and you can check out [[Get Help]] or go to [[tiddlywiki.org|http://tiddlywiki.org]] to look through the resources and FAQ there.

[[First Steps]]
[[Add Menu Item]]
[[Create Tiddler]]
[[Create Links]]
[[Edit Tiddler]]
[[Find Tiddler]]
FormatText
[[Read Tiddler]]
[[Save TiddlyWiki]]
WikiWords

Here's a few things I've learned along the way. If you can't see what you want, try looking in the Tags menu on the right or typing a keyword into the search box (top right). Otherwise check out [[Get Help]] for links to other help sites or try the [[FAQ|http://www.tiddlywiki.org/wiki/TiddlyWiki_FAQ]] at tiddlywiki.org.


[[Add Dividing Line in Menu]]
[[Add Menu Item]]
[[Add Username]]
[[Autosave]]
[[Bold a word or phrase|FormatText]]
[[Change Colour of Header]]
[[Change the Look of My TiddlyWiki|Pimp My TiddlyWiki]]
[[Change Where My TiddlyWiki Backups Are Stored]]
[[Create Links]]
[[Create Tiddler]]
[[Disable WikiWords]]
[[Download Local Copy of Tiddlyspot TiddlyWiki]]
[[Edit Tiddler]]
[[Find Tiddler]]
[[Have Only One Tiddler Open at a Time]]
[[Host a TiddlyWiki on Tiddlyspot]]
[[Import Tiddlers]]
[[Import Tiddlers to Tiddlyspot]]
[[Include Alternate Text with Image]]
[[Indent a paragraph|FormatText]]
[[Indent Picture]]
[[Insert Picture]]
[[Italicise a word|FormatText]]
[[Learn Some HTML]]
[[Make Tiddlyspot TiddlyWiki Private]]
[[Name TiddlyWiki]]
[[Rename Tiddler]]
[[Resize Image on the Page]]
[[Set Tiddlers to Open When TiddlyWiki Does]]
[[Sign In to Tiddlyspot with Password]]
[[Stop the Word TiddlyWiki From Opening New Tiddlers]]
[[Stop WikiWords From Acting as Links]]
[[Track Visitors using Google Analytics]]
[[Upload to Tiddlyspot]]
[[Use CSS]]
[[Username]]
[[Use a Picture|Insert Picture]]
[[Write in Big Blue Space at Top of Page]]

If you were trying to add a rule, or dividing line, to your menu or tiddler and instead ended up with unsightly lines through subsequent text, check that you typed four hyphens to [[create the rule|Add Dividing Line in Menu]]. (Three hyphens creates a bit of a mess).

When you work on a Tiddlyspot ~TiddlyWiki you'll be asked to enter your password and username - your username will appear on the tiddlers you create and edit. You won't be able to save changes until you've entered this information.

Go to Options on the top right-hand menu. Enter your password. (The one you set when you created your Tiddlyspot ~TiddlyWiki). If you don't want to have to do this every time you log in, tick 'Save this password on this computer'. (If there are multiple users on your computer or you are using a public computer, you may want to leave the box unchecked.)

A little further down you'll see a white box in which you should write your username (the name you want to appear on tiddlers you create and edit).

That's it. There's no Done or Okay button. That's just set now. You can close the blue options box by clicking on Options again, or leave it open, whatever suits.

[[Ctrl-Z Won't Undo My Last Action]]
[[I'm Being Asked for a Password]]
[[I Wanted a Rule But Got Lines Through My Text]]
[[Menu Item Isn't Working as a Link]]
[[Tiddler Won't Open from the Menu]]

#Click on the 'backstage' button (top right corner in the header) and select Import. (Or go to More>~ImportTiddlers on the lower right-hand menu). 
#Follow the instructions to find the file you want to Import from. Click on Open. A dialog box will open with a kind of warning in it and asking you to Allow or Deny (at least that's what I get). 
#Choose Allow. 
#Now another box opens, titled Import Tiddlers from Another File or Server. Give the workspace a name, or choose default, and click on Open.
#Next a box will open which lists all the tiddlers in the ~TiddlyWiki you are importing from. Tick the boxes of the ones you want to import. Then click on Import.
#Another dialog box will open listing those tiddlers you've selected and showing progress of Import. It will say the Import is finished once it's done.
#Click on Close (top right corner, where you found the backstage button). 
You should be able to see the tiddlers you've imported.

You cannot import tiddlers directly into Tiddlyspot so you have to import them into a ''local copy'' of the hosted TiddlyWiki first, then upload them.

Here's one way of doing so (there are more sophisticated methods - see [[Get Help]] or check out the [[mailing list|http://groups.google.com/group/TiddlyWiki]] - but this works):
#Open the local copy of your Tiddlyspot ~TiddlyWiki. If you don't yet have a local copy, make one by clicking on 'download' on the top right menu and following the instructions.
#In the local copy, click on the 'backstage' button (top right corner in the header). 
#Select Import.
#Follow the instructions to find the file you want to Import from. Click on Open. A dialog box will open with a kind of warning in it and asking you to Allow or Deny (at least that's what I get). 
#Choose Allow. 
#Now another box opens, titled Import Tiddlers from Another File or Server. Give the workspace a name, or choose default, and click on Open.
#Next a box will open which lists all the tiddlers in the ~TiddlyWiki you are importing from. Tick the boxes of the ones you want to import. Then click on Import.
#Another dialog box will open listing those tiddlers you've selected and showing progress of Import. It will say the Import is finished once it's done.
#Click on Close (top right corner, where you found the backstage button).
You should be able to see the tiddlers you've imported. To upload them to Tiddlyspot:
#Click on 'upload' (top right menu). You'll see another dialog box or two with a warning and buttons saying Allow or Deny. 
#Choose Allow. 
You should see a yellow box open now which says:
Backup saved
Main TiddlyWiki file saved
About to upload on http://tiddlywikiname.tiddlyspot.com/index.html ...

When it's done, it will also say this:
Main TiddlyWiki file uploaded

When you open Tiddlyspot you should see the tiddlers you uploaded. (It might pay to close the local copy first to avoid confusion - see [[blog|Day Five: Where Did Day Four Go?]].)

Including alternate text means there's something there to read if the image does not load for some reason. You can do it like this:

"""[img["""//alternate text//"""|"""//filename or URL//"""]["""//link//]]"""

[img[Woman washing up outside Hanoi house|http://img95.imageshack.us/img95/1817/image023la9.jpg]]
This image has alternate text included, if you want to take a look inside this tiddler (click on Edit).

Want to know more about embedding images? Look at [[Insert Picture]].

You can get images to float to the left or the right of the text in your tiddler by using the following:

"""[<img["""//name of jpg in here//"""]""" to float left 
"""[>img["""//name of jpg in here//"""]""" to float right.

Pictures take up a fair amount of room so ~TiddlyWiki users often host their pictures externally on a site like [[Flickr|http://www.flickr.com]], [[Tinypic|http://tinypic.com/]] or [[ImageShack|http://imageshack.us/]]. The link for the picture can then be pasted into your tiddler, ~MainMenu or the header at the top of the page. You can [[resize|Resize Image on the Page]] them later if required.

You can either use a Direct Link (url) or HTML code (hosting sites generally provide both). 

>The formatting for ''Direct Link (url)'' is:
>"""[img["""//url of image goes in here//"""]]"""
>
>The formatting for ''HTML code'' is: 
>"""<html>"""//HTML code goes in here//"""</html>"""

[img[http://i39.tinypic.com/ffbjlx.jpg]]
;Flower seller, Kashmir
In this tiddler, the above picture uses formatting for a Direct Link (url). Open the tiddler to take a look, if you like.

You and me both.

I liked this tutorial at [[Simplehost.com|http://www.simplehost.com/tutorials/html.htm]]. Here's a couple of lists of tags which help me recognise what's going on:
;Some common single tags
     """<br> marks the end of a line. (stands for line break.)"""
     """<hr> marks a horizontal rule. (A line across the page.)"""
     """<img src=""> inserts an image. (The location of the image on your server goes between the quotation marks)""" 
"""
;Some common paired tags 
     <p> and </p> to start and close a paragraph.
     <b> and </b> for bold.
     <i> and </i> for italics.
     <em> and </em> for emphasis (usually interpreted as italics by the browser).
     <strong> and </strong> for strong text (usually interpreted as bold by the browser).
     <h1> and </h1> for the biggest heading.
     <ol> and </ol> for an ordered (numbered) list.
     <ul> and </ul> for an unordered (bulleted) list
     <font> and </font> for text font changes.
     <sup> and </sup> for superscript text.
     <sub> and </sub> for subscript text.
     <a href=""> and </a> for a hypertext reference. (The link location goes between the quotation marks)

/***
|''Name:''|LoadRemoteFileThroughProxy (previous LoadRemoteFileHijack)|
|''Description:''|When the TiddlyWiki file is located on the web (view over http) the content of [[SiteProxy]] tiddler is added in front of the file url. If [[SiteProxy]] does not exist "/proxy/" is added. |
|''Version:''|1.1.0|
|''Date:''|mar 17, 2007|
|''Source:''|http://tiddlywiki.bidix.info/#LoadRemoteFileHijack|
|''Author:''|BidiX (BidiX (at) bidix (dot) info)|
|''License:''|[[BSD open source license|http://tiddlywiki.bidix.info/#%5B%5BBSD%20open%20source%20license%5D%5D ]]|
|''~CoreVersion:''|2.2.0|
***/
//{{{
version.extensions.LoadRemoteFileThroughProxy = {
 major: 1, minor: 1, revision: 0, 
 date: new Date("mar 17, 2007"), 
 source: "http://tiddlywiki.bidix.info/#LoadRemoteFileThroughProxy"};

if (!window.bidix) window.bidix = {}; // bidix namespace
if (!bidix.core) bidix.core = {};

bidix.core.loadRemoteFile = loadRemoteFile;
loadRemoteFile = function(url,callback,params)
{
 if ((document.location.toString().substr(0,4) == "http") && (url.substr(0,4) == "http")){ 
  url = store.getTiddlerText("SiteProxy", "/proxy/") + url;
 }
 return bidix.core.loadRemoteFile(url,callback,params);
}
//}}}

[[Welcome]] to 
Tiddler Toddler, a starting point for new users of ''Classic ~TiddlyWiki''
For information on the //latest version// of ~TiddlyWiki see http://tiddlywiki.com
----
[[Tiddler Toddler's Blog]]
-----
[[What's a TiddlyWiki?]]
[[How it Works]]
[[First Steps]]
----
[[Add Menu Item]]
[[Colour]]
[[Create Links]]
[[Create Tiddler]]
[[Delete Tiddler]]
[[Edit Tiddler]]
[[Find Tiddler]]
FormatText
[[Get Help]]
[[Name TiddlyWiki]]
[[Host a TiddlyWiki on Tiddlyspot]]
[[Insert Picture]]
[[Pimp My TiddlyWiki]]
[[Read Tiddler]]
[[Save TiddlyWiki]]
[[Tag Tiddler]]
WikiWords
----
[[I Want To...]]
[[I've Got a Problem]]
----
[[Save Your Work!]]
----
[[About Julie]]
[[Contact Julie]]

When you first started your Tiddlyspot ~TiddlyWiki, you would have seen a tiddler called WelcomeToTiddlyspot. In there is a link to your Control Panel. (If you can't find it, try the search box or the All tab on the lower right-hand menu).

Click on that link and the Control Panel opens. There are two privacy settings; just tick the one you want. One option is to make it private, which means only you or people you've named can use it, and the other is public, which means other people can see your ~TiddlyWiki and it may end up being listed on a public directory.

<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
</script>
<script type="text/javascript">
try {
var pageTracker = _gat._getTracker("UA-6859165-2");
pageTracker._trackPageview();
} catch(err) {}</script>

There's something about ~TiddlyWiki that brings out the tinkerer within. I've spent a bit of time browsing the ~TiddlyWiki [[mailing list|http://groups.google.com/group/TiddlyWiki]] lately and have noticed a distinct tendancy for people to:

a/   spend a lot of time on their ~TiddlyWikis
b/   buff out their ~TiddlyWikis with stuff that looks really good 
c/   hone their ~TiddlyWikis with stuff that works really well 
d/   spend a lot of time on their ~TiddlyWikis

Just check out this [[thread|http://groups.google.com/group/TiddlyWiki/browse_thread/thread/63c4c9d759a531d8/4eac15cd05fd85c9?hl=en&lnk=gst&q=fun#4eac15cd05fd85c9]]  if you don't believe me. It started in response to a survey Alec Hough started, asking why people used ~TiddlyWiki and what they got out of it. It's a great read. Eric Shulman, whose giant brain brings us [[Tiddlytools|http://www.tiddlytools.com/]], puts it nicely: 

>Someone once referred to it as ~FiddlyWiki: "...cause it's just so easy to spend the whole day fiddlin' around with it, instead of getting other work done!" Personally, working on my own ~TiddlyWiki document has kept me occupied for over 2 1/2 YEARS so far... and ~TiddlyTools is the result... so at least it seems to have been a *useful* consumption of time. I expect that, in the long run, once someone sets up their TW document arrangement to suits their needs, with all the right plugins and layouts, etc., they don't spend nearly as much time "~TiddlyHacking", and focus more on producing useful ~TiddlyWiki content. ''It's just that the initial setup and tweaking is so much fun! :-)''.  

It reminds me of [[meccano|http://www.flickr.com/search/?q=meccano&w=all]]. Remember the feeling you got when you'd painstakingly built a big crane, and there it stood, all finished and impressive looking and with moving parts. And you felt good. You had built a crane. A crane! A thing of use and consequence and just like a real one! 

I reckon that's what building a top-shelf ~TiddlyWIki feels like. Well, in my case, a bottom shelf ~TiddlyWiki with top-shelf aspirations. Mine aren't terribly far along the ~TiddlyWiki evolutionary path, and yet I take pride in them. 

It's like the building is the best part. I expect people have the ~TiddlyWiki equivalent of empty nest syndrome when a fledgling finally reaches the stage where any more buffing out would be to its detriment. I suspect the solution is to dive headlong into another ~TiddlyWiki development at the first opportunity.

When you add a tiddler to your menu, it will automatically work as a link if it is a WikiWord. If it's not, you need to put two square brackets on either side of the tiddler's name [[like this]].

To give your ~TiddlyWiki a name, find the tiddler SiteTitle. It was in GettingStarted which you would have seen when you first downloaded your ~TiddlyWiki, but you can also find it by using the search box (top right) or looking in the lower right-hand menu - click on the All tab to see an alphabetical list of tiddlers. 

Open SiteTitle for editing and type the name of your ~TiddlyWiki in the main text box (the big one below the yellow box which says 'this shadow tiddler...')

Click on Done (grey menu at top right of tiddler). You should see the name in the big blue space at the top of the page - which, incidentally, is called the header.

To give your ~TiddlyWiki a secondary name, or subtitle - the smaller writing in the header - find and open the tiddler SiteSubtitle and type into the main text box.

<!--{{{-->
<div class='header' macro='gradient vert #014'>
<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>
<!--}}}-->

You can change the way your ~TiddlyWiki looks by using themes. 

Alternatively, you can change how individual elements of your ~TiddlyWIki look - such as the colour of the header at the top of the page or where the menu sits - by tweaking or inserting handy bits of code into certain shadow tiddlers (these come standard with every ~TiddlyWiki).

Aside from changing the [[colour of the header|Change Colour of Header]], I can't help much with code, so try [[Get Help]], the [[mailing list|http://groups.google.com/group/TiddlyWiki]] and the [[documentation wiki|http://www.tiddlywiki.org]].

In this ~TiddlyWiki, all the tiddlers are listed on the left-hand menu. In some ~TiddlyWikis they may be listed in a horizontal menu at the top of the page.

Click on the menu link to read the tiddler. 

If you only want one tiddler open, click on Close Others (grey menu at top right of tiddler) 

If you want to close the tiddler you are currently reading, click on Close (grey menu at top right of tiddler) 

You can have one, several, or all tiddlers open to read at one time.

If you want to close all of them, click on Close All on the right-hand top menu.

[[Links like this|Welcome]] take you to other tiddlers on the page; a [[plain link|http://www.google.com]] takes you to an external website. Check out [[Create Links]] to find out how to do this.

You can search the site using key words (search box is top right) or scroll through the Timeline, All or Tags on the lower right-hand menu. See also [[Find Tiddler]].

No problem. Open the tiddler for editing.
Delete the old name. Type in the new name.
Click on Done.
Your tiddler is now renamed.
Next, amend the name on the MainMenu and in any other tiddlers that link to the one you've just renamed.

If you've inserted an image and the hosting site size isn't quite right, you can resize it on the page to line up with text, your menu, whatever.

Let's take this picture of a Maori meeting house at Whakarewarewa village in Rotorua, New Zealand.

<html>
<a href="http://picasaweb.google.co.uk/starrjulie/RoadTrip/photo?authkey=K91fkiIR8D0#5111815981831504034"><img src="http://lh5.google.co.uk/starrjulie/RvDRjUo7QKI/AAAAAAAAAt0/VXWY-7Ch4Ts/s288/DSC01539.JPG" style="width: 130px;"/></a></html>

Here's the html code to display it:

"""<html>
<a href="http://picasaweb.google.co.uk/starrjulie/RoadTrip/photo?authkey=K91fkiIR8D0#5111815981831504034"><img src="http://lh5.google.co.uk/starrjulie/RvDRjUo7QKI/AAAAAAAAAt0/VXWY-7Ch4Ts/s288/DSC01539.JPG" /></a></html>"""


To change its dimensions, insert ''//"""style="width: 70px;" """//'' just before ''//"""/></a></html>"""//''. Now it looks like this:

<html>
<a href="http://picasaweb.google.co.uk/starrjulie/RoadTrip/photo?authkey=K91fkiIR8D0#5111815981831504034"><img src="http://lh5.google.co.uk/starrjulie/RvDRjUo7QKI/AAAAAAAAAt0/VXWY-7Ch4Ts/s288/DSC01539.JPG" style="width: 70px;"/></a></html>

Experiment with the width (100px, 130px etc) until you get what you want. You can use ''//"""style="height: 140px;" """//'' instead if height's an easier measure to deal with. This process won't morph the picture but works better going from big to small.

//Thanks to Morris Gray's [[help site|http://tiddlyspot.com/twhelp/#Images]] for this top tip.//

A ~TiddlyWiki is a file just like any other. You can save it onto your hard drive or a USB memory stick just like you would a Word file or an Excel file.

The only difference is, where a Word file has .doc after its name, and an Excel file has .xls after its name, a ~TiddlyWiki file will have .html after its name, because it is an html file.

Html files automatically open in your browser - Firefox, say, or Internet Explorer - which is where you work on them (just like.doc files open in Word and .xls files open in Excel).

In my experience, it pays to save fairly regularly. There is an [[autosave|Autosave]] option if you're the forgetful type.

;Save to hard drive
Click on 'save changes' (right-hand top menu). A box will open asking where you want to save it.

Name the file, select the location - perhaps in a folder in Documents or My Documents - and click on Save.

The document will be saved with the name you've given it and an .html extension. So, if you name the file mytiddly, you will see it listed in the folder as mytiddly.html.

When you want to open it again, just click on it like you would on any other file and it will open up in your browser and you will be able to go on working on it.

;Save to memory stick
Clcik on 'save changes' (right-hand top menu). A dialog box will open asking where you want to save it.

Name the file, select your memory stick drive as the location and click on Save.

The document will be saved with the name you've given it and an .html extension.

; Save to ~TiddlySpot
If you're hosting a ~TiddlyWiki on [[Tiddlyspot|http://tiddlyspot.com]], click on 'save to web' on right-hand top menu. A yellow dialog box appears which says "About to upload on """http://"""// tiddlywiki name//""".tiddlyspot.com/index.html ..."""" Soon after it should say "Main ~TiddlyWiki file uploaded".

Your work is now saved.

If, however, you go to navigate away from the site or hit Refresh on your browser and you get a message saying 'there are unsaved changes... are you sure you want to navigate away from the page?' it means you've made a change since the last Save or it isn't saving properly for some reason.

Try again (and you might want to save a copy to your hard drive as a precaution).

If you're still having trouble, have a look at the help files on [[tiddlywiki.org|http://www.tiddlywiki.org]] or dive into the [[mailing list|http://groups.google.com/group/TiddlyWiki]] and ask for help - there are lots of people with big brains who answer questions surprisingly quickly.

Speaking from experience, there's nothing worse than working away for an hour or so then losing everything. So....
#Click Done when you've been editing a tiddler before you navigate away from a page
#Save regularly 
#Click on 'save changes' on top right menu before leaving your ~TiddlyWiki
#Click on 'save to web' on top right menu if you're working on a ~TiddlyWiki hosted at Tiddlyspot
#Don't refresh your browser unless you have saved your work
#Back up copies to your hard drive from time to time

These are called default tiddlers. Open Default Tiddler for editing (it was in GettingStarted but you can also find it by searching or looking in the More>Shadowed tabs on the lower right-hand menu.

Type the names of the tiddlers you want people to see when they first land on your ~TiddlyWiki. Include double square brackets on either side of the tiddler names to make it a link """[[like this]]""". If it's a [[WikiWord|WikiWords]] you don't need to add the brackets.

config.options.txtUserName = "Julie"

When you work on a Tiddlyspot ~TiddlyWiki you'll be asked to enter your password and username - which will appear on the tiddlers you create and edit. You won't be able to save changes until you've entered this information.

Go to Options on the top right-hand menu. Enter your password. (The one you set when you created your Tiddlyspot ~TiddlyWiki). If you don't want to have to do this every time you log in, tick 'Save this password on this computer'. (If there are multiple users on your computer or you are using a public computer, you may want to leave the box unchecked.)

A little further down you'll see a white box in which you should write your username (the name you want to appear on tiddlers you create and edit).

That's it. There's no Done or Okay button. That's just set now. You can close the blue options box by clicking on Options again, or leave it open, whatever suits.

an absolute beginner's guide to //Classic// ~TiddlyWiki 
The information here applies to "classic" ~TiddlyWiki. For information on the //latest version// of ~TiddlyWiki (~TiddlyWiki5), please visit http://tiddlywiki.com.

<html><a href="http://picasaweb.google.co.uk/starrjulie/BloggerPictures/photo?authkey=B8itStkmiUo#5146996319475930082"><img src="http://lh6.google.co.uk/starrjulie/R23N4fKbE-I/AAAAAAAAB5M/guiF7TfsCKk/s144/DSC01688.JPG"  style="width: 130px; "/></a></html>     Tiddler Toddler

WikiWords - words with more than one capital letter - automatically work as links. They're a quick way of including links throughout your site.

But you don't have to use them.

To 'disable' the linking function of a ~WikiWord, put a tilde (~) in front of it. Then ~TiddlyWiki and any other ~WikiWord will behave like ordinary words. Click on Edit to have a look inside this tiddler to see how that was done.

TiddlyWiki is a WikiWord - a word with more than one capital letter which automatically works as a link. Using WikiWords is a quick way of including links on your site.

But you don't have to use them.

To 'disable' the linking function of a WikiWord, put a tilde (~) in front of it. Then ~TiddlyWiki and any other ~WikiWord will behave like ordinary words. Click on Edit to have a look inside this tiddler to see how that was done.

.floatright{float:right;padding:5px}

Tags make life easier, plain and simple. 

If you attach a few well-chosen describing words to a tiddler, your chances of finding it months later when you've forgotten its name are greatly enhanced. Likewise for your fellow ~TiddlyWiki users. 

Tags also allow you to link related tiddlers and search or view all tiddlers with a common tag.

To tag a tiddler, open it for editing and head for the bottom-most box. Type the tags with a space between each one. Click on Done. 

You'll see the tags displayed in a grey box. Click on any one to see a list of tiddlers which share that tag; click to open one or all of them. There's a complete list of the ~TiddlyWiki's tags under the Tags tab on the lower right-hand menu.

To get more out of your tags and better organise information check out ''~TagglyTagging''. This highly readable [[tutorial|http://mptw.tiddlyspot.com/#%5B%5BTagglyTagging%20Tutorial%5D%5D]] explains it. Beyond that, try the [[documentation wiki|http://www.tiddlywiki.org]] or the folks at the [[mailing list|http://groups.google.com/group/TiddlyWiki]] for more information.

There's nothing like reading about someone else's mistakes to make you feel better about your own. So here's a blow-by-blow account of my hits and misses in Classic ~TiddlyWiki world.

[[Meccano for grown-ups]]
[[Colour me #014]]
[[TiddlyWiki Makeover]]
[[Day Six: One Thing at a Time]]
[[Day Five: Where Did Day Four Go?]]
[[Day Four: A (Fleeting) Splash of Colour]]
[[Day Three: Learning the Language]]
[[Day Two: Learning Cliff]]
[[Day One: Learning Curve]]

Make sure the name of the tiddler is exactly right on the Menu. If even one character is awry, the menu link won't be able to find the tiddler to display.

Check there are no rogue spaces, the wording is exactly the same, and the right letters are capitalised.

For example, if you added the tiddler Big ''l''ittle to the MainMenu, but the tiddler title is Big ''L''ittle, you'll have a problem.

If you go to navigate away from the site or hit Refresh on your browser and you get a message saying 'there are unsaved changes... are you sure you want to navigate away from the page?' it means you've made a change since the last Save or that it isn't saving properly for some reason.

Try saving again. Also, you might want to save a local copy of the TW at this point, to your hard drive. 

If you're still having trouble saving, have a look at the help files on [[tiddlywiki.org|http://www.tiddlywiki.org]] or dive into the  [[mailing list|http://groups.google.com/group/TiddlyWiki]] and ask for help.

If all else fails, you can always copy tiddlers across manually from your saved local file.

I have an overwhelming urge to prettify my ~TiddlyWiki.

Not that it isn't a thing of great beauty already, it is. In fact, one of the things I first liked about ~TiddlyWiki was its text formatting. It makes you look good without trying - like you've spent a few days auditioning colours and fonts before settling on a subtle but stylish brown for headlines, streamlined grey rules and a smart but sturdy sans-serif for workaday text.

No, I think it's the lack of pictures. The newspaper sub in me is jumping up and down over the text-heavy layout. Where are the breakout quotes, it asks? The pictures, the captions, the slideshows, sidebars, tint boxes?

Easier visualised than done, however. At least in my case.

Things I've effortlessly achieved over on Blogger I'm going to have to get hands-on with over here. Still, nothing like a challenge.

First hurdle: what pictures? How on earth does one illustrate a ~TiddlyWiki help site? Screen grabs of tagging/editing/formatting tiddlers are going to get tired fairly smartly.

I could, I suppose, pepper the site with my favourite holiday snaps (and in fact I have indulged myself slightly in [[Insert Picture]]) but that's not really a goer everywhere.

Oh well, maybe I'll start with a picture in the menu (that's possible, right?) and a tint box or two.

Anyway, the good news is that my current saving regime (touch wood) seems to be working well. I'm working on my local copy of this ~TiddlyWiki and uploading to Tiddlyspot as I go.

No idea why I got so tied in knots when I was doing it the other way round. Actually, I have a few ideas, I just can't seem to articulate them succinctly. I'll have another go sometime... when I find the strength.

Copy the tracking code provided by Google Analytics and paste it into the shadow tiddler MarkupPostHead tiddler. Look at the More tab on the right-hand menu and click on Shadowed to find MarkupPostHead.

This is an excerpt from [[Phil Hawksworth's blog|http://www.hawksworx.com/journal/2007/07/05/tracking-tiddlywiki-with-google-analytics/]] that explains more.

>After signing up for a free Google Analytics account, it is a simple task to start tracking the hits on your site. You just need to add the javascript code that google generates for you onto into your code. The best way to do this in ~TiddlyWiki, is to modify the MarkupPostHead tiddler. This tiddler exists precisely for this kind of task. It inserts code into the end of the Head of your TiddlyWiki page.
>The code you insert here looks something like this:
<script src="http://www.google-analytics.com/urchin.js" type="text/javascript">
</script;
<script type="text/javascript">
  _uacct = "UA-123456789";
  urchinTracker(); ;/script>
>With this code in place, Google will start collecting information about the traffic to your site and present it to you via your Google Analytics account. But there is a problem, and that is that you really want to know what content your visitors are looking at within your site. You want their navigation in your site to be recorded too. On a traditional site, that’s no problem. Each page just has this same bit of javascript included and Google can register hits on each page. In TiddlyWiki however, everything happens within a single page so this kind of mechanism won’t quite do the job.
>Thankfully both Google Analytics and TiddlyWiki are flexible enough for us to find a pretty [[simple solution|http://www.hawksworx.com/journal/2007/07/05/tracking-tiddlywiki-with-google-analytics/#more-11]].

/***
Contains the stuff you need to use Tiddlyspot
Note you must also have UploadPlugin installed
***/
//{{{

// edit this if you are migrating sites or retrofitting an existing TW
config.tiddlyspotSiteId = 'tiddlertoddler';

// make it so you can by default see edit controls via http
config.options.chkHttpReadOnly = false;
window.readOnly = false; // make sure of it (for tw 2.2)

// disable autosave in d3
if (window.location.protocol != "file:")
	config.options.chkGTDLazyAutoSave = false;

// tweak shadow tiddlers to add upload button, password entry box etc
with (config.shadowTiddlers) {
	SiteUrl = 'http://'+config.tiddlyspotSiteId+'.tiddlyspot.com';
	SideBarOptions = SideBarOptions.replace(/(<<saveChanges>>)/,"$1<<tiddler TspotSidebar>>");
	OptionsPanel = OptionsPanel.replace(/^/,"<<tiddler TspotOptions>>");
	DefaultTiddlers = DefaultTiddlers.replace(/^/,"WelcomeToTiddlyspot]] ");
	MainMenu = MainMenu.replace(/^/,"[[WelcomeToTiddlyspot]] ");
}

// create some shadow tiddler content
merge(config.shadowTiddlers,{

'WelcomeToTiddlyspot':[
 "This document is a ~TiddlyWiki from tiddlyspot.com.  A ~TiddlyWiki is an electronic notebook that is great for managing todo lists, personal information, and all sorts of things.",
 "",
 "@@font-weight:bold;font-size:1.3em;color:#444; //What now?// &nbsp;&nbsp;@@ Before you can save any changes, you need to enter your password in the form below.  Then configure privacy and other site settings at your [[control panel|http://" + config.tiddlyspotSiteId + ".tiddlyspot.com/controlpanel]] (your control panel username is //" + config.tiddlyspotSiteId + "//).",
 "<<tiddler TspotControls>>",
 "See also GettingStarted.",
 "",
 "@@font-weight:bold;font-size:1.3em;color:#444; //Working online// &nbsp;&nbsp;@@ You can edit this ~TiddlyWiki right now, and save your changes using the \"save to web\" button in the column on the right.",
 "",
 "@@font-weight:bold;font-size:1.3em;color:#444; //Working offline// &nbsp;&nbsp;@@ A fully functioning copy of this ~TiddlyWiki can be saved onto your hard drive or USB stick.  You can make changes and save them locally without being connected to the Internet.  When you're ready to sync up again, just click \"upload\" and your ~TiddlyWiki will be saved back to tiddlyspot.com.",
 "",
 "@@font-weight:bold;font-size:1.3em;color:#444; //Help!// &nbsp;&nbsp;@@ Find out more about ~TiddlyWiki at [[TiddlyWiki.com|http://tiddlywiki.com]].  Also visit [[TiddlyWiki Guides|http://tiddlywikiguides.org]] for documentation on learning and using ~TiddlyWiki. New users are especially welcome on the [[TiddlyWiki mailing list|http://groups.google.com/group/TiddlyWiki]], which is an excellent place to ask questions and get help.  If you have a tiddlyspot related problem email [[tiddlyspot support|mailto:support@tiddlyspot.com]].",
 "",
 "@@font-weight:bold;font-size:1.3em;color:#444; //Enjoy :)// &nbsp;&nbsp;@@ We hope you like using your tiddlyspot.com site.  Please email [[feedback@tiddlyspot.com|mailto:feedback@tiddlyspot.com]] with any comments or suggestions."
].join("\n"),

'TspotControls':[
 "| tiddlyspot password:|<<option pasUploadPassword>>|",
 "| site management:|<<upload http://" + config.tiddlyspotSiteId + ".tiddlyspot.com/store.cgi index.html . .  " + config.tiddlyspotSiteId + ">>//(requires tiddlyspot password)//<<br>>[[control panel|http://" + config.tiddlyspotSiteId + ".tiddlyspot.com/controlpanel]], [[download (go offline)|http://" + config.tiddlyspotSiteId + ".tiddlyspot.com/download]]|",
 "| links:|[[tiddlyspot.com|http://tiddlyspot.com/]], [[FAQs|http://faq.tiddlyspot.com/]], [[announcements|http://announce.tiddlyspot.com/]], [[blog|http://tiddlyspot.com/blog/]], email [[support|mailto:support@tiddlyspot.com]] & [[feedback|mailto:feedback@tiddlyspot.com]], [[donate|http://tiddlyspot.com/?page=donate]]|"
].join("\n"),

'TspotSidebar':[
 "<<upload http://" + config.tiddlyspotSiteId + ".tiddlyspot.com/store.cgi index.html . .  " + config.tiddlyspotSiteId + ">><html><a href='http://" + config.tiddlyspotSiteId + ".tiddlyspot.com/download' class='button'>download</a></html>"
].join("\n"),

'TspotOptions':[
 "tiddlyspot password:",
 "<<option pasUploadPassword>>",
 ""
].join("\n")

});
//}}}

Once you've [[created|Host a TiddlyWiki on Tiddlyspot]] a Tiddlyspot ~TiddlyWiki, you can download a local copy to work on while you're offline. You can then upload from the local copy to Tiddlyspot as and when you like. 

''NB'' The upload will only work from a downloaded copy of your Tiddlyspot ~TiddlyWiki. You cannot import/upload tiddlers to Tiddlyspot from an unrelated ~TiddlyWiki. If you haven't downloaded a copy yet, go to your Tiddlyspot ~TiddlyWiki and click on Download (top right menu).

To upload from your local copy, click on Upload (top right menu). You'll see a yellow box open which says:  
Backup Saved
Main ~TiddlyWiki File Saved
About to upload on """http://"""//name of ~TiddlyWiki//""".tiddlyspot.com/index.html ...

When it's done it will say:
Main ~TiddlyWiki File Uploaded.

You can close the local copy now and go to Tiddlyspot to see your changes.

| !date | !user | !location | !storeUrl | !uploadDir | !toFilename | !backupdir | !origin |
| 03/06/2013 18:52:33 | Julie | [[/|http://tiddlertoddler.tiddlyspot.com/]] | [[store.cgi|http://tiddlertoddler.tiddlyspot.com/store.cgi]] | . | [[index.html | http://tiddlertoddler.tiddlyspot.com/index.html]] | . |
| 09/06/2013 23:07:31 | Julie | [[/|http://tiddlertoddler.tiddlyspot.com/]] | [[store.cgi|http://tiddlertoddler.tiddlyspot.com/store.cgi]] | . | [[index.html | http://tiddlertoddler.tiddlyspot.com/index.html]] | . | ok |
| 09/06/2013 23:27:11 | Julie | [[/|http://tiddlertoddler.tiddlyspot.com/]] | [[store.cgi|http://tiddlertoddler.tiddlyspot.com/store.cgi]] | . | [[index.html | http://tiddlertoddler.tiddlyspot.com/index.html]] | . |
| 13/03/2014 11:11:49 | Julie | [[/|http://tiddlertoddler.tiddlyspot.com/]] | [[store.cgi|http://tiddlertoddler.tiddlyspot.com/store.cgi]] | . | [[index.html | http://tiddlertoddler.tiddlyspot.com/index.html]] | . | failed |
| 13/03/2014 11:12:22 | Julie | [[/|http://tiddlertoddler.tiddlyspot.com/]] | [[store.cgi|http://tiddlertoddler.tiddlyspot.com/store.cgi]] | . | [[index.html | http://tiddlertoddler.tiddlyspot.com/index.html]] | . | ok |
| 13/03/2014 11:16:25 | Julie | [[/|http://tiddlertoddler.tiddlyspot.com/]] | [[store.cgi|http://tiddlertoddler.tiddlyspot.com/store.cgi]] | . | [[index.html | http://tiddlertoddler.tiddlyspot.com/index.html]] | . |
| 05/12/2014 14:56:16 | Julie | [[/|http://tiddlertoddler.tiddlyspot.com/]] | [[store.cgi|http://tiddlertoddler.tiddlyspot.com/store.cgi]] | . | [[index.html | http://tiddlertoddler.tiddlyspot.com/index.html]] | . |
| 05/12/2014 15:21:26 | Julie | [[/|http://tiddlertoddler.tiddlyspot.com/]] | [[store.cgi|http://tiddlertoddler.tiddlyspot.com/store.cgi]] | . | [[index.html | http://tiddlertoddler.tiddlyspot.com/index.html]] | . | ok |
| 05/12/2014 15:30:01 | Julie | [[/|http://tiddlertoddler.tiddlyspot.com/]] | [[store.cgi|http://tiddlertoddler.tiddlyspot.com/store.cgi]] | . | [[index.html | http://tiddlertoddler.tiddlyspot.com/index.html]] | . | ok |
| 05/12/2014 15:41:12 | Julie | [[/|http://tiddlertoddler.tiddlyspot.com/]] | [[store.cgi|http://tiddlertoddler.tiddlyspot.com/store.cgi]] | . | [[index.html | http://tiddlertoddler.tiddlyspot.com/index.html]] | . |

/***
|''Name:''|PasswordOptionPlugin|
|''Description:''|Extends TiddlyWiki options with non encrypted password option.|
|''Version:''|1.0.2|
|''Date:''|Apr 19, 2007|
|''Source:''|http://tiddlywiki.bidix.info/#PasswordOptionPlugin|
|''Author:''|BidiX (BidiX (at) bidix (dot) info)|
|''License:''|[[BSD open source license|http://tiddlywiki.bidix.info/#%5B%5BBSD%20open%20source%20license%5D%5D ]]|
|''~CoreVersion:''|2.2.0 (Beta 5)|
***/
//{{{
version.extensions.PasswordOptionPlugin = {
	major: 1, minor: 0, revision: 2, 
	date: new Date("Apr 19, 2007"),
	source: 'http://tiddlywiki.bidix.info/#PasswordOptionPlugin',
	author: 'BidiX (BidiX (at) bidix (dot) info',
	license: '[[BSD open source license|http://tiddlywiki.bidix.info/#%5B%5BBSD%20open%20source%20license%5D%5D]]',
	coreVersion: '2.2.0 (Beta 5)'
};

config.macros.option.passwordCheckboxLabel = "Save this password on this computer";
config.macros.option.passwordInputType = "password"; // password | text
setStylesheet(".pasOptionInput {width: 11em;}\n","passwordInputTypeStyle");

merge(config.macros.option.types, {
	'pas': {
		elementType: "input",
		valueField: "value",
		eventName: "onkeyup",
		className: "pasOptionInput",
		typeValue: config.macros.option.passwordInputType,
		create: function(place,type,opt,className,desc) {
			// password field
			config.macros.option.genericCreate(place,'pas',opt,className,desc);
			// checkbox linked with this password "save this password on this computer"
			config.macros.option.genericCreate(place,'chk','chk'+opt,className,desc);			
			// text savePasswordCheckboxLabel
			place.appendChild(document.createTextNode(config.macros.option.passwordCheckboxLabel));
		},
		onChange: config.macros.option.genericOnChange
	}
});

merge(config.optionHandlers['chk'], {
	get: function(name) {
		// is there an option linked with this chk ?
		var opt = name.substr(3);
		if (config.options[opt]) 
			saveOptionCookie(opt);
		return config.options[name] ? "true" : "false";
	}
});

merge(config.optionHandlers, {
	'pas': {
 		get: function(name) {
			if (config.options["chk"+name]) {
				return encodeCookie(config.options[name].toString());
			} else {
				return "";
			}
		},
		set: function(name,value) {config.options[name] = decodeCookie(value);}
	}
});

// need to reload options to load passwordOptions
loadOptionsCookie();

/*
if (!config.options['pasPassword'])
	config.options['pasPassword'] = '';

merge(config.optionsDesc,{
		pasPassword: "Test password"
	});
*/
//}}}

/***
|''Name:''|UploadPlugin|
|''Description:''|Save to web a TiddlyWiki|
|''Version:''|4.1.0|
|''Date:''|May 5, 2007|
|''Source:''|http://tiddlywiki.bidix.info/#UploadPlugin|
|''Documentation:''|http://tiddlywiki.bidix.info/#UploadPluginDoc|
|''Author:''|BidiX (BidiX (at) bidix (dot) info)|
|''License:''|[[BSD open source license|http://tiddlywiki.bidix.info/#%5B%5BBSD%20open%20source%20license%5D%5D ]]|
|''~CoreVersion:''|2.2.0 (#3125)|
|''Requires:''|PasswordOptionPlugin|
***/
//{{{
version.extensions.UploadPlugin = {
	major: 4, minor: 1, revision: 0,
	date: new Date("May 5, 2007"),
	source: 'http://tiddlywiki.bidix.info/#UploadPlugin',
	author: 'BidiX (BidiX (at) bidix (dot) info',
	coreVersion: '2.2.0 (#3125)'
};

//
// Environment
//

if (!window.bidix) window.bidix = {}; // bidix namespace
bidix.debugMode = false;	// true to activate both in Plugin and UploadService
	
//
// Upload Macro
//

config.macros.upload = {
// default values
	defaultBackupDir: '',	//no backup
	defaultStoreScript: "store.php",
	defaultToFilename: "index.html",
	defaultUploadDir: ".",
	authenticateUser: true	// UploadService Authenticate User
};
	
config.macros.upload.label = {
	promptOption: "Save and Upload this TiddlyWiki with UploadOptions",
	promptParamMacro: "Save and Upload this TiddlyWiki in %0",
	saveLabel: "save to web", 
	saveToDisk: "save to disk",
	uploadLabel: "upload"	
};

config.macros.upload.messages = {
	noStoreUrl: "No store URL in parmeters or options",
	usernameOrPasswordMissing: "Username or password missing"
};

config.macros.upload.handler = function(place,macroName,params) {
	if (readOnly)
		return;
	var label;
	if (document.location.toString().substr(0,4) == "http") 
		label = this.label.saveLabel;
	else
		label = this.label.uploadLabel;
	var prompt;
	if (params[0]) {
		prompt = this.label.promptParamMacro.toString().format([this.destFile(params[0], 
			(params[1] ? params[1]:bidix.basename(window.location.toString())), params[3])]);
	} else {
		prompt = this.label.promptOption;
	}
	createTiddlyButton(place, label, prompt, function() {config.macros.upload.action(params);}, null, null, this.accessKey);
};

config.macros.upload.action = function(params)
{
		// for missing macro parameter set value from options
		var storeUrl = params[0] ? params[0] : config.options.txtUploadStoreUrl;
		var toFilename = params[1] ? params[1] : config.options.txtUploadFilename;
		var backupDir = params[2] ? params[2] : config.options.txtUploadBackupDir;
		var uploadDir = params[3] ? params[3] : config.options.txtUploadDir;
		var username = params[4] ? params[4] : config.options.txtUploadUserName;
		var password = config.options.pasUploadPassword; // for security reason no password as macro parameter	
		// for still missing parameter set default value
		if ((!storeUrl) && (document.location.toString().substr(0,4) == "http")) 
			storeUrl = bidix.dirname(document.location.toString())+'/'+config.macros.upload.defaultStoreScript;
		if (storeUrl.substr(0,4) != "http")
			storeUrl = bidix.dirname(document.location.toString()) +'/'+ storeUrl;
		if (!toFilename)
			toFilename = bidix.basename(window.location.toString());
		if (!toFilename)
			toFilename = config.macros.upload.defaultToFilename;
		if (!uploadDir)
			uploadDir = config.macros.upload.defaultUploadDir;
		if (!backupDir)
			backupDir = config.macros.upload.defaultBackupDir;
		// report error if still missing
		if (!storeUrl) {
			alert(config.macros.upload.messages.noStoreUrl);
			clearMessage();
			return false;
		}
		if (config.macros.upload.authenticateUser && (!username || !password)) {
			alert(config.macros.upload.messages.usernameOrPasswordMissing);
			clearMessage();
			return false;
		}
		bidix.upload.uploadChanges(false,null,storeUrl, toFilename, uploadDir, backupDir, username, password); 
		return false; 
};

config.macros.upload.destFile = function(storeUrl, toFilename, uploadDir) 
{
	if (!storeUrl)
		return null;
		var dest = bidix.dirname(storeUrl);
		if (uploadDir && uploadDir != '.')
			dest = dest + '/' + uploadDir;
		dest = dest + '/' + toFilename;
	return dest;
};

//
// uploadOptions Macro
//

config.macros.uploadOptions = {
	handler: function(place,macroName,params) {
		var wizard = new Wizard();
		wizard.createWizard(place,this.wizardTitle);
		wizard.addStep(this.step1Title,this.step1Html);
		var markList = wizard.getElement("markList");
		var listWrapper = document.createElement("div");
		markList.parentNode.insertBefore(listWrapper,markList);
		wizard.setValue("listWrapper",listWrapper);
		this.refreshOptions(listWrapper,false);
		var uploadCaption;
		if (document.location.toString().substr(0,4) == "http") 
			uploadCaption = config.macros.upload.label.saveLabel;
		else
			uploadCaption = config.macros.upload.label.uploadLabel;
		
		wizard.setButtons([
				{caption: uploadCaption, tooltip: config.macros.upload.label.promptOption, 
					onClick: config.macros.upload.action},
				{caption: this.cancelButton, tooltip: this.cancelButtonPrompt, onClick: this.onCancel}
				
			]);
	},
	refreshOptions: function(listWrapper) {
		var uploadOpts = [
			"txtUploadUserName",
			"pasUploadPassword",
			"txtUploadStoreUrl",
			"txtUploadDir",
			"txtUploadFilename",
			"txtUploadBackupDir",
			"chkUploadLog",
			"txtUploadLogMaxLine",
			]
		var opts = [];
		for(i=0; i<uploadOpts.length; i++) {
			var opt = {};
			opts.push()
			opt.option = "";
			n = uploadOpts[i];
			opt.name = n;
			opt.lowlight = !config.optionsDesc[n];
			opt.description = opt.lowlight ? this.unknownDescription : config.optionsDesc[n];
			opts.push(opt);
		}
		var listview = ListView.create(listWrapper,opts,this.listViewTemplate);
		for(n=0; n<opts.length; n++) {
			var type = opts[n].name.substr(0,3);
			var h = config.macros.option.types[type];
			if (h && h.create) {
				h.create(opts[n].colElements['option'],type,opts[n].name,opts[n].name,"no");
			}
		}
		
	},
	onCancel: function(e)
	{
		backstage.switchTab(null);
		return false;
	},
	
	wizardTitle: "Upload with options",
	step1Title: "These options are saved in cookies in your browser",
	step1Html: "<input type='hidden' name='markList'></input><br>",
	cancelButton: "Cancel",
	cancelButtonPrompt: "Cancel prompt",
	listViewTemplate: {
		columns: [
			{name: 'Description', field: 'description', title: "Description", type: 'WikiText'},
			{name: 'Option', field: 'option', title: "Option", type: 'String'},
			{name: 'Name', field: 'name', title: "Name", type: 'String'}
			],
		rowClasses: [
			{className: 'lowlight', field: 'lowlight'} 
			]}
}

//
// upload functions
//

if (!bidix.upload) bidix.upload = {};

if (!bidix.upload.messages) bidix.upload.messages = {
	//from saving
	invalidFileError: "The original file '%0' does not appear to be a valid TiddlyWiki",
	backupSaved: "Backup saved",
	backupFailed: "Failed to upload backup file",
	rssSaved: "RSS feed uploaded",
	rssFailed: "Failed to upload RSS feed file",
	emptySaved: "Empty template uploaded",
	emptyFailed: "Failed to upload empty template file",
	mainSaved: "Main TiddlyWiki file uploaded",
	mainFailed: "Failed to upload main TiddlyWiki file. Your changes have not been saved",
	//specific upload
	loadOriginalHttpPostError: "Can't get original file",
	aboutToSaveOnHttpPost: 'About to upload on %0 ...',
	storePhpNotFound: "The store script '%0' was not found."
};

bidix.upload.uploadChanges = function(onlyIfDirty,tiddlers,storeUrl,toFilename,uploadDir,backupDir,username,password)
{
	var callback = function(status,uploadParams,original,url,xhr) {
		if (!status) {
			displayMessage(bidix.upload.messages.loadOriginalHttpPostError);
			return;
		}
		if (bidix.debugMode) 
			alert(original.substr(0,500)+"\n...");
		// Locate the storeArea div's 
		var posDiv = locateStoreArea(original);
		if((posDiv[0] == -1) || (posDiv[1] == -1)) {
			alert(config.messages.invalidFileError.format([localPath]));
			return;
		}
		bidix.upload.uploadRss(uploadParams,original,posDiv);
	};
	
	if(onlyIfDirty && !store.isDirty())
		return;
	clearMessage();
	// save on localdisk ?
	if (document.location.toString().substr(0,4) == "file") {
		var path = document.location.toString();
		var localPath = getLocalPath(path);
		saveChanges();
	}
	// get original
	var uploadParams = Array(storeUrl,toFilename,uploadDir,backupDir,username,password);
	var originalPath = document.location.toString();
	// If url is a directory : add index.html
	if (originalPath.charAt(originalPath.length-1) == "/")
		originalPath = originalPath + "index.html";
	var dest = config.macros.upload.destFile(storeUrl,toFilename,uploadDir);
	var log = new bidix.UploadLog();
	log.startUpload(storeUrl, dest, uploadDir,  backupDir);
	displayMessage(bidix.upload.messages.aboutToSaveOnHttpPost.format([dest]));
	if (bidix.debugMode) 
		alert("about to execute Http - GET on "+originalPath);
	var r = doHttp("GET",originalPath,null,null,null,null,callback,uploadParams,null);
	if (typeof r == "string")
		displayMessage(r);
	return r;
};

bidix.upload.uploadRss = function(uploadParams,original,posDiv) 
{
	var callback = function(status,params,responseText,url,xhr) {
		if(status) {
			var destfile = responseText.substring(responseText.indexOf("destfile:")+9,responseText.indexOf("\n", responseText.indexOf("destfile:")));
			displayMessage(bidix.upload.messages.rssSaved,bidix.dirname(url)+'/'+destfile);
			bidix.upload.uploadMain(params[0],params[1],params[2]);
		} else {
			displayMessage(bidix.upload.messages.rssFailed);			
		}
	};
	// do uploadRss
	if(config.options.chkGenerateAnRssFeed) {
		var rssPath = uploadParams[1].substr(0,uploadParams[1].lastIndexOf(".")) + ".xml";
		var rssUploadParams = Array(uploadParams[0],rssPath,uploadParams[2],'',uploadParams[4],uploadParams[5]);
		bidix.upload.httpUpload(rssUploadParams,convertUnicodeToUTF8(generateRss()),callback,Array(uploadParams,original,posDiv));
	} else {
		bidix.upload.uploadMain(uploadParams,original,posDiv);
	}
};

bidix.upload.uploadMain = function(uploadParams,original,posDiv) 
{
	var callback = function(status,params,responseText,url,xhr) {
		var log = new bidix.UploadLog();
		if(status) {
			// if backupDir specified
			if ((params[3]) && (responseText.indexOf("backupfile:") > -1))  {
				var backupfile = responseText.substring(responseText.indexOf("backupfile:")+11,responseText.indexOf("\n", responseText.indexOf("backupfile:")));
				displayMessage(bidix.upload.messages.backupSaved,bidix.dirname(url)+'/'+backupfile);
			}
			var destfile = responseText.substring(responseText.indexOf("destfile:")+9,responseText.indexOf("\n", responseText.indexOf("destfile:")));
			displayMessage(bidix.upload.messages.mainSaved,bidix.dirname(url)+'/'+destfile);
			store.setDirty(false);
			log.endUpload("ok");
		} else {
			alert(bidix.upload.messages.mainFailed);
			displayMessage(bidix.upload.messages.mainFailed);
			log.endUpload("failed");			
		}
	};
	// do uploadMain
	var revised = bidix.upload.updateOriginal(original,posDiv);
	bidix.upload.httpUpload(uploadParams,revised,callback,uploadParams);
};

bidix.upload.httpUpload = function(uploadParams,data,callback,params)
{
	var localCallback = function(status,params,responseText,url,xhr) {
		url = (url.indexOf("nocache=") < 0 ? url : url.substring(0,url.indexOf("nocache=")-1));
		if (xhr.status == httpStatus.NotFound)
			alert(bidix.upload.messages.storePhpNotFound.format([url]));
		if ((bidix.debugMode) || (responseText.indexOf("Debug mode") >= 0 )) {
			alert(responseText);
			if (responseText.indexOf("Debug mode") >= 0 )
				responseText = responseText.substring(responseText.indexOf("\n\n")+2);
		} else if (responseText.charAt(0) != '0') 
			alert(responseText);
		if (responseText.charAt(0) != '0')
			status = null;
		callback(status,params,responseText,url,xhr);
	};
	// do httpUpload
	var boundary = "---------------------------"+"AaB03x";	
	var uploadFormName = "UploadPlugin";
	// compose headers data
	var sheader = "";
	sheader += "--" + boundary + "\r\nContent-disposition: form-data; name=\"";
	sheader += uploadFormName +"\"\r\n\r\n";
	sheader += "backupDir="+uploadParams[3] +
				";user=" + uploadParams[4] +
				";password=" + uploadParams[5] +
				";uploaddir=" + uploadParams[2];
	if (bidix.debugMode)
		sheader += ";debug=1";
	sheader += ";;\r\n"; 
	sheader += "\r\n" + "--" + boundary + "\r\n";
	sheader += "Content-disposition: form-data; name=\"userfile\"; filename=\""+uploadParams[1]+"\"\r\n";
	sheader += "Content-Type: text/html;charset=UTF-8" + "\r\n";
	sheader += "Content-Length: " + data.length + "\r\n\r\n";
	// compose trailer data
	var strailer = new String();
	strailer = "\r\n--" + boundary + "--\r\n";
	data = sheader + data + strailer;
	if (bidix.debugMode) alert("about to execute Http - POST on "+uploadParams[0]+"\n with \n"+data.substr(0,500)+ " ... ");
	var r = doHttp("POST",uploadParams[0],data,"multipart/form-data; boundary="+boundary,uploadParams[4],uploadParams[5],localCallback,params,null);
	if (typeof r == "string")
		displayMessage(r);
	return r;
};

// same as Saving's updateOriginal but without convertUnicodeToUTF8 calls
bidix.upload.updateOriginal = function(original, posDiv)
{
	if (!posDiv)
		posDiv = locateStoreArea(original);
	if((posDiv[0] == -1) || (posDiv[1] == -1)) {
		alert(config.messages.invalidFileError.format([localPath]));
		return;
	}
	var revised = original.substr(0,posDiv[0] + startSaveArea.length) + "\n" +
				store.allTiddlersAsHtml() + "\n" +
				original.substr(posDiv[1]);
	var newSiteTitle = getPageTitle().htmlEncode();
	revised = revised.replaceChunk("<title"+">","</title"+">"," " + newSiteTitle + " ");
	revised = updateMarkupBlock(revised,"PRE-HEAD","MarkupPreHead");
	revised = updateMarkupBlock(revised,"POST-HEAD","MarkupPostHead");
	revised = updateMarkupBlock(revised,"PRE-BODY","MarkupPreBody");
	revised = updateMarkupBlock(revised,"POST-SCRIPT","MarkupPostBody");
	return revised;
};

//
// UploadLog
// 
// config.options.chkUploadLog :
//		false : no logging
//		true : logging
// config.options.txtUploadLogMaxLine :
//		-1 : no limit
//      0 :  no Log lines but UploadLog is still in place
//		n :  the last n lines are only kept
//		NaN : no limit (-1)

bidix.UploadLog = function() {
	if (!config.options.chkUploadLog) 
		return; // this.tiddler = null
	this.tiddler = store.getTiddler("UploadLog");
	if (!this.tiddler) {
		this.tiddler = new Tiddler();
		this.tiddler.title = "UploadLog";
		this.tiddler.text = "| !date | !user | !location | !storeUrl | !uploadDir | !toFilename | !backupdir | !origin |";
		this.tiddler.created = new Date();
		this.tiddler.modifier = config.options.txtUserName;
		this.tiddler.modified = new Date();
		store.addTiddler(this.tiddler);
	}
	return this;
};

bidix.UploadLog.prototype.addText = function(text) {
	if (!this.tiddler)
		return;
	// retrieve maxLine when we need it
	var maxLine = parseInt(config.options.txtUploadLogMaxLine,10);
	if (isNaN(maxLine))
		maxLine = -1;
	// add text
	if (maxLine != 0) 
		this.tiddler.text = this.tiddler.text + text;
	// Trunck to maxLine
	if (maxLine >= 0) {
		var textArray = this.tiddler.text.split('\n');
		if (textArray.length > maxLine + 1)
			textArray.splice(1,textArray.length-1-maxLine);
			this.tiddler.text = textArray.join('\n');		
	}
	// update tiddler fields
	this.tiddler.modifier = config.options.txtUserName;
	this.tiddler.modified = new Date();
	store.addTiddler(this.tiddler);
	// refresh and notifiy for immediate update
	story.refreshTiddler(this.tiddler.title);
	store.notify(this.tiddler.title, true);
};

bidix.UploadLog.prototype.startUpload = function(storeUrl, toFilename, uploadDir,  backupDir) {
	if (!this.tiddler)
		return;
	var now = new Date();
	var text = "\n| ";
	var filename = bidix.basename(document.location.toString());
	if (!filename) filename = '/';
	text += now.formatString("0DD/0MM/YYYY 0hh:0mm:0ss") +" | ";
	text += config.options.txtUserName + " | ";
	text += "[["+filename+"|"+location + "]] |";
	text += " [[" + bidix.basename(storeUrl) + "|" + storeUrl + "]] | ";
	text += uploadDir + " | ";
	text += "[[" + bidix.basename(toFilename) + " | " +toFilename + "]] | ";
	text += backupDir + " |";
	this.addText(text);
};

bidix.UploadLog.prototype.endUpload = function(status) {
	if (!this.tiddler)
		return;
	this.addText(" "+status+" |");
};

//
// Utilities
// 

bidix.checkPlugin = function(plugin, major, minor, revision) {
	var ext = version.extensions[plugin];
	if (!
		(ext  && 
			((ext.major > major) || 
			((ext.major == major) && (ext.minor > minor))  ||
			((ext.major == major) && (ext.minor == minor) && (ext.revision >= revision))))) {
			// write error in PluginManager
			if (pluginInfo)
				pluginInfo.log.push("Requires " + plugin + " " + major + "." + minor + "." + revision);
			eval(plugin); // generate an error : "Error: ReferenceError: xxxx is not defined"
	}
};

bidix.dirname = function(filePath) {
	if (!filePath) 
		return;
	var lastpos;
	if ((lastpos = filePath.lastIndexOf("/")) != -1) {
		return filePath.substring(0, lastpos);
	} else {
		return filePath.substring(0, filePath.lastIndexOf("\\"));
	}
};

bidix.basename = function(filePath) {
	if (!filePath) 
		return;
	var lastpos;
	if ((lastpos = filePath.lastIndexOf("#")) != -1) 
		filePath = filePath.substring(0, lastpos);
	if ((lastpos = filePath.lastIndexOf("/")) != -1) {
		return filePath.substring(lastpos + 1);
	} else
		return filePath.substring(filePath.lastIndexOf("\\")+1);
};

bidix.initOption = function(name,value) {
	if (!config.options[name])
		config.options[name] = value;
};

//
// Initializations
//

// require PasswordOptionPlugin 1.0.1 or better
bidix.checkPlugin("PasswordOptionPlugin", 1, 0, 1);

// styleSheet
setStylesheet('.txtUploadStoreUrl, .txtUploadBackupDir, .txtUploadDir {width: 22em;}',"uploadPluginStyles");

//optionsDesc
merge(config.optionsDesc,{
	txtUploadStoreUrl: "Url of the UploadService script (default: store.php)",
	txtUploadFilename: "Filename of the uploaded file (default: in index.html)",
	txtUploadDir: "Relative Directory where to store the file (default: . (downloadService directory))",
	txtUploadBackupDir: "Relative Directory where to backup the file. If empty no backup. (default: ''(empty))",
	txtUploadUserName: "Upload Username",
	pasUploadPassword: "Upload Password",
	chkUploadLog: "do Logging in UploadLog (default: true)",
	txtUploadLogMaxLine: "Maximum of lines in UploadLog (default: 10)"
});

// Options Initializations
bidix.initOption('txtUploadStoreUrl','');
bidix.initOption('txtUploadFilename','');
bidix.initOption('txtUploadDir','');
bidix.initOption('txtUploadBackupDir','');
bidix.initOption('txtUploadUserName','');
bidix.initOption('pasUploadPassword','');
bidix.initOption('chkUploadLog',true);
bidix.initOption('txtUploadLogMaxLine','10');


/* don't want this for tiddlyspot sites

// Backstage
merge(config.tasks,{
	uploadOptions: {text: "upload", tooltip: "Change UploadOptions and Upload", content: '<<uploadOptions>>'}
});
config.backstageTasks.push("uploadOptions");

*/


//}}}

I can't help at all with this yet. But I just got some good advice from Eric Shulman and FND on the mailing list, which I wanted to save and refer to so I thought I may as well share it. Here's the [[link|http://groups.google.com/group/TiddlyWiki/browse_thread/thread/e847c46700c3777d/bf613a296493a587#bf613a296493a587]] for the thread.

> I notice you guys often suggest solutions that involve putting a bit
> of code in the style sheet.
> Can you put an endless amount of code in there?

Not just ANY code... only CSS syntax... and yes, you can pretty much
put as much as you want into the StyleSheet tiddler.  However...

> Should it be kept tidy in some way?

1) You can split the StyleSheet into separate tiddlers, each
containing a different, logically-grouped set of custom CSS
definitions, and then combine them using the "[[TiddlerName]]" syntax
embedded in you StyleSheet, e.g.:

[[StyleSheetFormatting]]
[[StyleSheetTiddlers]]
[[StyleSheetHeaders]]
[[StyleSheetMenus]]

When the StyleSheet tiddler is *viewed*, each [[TiddlerName]]
reference is displayed as a simple TiddlyLink to that tiddler.
However, when the StyleSheet is *applied*, the referenced tiddlers are
first 'included' into the StyleSheet content, and then the combined
CSS source is then submitted to the browser for actual handling.

2) Another good practice is to use comments to annotate what each
stylesheet tiddler (or part thereof) is for:

/***
This is a comment that is not processed as CSS, but WILL be formatted
as wiki-syntax content.  You can use [[PrettyLinks]] and //italics//,
etc.
***/

3) You can also wrap the CSS in a "pre" block for easier-to-read
display results when *viewing* the StyleSheet:

/*{{{*/
CSS stuff goes here
/*}}}*/

> How do you find things if you want to delete them later?

Most browsers have a "find/find again" feature.  Just edit the
StyleSheet and search for the text in the tiddler source that is
displayed in the editor. 

FND adds:
When I have to do extensive editing, I usually copy the code from the
respective tiddler's source (i.e. in edit mode) into my text editor
(e.g. Notepad++, which provides syntax highlighting). After modifying
that code, I simply paste it back into the tiddler and save.

Your username appears on the tiddlers you create and edit. You will have provided a username when you first created your ~TiddlyWiki, but occasionally you may be asked for it again. 

Click on Options on the top right-hand menu. A blue box appears. Where it says 'your username for signing your edits.....' type your name in the white box. That's done. No need to hit a Done or Save button. You can close the blue box by clicking on Options again. You can also leave it open, if you prefer.

Tiddler Toddler is a resource for absolute beginners put together by [[Julie Starr|About Julie]], who is an absolute beginner herself. It was created in //Classic// ~TiddlyWiki in 2007 (and hasn't been updated for some time). I have borrowed from other excellent [[help sites|Get Help]] but all the mistakes here are my own.
;PLEASE NOTE: All the information here applies to [[Classic ~TiddlyWiki|http://classic.tiddlywiki.com/]]. There's a newer version of ~TiddlyWiki now, sometimes referred to as ~TiddlyWiki5 or ~TW5, which you may prefer to use. If you want to download and start using the //latest version// of ~TiddlyWiki go to http://tiddlywiki.com and follow the instructions there to set it up.
If you want to carry on using your //Classic// ~TiddlyWiki, then you'll find simple instructions here and links to other [[help sites|Get Help]]. It's a good place to look around if...
*you can use Word but don't know what code or html is
*you like the look of ~TiddlyWiki Classic but can't seem to get past first base
*you don't understand why blue words that look like links don't behave the way you expect
*you want to [[read about someone else's mistakes|Day Two: Learning Cliff]] to make you feel better about your own
~TiddlyWiki was created by Jeremy Ruston. Find out more at [[tiddlywiki.com|http://tiddlywiki.com]]. 
This ~TiddlyWiki is hosted on [[tiddlyspot.com|http://tiddlyspot.com]].

I think of it as a workspace that can be carved up into bite-sized chunks, called tiddlers. If it were a book you could put each chapter in a tiddler; a document and you could put each section in a tiddler.
 
You can open all the tiddlers, or just work with one or a few of them at a time. You can read them, edit them, delete them and create new tiddlers.

It's a very versatile way of working, and much easier than scrolling through big documents to find the part you want, or getting buried under piles of post-it-notes.

A great feature of ~TiddlyWiki is that it's portable - you can carry it with you on a USB stick, work offline on your computer or have it hosted online and log in to work on it wherever you happen to be.

Some people use ~TWs for managing tasks, for presentations, for their thesis, as a repository of information and links for students. I use them to store references, notes and links for various projects, and to take notes at conferences.

You can see a range of ~TiddlyWikis in action in this [[gallery|http://tiddlyspot.com/?page=gallery]] at www.tiddlyspot.com.

~TiddlyWiki was created by Jeremy Ruston. Find out more at [[tiddlywiki.com|http://www.tiddlywiki.com]].

WikiWords - words with more than one capital letter  - are a great feature of ~TiddlyWikis because they automatically work as links.

If you give a tiddler a ~WikiWord name, like FormatText on the lefthand menu, whenever you use the name it will automatically appear in blue text and work as a link to the tiddler. 

You can disable ~WikiWords, though, if you want to.  

Just put a tilde character (~) in front of the ~WikiWord and it will behave like an ordinary word. Click on Edit to have a look inside this tiddler to check how that was done.

The big blue space at the top of the page is called the header.

To give your ~TiddlyWiki a name, which will appear in the header, find the tiddler SiteTitle. It was in GettingStarted which you would have seen when you first downloaded your ~TiddlyWiki, but you can also find it by using the search box (top right) or looking in the lower right-hand menu - click on the All tab to see an alphabetical list of tiddlers. 

Open SiteTitle for editing and type the name of your ~TiddlyWiki in the main text box (the big one below the yellow box which says 'this shadow tiddler...')

Click on Done (grey menu at top right of tiddler), and you should see the name in the header.

To give your ~TiddlyWiki a secondary, or subtitle - the smaller writing in the header - find and open the tiddler SiteSubtitle and type into the main text box.