<?xml version="1.0" encoding="ISO-8859-1"?>
-<!-- $id$ -->
+<!-- $Id$ -->
<readme>
<title>Readme for TestXSLT</title>
-<author>Written by Marc Liyanage <email>liyanage@access.ch</email></author>
+<author>Written by Marc Liyanage <email>testxslt@entropy.ch</email></author>
<description>
<para>TestXSLT is a free tool for learning, experimenting with and using the XSL language (both the XSLT and the XSL-FO parts) in a convenient way on Mac OS X. It offers several XSLT processors (Sablotron, Gnome LibXSLT, Saxon and Xalan-J) as well as the Apache FOP XSL-FO rendering engine which produces on-screen previews as well as PDF files. For authors of stylesheets which produce HTML, it makes use of the WebKit HTML rendering engine, allowing previews right in the application.</para>
<para>You can either edit the XML and XSLT code directly in the program or you can load them from files on disk. Try drag and drop for the latter.</para>
-<para>There are some examples included to get you started. The first is this Readme document that you are reading now. It was written and is maintained in XML. I have included two stylesheets which convert the XML input file into an RTF document and into an HTML page. Study the input, the stylesheets and the output files carefully to learn some basics. The stylesheets are commented.</para>
+<para>There are some examples included to get you started. The first is this Readme document which you are reading right now. It was written and is maintained in XML. I have included several stylesheets which convert the XML input file into an RTF document, into an HTML page and into XSL-FO and thus PDF. Study the input, the stylesheets and the output files carefully to learn some basics. The stylesheets are commented.</para>
-<para>There are also various other example files to get you started with XSLT. Just play around with the files and see what happens...</para>
+<para>I also add new interesting examples to the "More Examples" directory all the time. Just play around with the files and see what happens...</para>
<para>Comments, feedback and feature suggestions are welcome to the address above.</para>
<para>The latest version of this software is available at <url>http://www.entropy.ch/software/macosx/</url></para>
+<para>If you need help or would like to comment on the program, there is an online user forum for TestXSLT at <url>http://www.entropy.ch/phpbb2/</url></para>
+
</description>
<requirements>
-Mac OS X 10.2., Safari 1.0 must be installed on your system.
+Mac OS X 10.3. and Safari 1.0 must be installed on your system.
</requirements>
<history>
<entry>
+ <version>3.2</version>
+ <date>24-FEB-2005</date>
+ <item>Updated libxml2, libxslt, libexpat and Sablotron Libraries to the most recent versions.</item>
+ <item>Changed the way these libraries are included in the project, which removes tons of unused files from the distribution.</item>
+</entry>
+
+<entry>
+ <version>3.1</version>
+ <date>19-FEB-2005</date>
+ <item>Extra special big thanks to the folks at VitalSource (<url>http://www.vitalsource.com</url>) for their generous donation in support of this release :-)</item>
+ <item>Fixed the most common cause for a crash when quitting the application or closing a document window. The crash still occurs very rarely though.</item>
+ <item>XSL-FO processing works again after it was broken by the Java 1.4.2 update.</item>
+ <item>There's now a preferences dialog, currently with the following options.</item>
+ <item>1.) It allows to disable the syntax analysis which can take a long time with large documents. Note that disabling it also disables automatic closing tag insertion.</item>
+ <item>2.) It allows to disable the wellformedness check. Disabling this stops the little warning icon from appearing.</item>
+ <item>3.) It allows to edit the default text snippets that are inserted into the XML and XSLT text areas of new documents.</item>
+ <item>Because of the way the preferences dialog is implemented (Cocoa Bindings), the program now requires Mac OS X 10.3.</item>
+ <item>The wellformedness check error message (if any) is now visible in the error message drawer, and not only in the tooltip of the little warning icon. You open the drawer by clicking onto the warning icon.</item>
+ <item>Updated the Xalan-J processor to 2.6.</item>
+ <item>Updated the Saxon processor to 8.3, which means you can now experiment with XSLT 2.0 and XQuery.</item>
+</entry>
+
+<entry>
+ <version>3.0</version>
+ <date>17-DEC-2003</date>
+ <item>Changed keyboard shortcut for "Find Again" from Cmd-D to Cmd-Shift-G as 1.) that seems to be the new convention for Cocoa apps, 2.) it's used in BBEdit, and 3.) I like it better :-)</item>
+ <item>When dragging a file to the document window, you can now hover the mouse pointer over the tab labels to switch tabs without interrupting the drag. This is useful for example if you want to drag an XML document to the XML tab, but you forgot to switch to that tab first and the XSLT tab is in front.</item>
+ <item>there's now a base URL text field in the HTML preview pane. It allows you to enter a URL against which relative references are resolved.</item>
+ <item>There are two new "File" menu commands with associated keyboard shortcuts to "Save As..." and "Save" the text in the current pane (XML, XSLT, Result) to a file. This is the equivalent of the corresponding buttons on each of the panes.</item>
+</entry>
+
+
+<entry>
<version>2.9</version>
- <date>xx-SEP-2003</date>
- <item>Added a tag scanner, resulting in much smarter tag completion, and a list of the currently open tags at the top of the editor.</item>
+ <date>08-SEP-2003</date>
+ <item>The highlight of this release is a new tag scanner, resulting in much smarter tag completion, and a list of the currently open tags at the top of the editor window. Check it out...</item>
+ <item>Reworked the GUI update code, thus improving the general responsiveness and performance of the application.</item>
<item>Major internal cleanup regarding encodings. If a dropped/opened file has an XML declaration with encoding information, that will be used, both when reading and when saving out to the file again. Make sure you activate the corresponding option in BBEdit too. If no such declaration exists, the platform default will be used (i.e. Macintosh encoding). Also, the encoding of the result of the transformation is currently assumed to be what's declared in the declaration of the XSLT code. This means you cannot use a different encoding in the xsl:output element.</item>
+ <item>The fixed encoding issues also mean that xsl:include directives referring to file names with non-ascii characters work now, e.g. <xsl:include href="gähn.xsl"/>.</item>
+ <item>Added a new XSLT example, the first one to produce XSL-FO. It converts the readme.xml file to XSL-FO / PDF, so there are now three output formats for the readme.xml file: HTML, XSL-FO / PDF and RTF. As always, this is intended to get you started with learning XSLT and in this case also XSL-FO. An excellent introduction to the FO part is available at <url>http://www.ibiblio.org/xml/books/bible2/chapters/ch18.html</url></item>
+ <item>Fixed a bug which would prevent XSL-FO / PDF rendering to hang the application if images were used in the document.</item>
</entry>
+
+
+
<entry>
<version>2.8</version>
<date>17-AUG-2003</date>
projects / TestXSLT.git / blobdiff