Upgrading from Older Versions of Joust
Upgrading from 2.5.3 to 2.5.4
index.htm
- Replace everything between the Start of Joust and End of Joust markers in your index.htm with
the same section from the new index.htm.
- Update the version number in the comments at the top of the document.
index2.htm
- Update the version number in the comments at the top of the document.
menu.htm
- Update the version number in the comments at the top of the document.
menucntrl.htm
- If you are using the menucntrl.htm supplied with the previous version of Joust, look for this text in it:
onClick="alert(1);"
and delete it.
Upgrading from 2.5.2 to 2.5.4
index.htm
- Replace everything between the Start of Joust and End of Joust markers in your index.htm with
the same section from the new index.htm.
- Update the version number in the comments at the top of the document.
index2.htm
- Update the version number in the comments at the top of the document.
menu.htm
- Update the version number in the comments at the top of the document.
Upgrading from 2.5.1 to 2.5.4
index.htm
index2.htm
- Follow the instructions, above, for upgrading index2.htm from 2.5.2 to 2.5.4.
menu.htm
Upgrading from 2.5 to 2.5.4
index.htm
- Replace everything between the Start of Joust and End of Joust markers in your index.htm with
the same section from the new index.htm.
- Update the version number in the comments at the top of the document.
index2.htm
- Update the version number in the comments at the top of the document.
- Update the copyright notice in the comments at the top of the document.
menu.htm
Upgrading from 2.4.x to 2.5.3
Warning: Joust no longer supports the use of a search parameter without "page=". For example, this URL:
http://www.mycompany.com/index.htm?page2.htm
will no longer work. Instead, this URL should be used:
http://www.mycompany.com/index.htm?page=page2.htm
If you have old frameset redirection code in your pages, it will need to be updates (see the TechNotes in the documentation for more details).
If you have a large outline and turn DHTML support off in MSIE for performance reasons then make sure you read question 4 in the FAQ. You may need to turn DHTML off for Netscape 6 as well.
index.htm
- Replace everything between the Start of Joust and End of Joust markers in your index.htm with
the same section from the new index.htm.
- Update the version number in the comments at the top of the document.
- Update the copyright notice in the comments at the top of the document.
index2.htm
- Replace everything between the Start of Joust and End of Joust markers in your index2.htm with
the same section from the new index2.htm.
- Update the version number in the comments at the top of the document.
- Update the copyright notice in the comments at the top of the document.
menu.htm
Upgrading from 2.3.5, 2.3.6 or 2.3.7 to 2.5.3
index.htm
- Replace everything between the Start of Joust and End of Joust markers in your index.htm with
the same section from the new index.htm.
- Update the version number in the comments at the top of the document.
- Update the copyright notice in the comments at the top of the document.
- Change all occurrences of "addMenu" in your initialise function to "addEntry"
(note that addMenu will still work so you don't have to do this - but addMenu may get removed in some future version so it's a good idea).
- Changes to the handling of custom onToggle event handlers mean that the isopen MenuEntry property is now updated after the handler has been called. If you have any custom onToggle handlers you will need to update them accordingly.
- Joust now includes a default onResize handler to cope with Netscape problems when the window is resized. If you have not already implemented a resize handler as described in the documentation then you should add onResize="defaultResizeHandler();" to the first FRAMESET tag in each part of the if statement where the Joust frameset is drawn (see the new index.htm for an example).
- If you don't already have a robots.htm file in you Joust directory, copy the one from the new package and then add <A HREF="robots.htm"><> to the BODY section of index.htm. If you do have a robots.htm then read TechNote 1 and make your own decision about using the new one.
index2.htm
- Replace everything between the Start of Joust and End of Joust markers in your index.htm with
the same section from the new index.htm.
- Update the version number in the comments at the top of the document.
- Update the copyright notice in the comments at the top of the document.
menu.htm
Upgrading from 2.3.4 to 2.5
Update the menucntrl.htm file as indicated below, then follow the instructions above for upgrading from version 2.3.5.
menucntrl.htm
Upgrading from 2.3.3 to 2.5.3
Update the menucntrl.htm and menu.htm files as indicated below, then follow the instructions above for upgrading from version 2.3.4.
menu.htm
- In versions after 2.3.3, a set of "Start of Joust" and "End of Joust" markers were added to menu.htm to make upgrade instructions easier to write and follow.
So, add "Start of Joust" and "End of Joust" markers to your menu.htm. If you are unsure where they should go, replace all the
code in the HEAD section of menu.htm (except for any new functions you've added yourself) with all the code in the HEAD section of
the new menu.htm (including the new Start of Joust .. End of Joust comments).
- Look for this line in the "STYLE" section at the top of the document:
.menuItem {position:absolute; visibility:hidden; left:0px;}
and add the following line after it:
.menuItem BR { clear: both; }
- Change this line at the bottom of the script section:
if (self.name != 'menu') { self.location.href = 'index.htm'; }
by replacing the "index.htm" with the name of your default page.
- Look for this line of code in the BODY of the document:
theMenu.draw(self.document);
to this:
parent.DrawMenu(theMenu);
menucntrl.htm
Upgrading from versions before 2.3.3
I used to keep all the upgrade instructions from previous versions here but I realised that it was pointless since you wouldn't have the files referenced in the instructions.
The easiest way to upgrade from older versions is to start again with the index.htm, menu.htm and menucntrl.htm that ship with Joust. Then copy your initialise, initOutlineIcons and any other customisations (colours, background images, frameset definitions) from your old files into the new ones.
If you need an older version of Joust, send me an email & I will dig one out of the archive for you.