The following new features and changes are included in this release of QuickSilver:
Advanced Publisher Tool
The new Advanced Publisher tool, available from the Tools menu, provides powerful publishing capability beyond what is available in basic QuickSilver publishing.
For example, you can publish and deliver a complex, multi-file publication directly to a BroadVision Portal, using Advanced Publisher features to define the publication's category placement and to assign portal attribute and qualifier values based on QuickSilver attributes.
Improvements to Basic Publishing and Book Features
Several features have been added or improved in the basic QuickSilver publishing and book subsystems.
Hypertext TOC and Index Documents
In this release, the previous method for creating hypertext linked TOCs and indexes has been replaced. You can now choose from two methods:
Important: TOC and index documents created prior to QuickSilver version 1.6.1 with patch AB must be regenerated if you want them to contain hypertext links when published.
The new methods for creating hypertext TOCs and indexes do not require HyperLeaf Toolkit. However, HyperLeaf Toolkit is still required for publishing documents with links that were created using HyperLeaf.
Single or Multiple Output Files
In the Publish dialog box, you can choose to output a book as multiple files, so that a separate output file is generated for each document in the book. You can also set the .publish-single-file attribute on any book or sub-book to cause it to always publish as a single file.
The .publish-single-file attribute
The first time you publish a book, a .publish-single-file attribute is automatically defined at the top level of the book. Its attribute value is set according to whether the Output book as multiple files check box in the Publish dialog box was selected when you published. The following list illustrates this relationship.(Check box status / Attribute value)
Toggling the check box status in the Publish dialog box changes the .publish-single-file attribute value at the top level of the book. Changing the attribute value at the top level toggles the check box status.
Publishing sub-books as single files
By default, when you publish a book as multiple files, one output file is created for each document in the book, and the structure of the output directory reflects the source book's structure. If the source book contains sub-books, the output directory contains analogous sub-directories, with individual output files for each document.
If you want all the documents in a sub-book to be published as a single file, even when the rest of the book is published as multiple files, you can set the .publish-single-file attribute value to yes on that sub-book.
Excluding Files from a Publication
To exclude specific files from a publication, but keep the files in your QuickSilver source book, you can use the .publish-ignore attribute.
Important: The .publish-ignore attribute works only with multiple-file output.
Files Excluded by Default
QuickSilver catalogs and Lisp files are always excluded from publications, for both single- and multiple-file output.
The following files are either excluded or not converted when you publish a book to PDF:
These files are excluded if you output your publication as a single PDF file (similar to printing a book). If you choose multiple-file output, these files are included in the published output directory, but are not converted to PDF. To exclude them from the published output directory, you can use the .publish-ignore attribute.
Excluding QuickSilver Documents and Sub-books
To exclude QuickSilver documents and sub-books from a publication, you can use the .publish-ignore attribute or you can use conditonal content.
When you use conditional content to tag documents and sub-books for exclusion, the parent book is adjusted to reflect the absence of the excluded files. For example, the tagged files are omitted from page number and chapter number streams and from newly generated TOCs and indexes.
When you tag QuickSilver documents and sub-books for exclusion using the .publish-ignore attribute, the parent book is not adjusted. The book's autonumber streams, TOCs, and indexes reflect the presence of the tagged files in the book, even though the files themselves are excluded
from the published output.
Using the .publish-ignore Attribute
To use the .publish-ignore attribute, you must first define it, then set its value to yes on each file you want to exclude. Attributes you define on QuickSilver books and sub-books (.ilboo) or documents (.ildoc) become available for all other .ilboo and .ildoc files in the book. For other types of files and directories, you must define attributes individually.
To exclude a specific file or directory from a publication:
Browse Button for the Publishing Destination Path
By clicking the new Browse button next to the Destination text box on the Publish dialog box, you can browse local or networked file systems to set the destination path for your publications.
Use the Destination text box and option menu to specify where to paste the published file.
Default Publishing Workspace Preference
On the Publish sheet of the QuickSilver Preferences dialog box, you can set a default path for the publishing workspace, where temporary files are stored during the publishing process.
The Publish Preferences
Use the Publish preferences to specify paths required for successful publishing.
Path to Acrobat Distiller
Provide the path to your installed version of Adobe Acrobat Distiller. This is required for publishing QuickSilver documents to PDF format.
Path to publishing workspace
The publishing workspace is a directory used by the Publish feature and the Advanced Publisher tool for storing temporary files during the publishing process. You can use the default workspace (typically your clipboard), or you can type or browse to a different path.
By default, Advanced Publisher also uses this directory as the default target location for final publications. However, you can change this path within Advanced Publisher on a project-by-project basis.
Several filters have been updated, including the following: