2.10 1.5-M1 to 1.5-M2 upgrade

Daisy 1.5 Milestone 2 was released on June 21, 2006.

2.10.1 Changes

2.10.1.1 Important changes: read this section!

• Daisy Wiki: the configuration and data used by the Daisy Wiki is now stored in a separate wikidata directory, similar to the data directory of the repository server. The data directory contains things such as the skins, the site definitions, the doctype XSLs, the logs, ... In earlier Daisy versions, these items were simply stored inside the Daisy Wiki webapp. The new structure is also illustrated in the updated deployment diagram.
  The introduction of the wikidata directory has several advantages:
• Clear separation of data and application
• Clear view on official extension points
• Upgrading and backups become easier: it will no longer be needed to copy over your site definitions, skins, etc. after upgrading.
• OpenJMS is replaced with ActiveMQ as default JMS implementation.
• We embedded the ActiveMQ inside the repository server so from now on, the OpenJMS server doesn't need to be started anymore.
• The ActiveMQ project is much more alive then OpenJMS, provides more ways to connect to it, ...
• A new default skin
• Much more CSS-based, the layout is better controllable through CSS only.
• The rather big default.css file has been split up in multiple smaller CSS files
• Aesthetic improvements:
• lighter look
• fixed width layout (better readability on wide screens)
• ...
• See also the compatibility notes if you have created your own skin(s) based on the old default skin.

2.10.1.2 Other new features

• Allow to switch between live and staging views in the Wiki. Up till now, the Wiki displayed by default the live versions of all documents. When switching to staging mode, the last versions of the documents are displayed by default. So it shows how everything would look if the last versions of all documents would become live. This also applies to navigation trees, queries embedded in documents, et cetera. See docs.
• Navigation trees:
• Nodes can now be hidden or visible-when-active. Hidden nodes allow to have the navigation tree expanded up to a certain point, and to control the URL path, without having to overload the navigation tree (this will probably mostly be done using queries). Visible-when-active is similar: the node is always hidden except when it is active.
• Query nodes in the navigation tree can now create hierarchies instead of just a flat list of nodes. For example, if you enter a query like:
  

  select documentType, name where true order by documentType, name

  this will create group nodes per document type, and normal document nodes below that. This can of course work multiple levels deep. Make sure the order by clause is meaningful (thus: sort values in the same order as selected).

• Books:
• A new book publication process task, named "custom", allows to specify a Java class to do custom processing.
• Publication types can now specify parts for which they need the binary content to be available.
• The input for the doctype XSLs now has a /document/@isIncluded attribute, just as in the Wiki, to distinguish included documents.
• Added two publication tasks: renderSVG and callPipeline, both of which are useful in combination with the new part-download capability (see the second bullet)
• The publication task copyBookInstanceImages has been renamed to copyBookInstanceResources, though the old name still works. The new name also comes with some new functionality: not only img/@src resources are copied, but also resources linked to in a/@href, embed/@src, object/@data.
• Faceted navigation: allow to limit the set of documents on which the faceted navigation is performed, through an <defaultConditions> element in the faceted navigation definition.
• Removed the need to have absolute paths in the myconfig.xml by supporting property substitutions (where needed), such as ${daisy.datadir} and ${daisy.home}. The repository initialisation script now generates such myconfig.xml's without absolute paths. This allows to move the data directory around without having to adjust these paths. (DSY-271)
• The homepage of a site, as defined in the siteconf.xml, can now be a custom path instead of only a document ID. This is for example useful to let the homepage point to some extension URL. See the sites documentation.
• The recent changes page now has links to the RSS feeds (including link elements in the page header, so that the feeds can be detected automatically).
• Editor: improvements to the image browser dialog:
• the collection of the current site is automatically selected by default, so the user immediately sees the images in that collection. The list of collections has been changed to a drop-down list.
• it is possible to select no collection, thus showing all images, without a collection constraint
• the image browser now shows all documents that have an 'ImageData' part. Previously it showed all documents of type 'Image'. The benefit of this is that you can have custom document types for images, and as long as they reuse the 'ImageData' part for the rendered image, it will now show up in the image browser.
• Document editor:
• Allow to initialise new documents with some content before showing the editor ( docs).
• Allow to specify a custom location to redirect to after editing is done (useful for included/aggregated content).
• Included documents now show edit links next to their title(if you have edit rights on the document) (similar to Wikipedia).
• The document basket: a new Daisy Wiki feature that allow end-users to do things with sets of documents (such as aggregate them for easy printing), as described in this mail.
• Added a schema uploader tool, which allows to create a Daisy repository schema (document, part, field types) from an XML file.
• Added SVG support, through a new SvgDocument document type. This is roughly based on the scratchpad article, but with several enhancements: the SVGs embedded in HTML are automatically resized by some javascript, and the SVGs are also properly rendered in the books (in the PDF publication by default at 250dpi).
• The document type specific XSLs, and the query styling XSLs are now put in the directory of the skin. This makes fallback between skins work for them.
• Added a version reversion feature in the Wiki, accessible through the versions overview page.

2.10.1.3 Bug fixes & minor improvements

• Some new bugs in 1.5-M1 were fixed: image upload dialog not working, create document task not working
• The ACL admin screen now uses icons to indicate the ACL actions (grant, deny, do nothing), which makes the layout fit better on the screen and is easier to read.
• Fixed a problem with the backup restore on Windows: the tool didn't wait for the external processes (mysql/mysqladmin) it calls to end.
• Added a patched merlin.bat file, so that when you have Java installed in a directory containing spaces, you don't need to patch this manually anymore.
• In Internet Explorer, links consisting of only a fragment identifiers (#something) were prepended with the filename from the current (editor) URL.
• We build Cocoon now with the latest Rhino version (1.6-R2), giving access to its latest bug fixes and features (such as E4X). Also, this was required to get javascripts embedded in SVGs working.
• Books: the default name proposed for book instances contained the colon character (:), which is a prohibited file name character on Windows.
• Editor: when switching between td and th cells, the colspan and rowspan were not preserved.
• And much more small polishing...