%SEARCH\{\}% variable for database like reporting.
* Various bug fixes
## Major Changes from TWiki 01-Dec-2000
The 01-Sep-2001 release includes the following new features and enhancements compared to the 01-Dec-2000 release:
* **[[TWIKIWEBTWikiPlugins]]** - Easily install program enhancements using external plug-in modules. Developers can create plug-ins in Perl, with the [[TWIKIWEBTWikiPlugins]].
* %TWIKIWEB%.InterwikiPlugin (preinstalled) - Link to external sites with text aliases, `SiteAlias:Page`; rules are defined in [[InterWikis]]. (Get more Plugins from the TWiki:Plugins web.)
* **[[TWIKIWEBTWikiTemplates]]** - New, more flexible template system.
* **[[TWIKIWEBTWikiSkins]]** - Overwrite template headers and footers; page content is unaffected.
* **[[TWIKIWEBTWikiMetaData]]** - New data format
* **[[TWIKIWEBTWikiForms]]** - Create multiple input forms per web; data is rendered in HTML tables.
* **[[TWIKIWEBManagingTopics]]** - Individual topics can be renamed, moved and deleted through the browser. Deleted topics are stored in a common Trash web.
* **[[TWIKIWEBTWikiUserAuthentication]]** - Change and reset passwords using forms.
* **[[TWIKIWEBTWikiVariables]]** - %TOC% variable generates a hierarchical table of contents from topic headings: <h1>...<h6>.
* **[[TWIKIWEBTWikiVariables]]** - Text formatting rules to generate automatic links from any combination of words and spaces.
* **[[TWIKIWEBFileAttachment]]** - Changes made to files attached to topics are now saved under revision control (RCS).
* **[[TWIKIWEBTWikiAccessControl]]** - Lets you to make the members of one user group - by default, TWikiAdminGroup - into TWiki superusers, with the ability to overwrite locked topics from the browser interface. (This gets around the problem of topic lockouts, caused by typos in access privilege definitions.)
* **HierarchicalNavigation** uses new [[TWIKIWEBTWikiMetaData]] variables to link hierarchically.
* **Convert to XHTML** - Pages are rendered for display in XHTML 1.0, as far as possible without breaking HTML 3.2 compliance.
## TWiki Directory Structure and File Names
The TWiki directory structure remains the same, with one exception, the TWiki configuration file and Perl modules have been moved from the `twiki/bin` directory into it's own `twiki/lib` directory tree. The following files have been renamed and moved:
| From TWiki 01-Dec-2000: | To TWiki 01-Dec-2001: |
|---|---|
twiki/bin/wikicfg.pm |
twiki/lib/TWiki.cfg |
twiki/bin/wiki.pm |
twiki/lib/TWiki.pm |
twiki/bin/wikiaccess.pm |
twiki/lib/TWiki/Access.pm |
twiki/bin/wikiprefs.pm |
twiki/lib/TWiki/Prefs.pm |
twiki/bin/wikisearch.pm |
twiki/lib/TWiki/Search.pm |
twiki/bin/wikistore.pm |
twiki/lib/TWiki/Store.pm |
| Before Switch: | After Switch: | ||
|---|---|---|---|
| Current 01-Dec-2000: | New 01-Dec-2001: | Obsolete 01-Dec-2000: | New 01-Dec-2001: |
twiki/templates/ |
twiki/templates2/ |
twiki/templates1/ |
twiki/templates/ |
twiki/bin/ |
twiki/bin/2/ |
(overwritten) | twiki/bin/ |
| (N/A) | twiki/bin/lib/ |
(N/A) | twiki/lib/ |
twiki/data/TWiki |
twiki/data/TWiki2 |
twiki/data/TWiki1 |
twiki/data/TWiki |
| (other directories do not change) | |||
%WEB% . \{\} decoration from the list (it is now in the templates), ex: %INCLUDE\{"%TWIKIWEB%.WebSearch"\}%
7. Optional: In `WebChanges` of all webs, replace content with this one line: %INCLUDE\{"%TWIKIWEB%.WebChanges"\}%
### Step 9: Customize template files
**_NOTE:_** Skip this step if you did not customize your template files.
1. Remember that you have now two template directories:
* The original `twiki/templates`.
* The new `twiki/templates2`, which gets renamed to `twiki/templates` when you switch over the installation.
2. Customized templates and skins need to be upgraded to the new [[TWikiTemplates]]. This isn't difficult, but you have be familiar with the new template set-up before starting the conversion. The safest way is to use the new templates as a base and to merge your changes back. Changes in new templates:
* Templates are now rendered by TWiki. You can use all [[TextFormattingRules]], but you have to escape unwanted ones. Also, remove empty lines unless you want a `=` tag added.
* Added [[TWikiMetaData]] rendering.
3. Form Templates replace the TWikiCategoryTables:
* Create a replacement `WebForm` topic based on `twikicatitems.tmpl` in each web that uses a Category Table. See details in [[TWikiForms]] and compare with the settings in the Know2.WebPreferences topic. **notedited.tmpl** template, create an equivalent [[WebTopicEditTemplate]] to conform with the new [[TWIKIWEBTWikiTemplates]]. The new format replaces the `notedited.tmpl`, `notext.tmpl` and `notwiki.tmpl` templates.
### Step 10: Switch over to new installation
In this step, you move the working 01-Dec-2001 installation to the old 01-Dec-2000 installation, so that users don't have to change the URL.
1. Test your new 01-Dec-2001 installation under `twiki/bin/2/view` to make sure everything works as expected.
* **_NOTE:_** Don't worry about the Plugins, they'll work after the switch.
2. Edit `$TWIKIROOT/bin/2/TWiki.cfg` and remove the `/2` from `$scriptUrlPath` and `$templateDir`, ex: EmptyPlugin, DefaultPlugin, and InterwikiPlugin should be preinstalled. To check the %TWIKIWEB%.InterwikiPlugin, go to its page.
2. If you have customized the functions `extendHandleCommonTags`, `extendGetRenderedVersionOutsidePRE` and `extendGetRenderedVersionInsidePRE` in `twiki/bin/wikicfg.pm`:
* Merge those changes back into `twiki/lib/TWiki/Plugins/Default.pm`
### General Format Changes
* The format of the %GMTIME\{"..."\}% and %SERVERTIME\{"..."\}% variables is now **"$hour:$min"** instead of `"hour:min"`. More in %TWIKIWEB%.TWikiVariables.
* [[TWikiVariables]]: Enhanced table syntax might have unwanted side effect: | \*bold\* | cells, `| center aligned |` and `| right aligned |` cells, span multiple columns using `| empty cells |||`. More in [[TextFormattingRules]].
* Use **Net::SMTP** module instead of `sendmail` if installed.
* Use **<verbatim> ... </verbatim>** tags instead of `...` tags where appropriate. More in %TWIKIWEB%.TextFormattingRules. * New variable
**%STARTINCLUDE%** and **%STOPINCLUDE%** variables to control what gets included of a topic. More in %TWIKIWEB%.TWikiVariables.
* [[FileAttachment]] info is now stored as [[TWikiMetaData]].
* Upgrading of imported pagess is done automatically after first edit, on save. "In memory" upgrade is done on topic view.
* Attachments are now under revision control: `$attachAsciiPath` in `TWiki.cfg` defines which file types are stored in ASCII, otherwise, binary format is used. This means that the RCS version used should support binary files.
* Handling for topic-specific templates like `edit.new.tmpl` has been removed and replaced by template topics in the new [[TWikiTemplates]].
* A new file `warning.txt` file can appear in the `data` directory. It may contain diagnostic info identifying problems that need fixing. This file could get fairly large if you have a lot of problems your site - you can delete it at any time.
## Known Issues
* Check TWiki:Codev/KnownIssuesOfTWiki01Dec2001 for known issues of TWiki 01 Dec 2001 (production release)
* Check TWiki:Codev/KnownIssuesOfTWiki01Sep2001 for known issues of TWiki 01 Sep 2001 (production release)
-- [[JohnTalintyre]] - 18 Jul 2001