README.TXT for Trellix 1.0 - November 1997 ------------------------------------------------------------------------ ------------------------------------------------------------------------ For the latest information on Trellix 1.0, see www.trellix.com, where we post updates, sample documents, answers to frequently asked questions, conversion scripts for Sneak Peek users, information on known bugs, Tips of the Day, and more. You can use our site to chat with Trellix staff and other users, and express your opinions about this release. Thank you for buying Trellix 1.0, the document builder for the Web era. We look forward to hearing your comments! Trellix Corporation www.trellix.com support@trellix.com All software and materials copyright 1997 by Trellix Corporation. ------------------------------------------------------------------------ ------------------------------------------------------------------------ README.TXT Table of Contents User Assistance and Online Help Technical Supplement Known Problems Publishing to HTML ------------------------------------------------------------------------ ------------------------------------------------------------------------ User Assistance and Online Help Details of Trellix functionality are fully covered in Trellix online Help. To use it, choose Help - Help Topics or Help - Screen Tips. For a good general introduction to using Trellix, read the Quick Start book provided with the software. This README file contains information of a more technical nature. In addition, our online Trellix Support Web site will be updated frequently, and may contain information that is more up to date than the information in this file. We are very interested in your feedback about Trellix User Assistance. To advise us of problems you would like to see fixed in the next release, send us email via support@trellix.com. ------------------------------------------------------------------------ ------------------------------------------------------------------------ Technical Supplement Trellix Viewer 1.0 and Trellix 1.0 ---------------------------------- It is not necessary to install both Trellix Viewer and Trellix 1.0 on the same desktop. Trellix contains a superset of the Trellix Viewer functionality. The two products have some files in common and some not in common. Installing only one conserves disk space and can prevent confusion between them. If you have both Trellix and Trellix Viewer installed and registered, then Windows Explorer right-click menus are enabled as follows: - Edit opens the document in Trellix - View opens the document in Trellix Viewer - Open opens the document in whichever program (Trellix or Trellix Viewer) was most recently launched If you have both Trellix and Trellix Viewer installed and you want to uninstall only one of them, answer "No" when asked whether you want to delete shared files. If you answer "Yes" your system will remove some common files, preventing the companion program from launching smoothly. If this occurs, when you launch the other program, a message will advise you how to find and run INSTFIX.BAT (a file created during installation, customized for your system registry), which will fix the problem. Working with Supplementary Images from "Extras" ----------------------------------------------- Trellix 1.0 CD-ROMs contain a supplementary directory, Extras. The directories within it, Buttons and Backgrounds, Clipart, and Photos, contain additional images you may use within your Trellix documents. They are not automatically installed, in order to conserve disk space, and to allow you to review the licensing agreements associated with their use. You can use the Windows Explorer to drag and drop any of these images from the CD-ROM to directories on your local machine or a network. Consult the image licenses in each of the directories for further information. The Buttons and Backgrounds directory includes all images used in the Trellix document designs, including background images and the images used for navigation buttons. It also includes various background and texture-style images. You can add any of these images to your documents. Images in the Clipart directory are pre-converted to use the Trellix palette, and each has a cyan or magenta background so that its background can easily be made transparent. Each of the images in the Photos directory is supplied in several sizes. Smaller-sized versions are in full, vivid color, while larger sizes are lightened so they can be used as backgrounds. Un-Installing Trellix And Its Components ---------------------------------------- To uninstall the Trellix software, use the Uninstall command on the Start - Programs - Trellix menu. You can uninstall other installations, for example, installation of the sample files, by selecting Settings - Control Panel - Add/Remove Programs and then selecting the additional numbered "Trellix" items from the list. ActiveX Document Capability --------------------------- Trellix files are "ActiveX documents." This means that you can use Trellix Viewer to launch them within Internet Explorer and other browsers that support ActiveX documents. To enable this capability, choose the View - Always Within Browser option within Trellix Viewer. For more information on Trellix Viewer's cooperation with browsers, see the Trellix Viewer README.TXT file. Note that ActiveX document capability is NOT the same as "ActiveX control" capability. Controls cause editors to appear within (or on top of) windows; documents fill the entire available window space. Trellix itself cannot currently be launched within browsers; if you open a Trellix document within a browser, Trellix launches in a separate window as usual. You can also produce a browser-friendly version of a Trellix document by exporting it to HTML. You can optionally include an interactive copy of the Trellix document map. Using Images Within Trellix --------------------------- For more information on how to insert and work with images, see Trellix Help: within Help Topics, choose How Do I? - Work with Images. Storage Each image file inserted into a Trellix document is stored only once, no matter how many times it is used within that document. For example, once you add a corporate or personal graphic to a single page, you will not materially increase the size of the Trellix file by using that same image on every page in the document or incorporating it into a page layout. You may separately crop and resize the image in each location where it appears, but each image can have only one designated transparent color (if any) per document. The Trellix Palette Trellix uses its own 256-color palette, which is made up of the 216- color basic Web palette along with some added colors. Most images (except for JPEG and PIC format images) brought into Trellix are converted for use with this palette. Netscape Navigator and Internet Explorer both use at least the same basic Web palette as Trellix does (Internet Explorer adds a few extra colors). If you intend to publish a Trellix document to HTML, try to design any included images so they use the basic Web palette colors common to Trellix and the browsers. If you do not, there may be discrepancies between the appearance of images in Trellix and what appears in HTML output when viewed in 256-color displays. If you are creating images outside Trellix for use in Trellix, consider dithering the images to the Trellix palette in advance. You can use one of the images in the Extras\Clipart or Extras\Buttons and Backgrounds directories on the Trellix CD-ROM to recreate the Trellix palette. Sample Photographs JPEG is the preferred format for photographic images brought into Trellix. When you use Insert - Image to add JPEG files to pages within Trellix documents, Trellix saves the image's data exactly as it came in, and displays that exact JPG (up to 16 million colors, depending on the JPEG's quality and the limitations of each user's graphics card) without causing a new palette or any further compression to be applied. Similarly, when you publish a Trellix document that contains JPEGs, they are exported (for use in browsers) at the exact same level of quality. (Non-tiling background images may be an exception. See "Publishing Documents with Non-Tiling Background Images," below.) You can only insert 24-bit JPEG images in Trellix. You cannot insert 8- bit JPEG images. The \Images\Photos subdirectory within your Trellix installation includes examples of high-quality photographic images that can be added to Trellix documents using the JPEG format. One is a close-up photograph of a butterfly, and another is a photograph of a landscape, sized and lightened to make it suitable for use as the background of a border or page area. Additional images can be copied from the Extras\Photos directory on the Trellix CD-ROM. Samples of Line Art Inserted images of all other formats will be converted to the Trellix 256-color palette: this will cause visible changes only if they were originally created at a much higher color resolution or if they contain colors not found in the Trellix palette. The \Images\Clipart subdirectory within your Trellix installation includes examples of clip art that can be added to Trellix documents. These images are pre-converted to the Trellix palette, and they have cyan- (0,255,255) or magenta-colored (255,0,255) backgrounds so that you can easily make the background transparent without disturbing the rest of the image. Additional images can be copied from the Extras\Clipart subdirectory on the Trellix CD-ROM. Tips on using them effectively can be found in the file CLIPARTINFO.TXT. Samples of Backgrounds The \Images\Buttons and Backgrounds subdirectory within your Trellix installation includes examples of background textures that you can add to a Trellix page body or border or to the map. Additional images can be copied from the Extras\Buttons and Backgrounds subdirectory on the Trellix CD-ROM. Publishing Documents with Non-Tiling Background Images If you insert a non-tiling background image in a page body or border and then publish the document to HTML, Trellix places the image in the upper-left corner of the HTML output and then increases the canvas size (that is, adds extra space around)of the image so it doesn't tile when viewed with a browser. Trellix increases the canvas size by adding a border the same color as the image's background color below and to the right of the image. - If the image appears in a top or bottom border, Trellix increases the image size to 1024 pixels wide. The image height in the HTML output corresponds to the border height. - If the image appears in a right or left border, Trellix increases the image size to 768 pixels high. The image width in the HTML output corresponds to the border width. - If the image appears in the page body, Trellix increases the image size to 1024 pixels wide by 768 pixels high. Note that there may be some artifacts (image blurriness, color swapping, etc.) in the expanded version of JPEG images. If you don't want Trellix to increase the canvas size of a non-tiling background image, you can expand the image yourself to 1024 by 768 pixels or larger prior to publishing the document to HTML. One implication of the above is that even when Trellix increases the canvas size, you will still see some tiling if your display is set to a resolution of 1280 x 1024 pixels or higher. Pasting From Rich Text Format (RTF) Documents There are known problems cutting and pasting images (via the clipboard) from applications that produce Rich Text Format (RTF)output (whether or not there is text in the section being cut). There may be quality problems or pasting may occur unusually slowly. Applications that use RTF include Microsoft Word and WordPad. For best results, insert the image directly from its original file. If that is not available, use the Windows clipboard to move the image into any application that does not produce RTF, such as the Paint or Photo Editor utilities that optionally install with Microsoft Office, and from that application into Trellix. You should also use this method for embedded OLE objects. Summary of Known Constraints - Using Insert - Image, all images except for JPEGs and PICs are converted to the Trellix palette (256 colors). JPEG and PIC images do not have a new palette applied; they retain their original color density; no transparent color can be set for them. - All images inserted via the clipboard (regardless of their previous format) are stored in PIC2a format (256 colors). Depending on hardware speed, large images coming in from the clipboard may be slow in appearing in Trellix. - Trellix accepts TIFF images only if they are RGB-type TIFFs. - Trellix does not take advantage of any progressive images, such as animated GIFs. You can import them, but the image that will appear in Trellix pages is only one of the images in the sequence, usually the final image. - Copying GIF format images from Microsoft PowerPoint may cause unintended changes. In particular, PowerPoint's automatic color correction and format improvements (to the original GIF) are lost. - If a GIF file you import already includes a transparent color, Trellix does not automatically recognize it. You must set the transparent color manually. - Images cannot be dragged and dropped into the middle of any link or field: in place of the image, a single blank character is pasted. - If you set a transparency color for an image, the color you set will be used for all instances of that image in the current document. In other words, an image always has the same transparency color (if any) no matter how many times it appears in a document. - Images in the map can only be expressed in 256-color format. - Resizing done within Trellix uses the Windows system resizing functions, which are optimized for speed. Graphic designers and other creators of studio-quality graphics will likely prefer to resize their images outside Trellix using an advanced image manipulation package. - When you use images on a Trellix page, you can select Image Properties - Resize - Size to Region. This feature is a convenience for editing; it populates the Resize dialog with the new dimensions. It does not affect printing; in other words, when the region size changes on the printed page (as it often does), the image size does not change.(1790) If you do select the "Size to region" option for an image and then resize the border in which the image appears, note that the image doesn't automatically resize. You must use the Image Properties dialog box again to size the image to the new dimensions of the border. - When you crop an image, the Image Properties reflect the cropped size (expressed as width x height), which is the size after cropping (as in Microsoft Office 97). - In the map, if you paste an image that is larger than the total extent of the map, Trellix automatically shrinks the image so that it fits within the map (not the visible portion of the map, but the entire map; choose Map - OverAll Map to see it). - An image's Properties dialog does not reflect any initial automatic shrinking of images pasted in the map, or any other resizing that is achieved by dragging a corner of the image in the map; they only reflect changes you make via the dialog. Removing Only the Quick Tour ---------------------------- To remove the Trellix Quick Tour that is automatically included with Trellix, go to the \Trellix\program directory and delete two files: PLAYERX.EXE is the free, distributable player module for Dan Bricklin(R)'s demo-it!(tm) available from Lifeboat Publishing START_UP.DMR contains the Quick Tour's content (You can also run the Quick Tour from the Windows Explorer by placing these two files in the same directory and placing START_UP upon the PLAYER.) Once you have removed these two files, the menu item Help - Quick Tour will no longer function. ------------------------------------------------------------------------ ------------------------------------------------------------------------ Known Problems Installation ------------ On rare occasions, both Trellix and Trellix Viewer may ask you to insert a "DLL Installation" disk while you are installing. The file that is being sought may be one of the following: HLINK.DLL ACTXPRXY.DLL These two files are components of your system software, and may also be installed by desktop applications and browsers, so they are most likely already present on your system, or you can find them on the disk named in the message. Inserting the requested disk, clicking Browse, and then clicking OK usually finds the file. Under Windows 95, there are known problems using Trellix Viewer with the IntelliPoint driver version 1.1: when you set the mouse option Snap Pointer to Default Button option, you cannot use the right-click menus. Installing version 2.0 of the driver fixes the problem. General ------- "Save As" reduces the size of an existing Trellix file by forcing it to be compressed. Trellix documents can use all True Type fonts installed on each editor's or reader's system. As with all Windows programs, when you open a document that was originally created with fonts that your system does not have installed, font substitution will occur. Images that serve as links don't display differently from other images; in other words, they don't have marks that indicate they are links. You can tell they are links by moving the mouse cursor over them. When you view a web page inside Trellix, and click on links within it, pages visited are not reflected in the Trellix history lists, and cannot be revisited using the Trellix Back and Forward buttons. Although the position and relationship of map and pages is saved with each Trellix document, the "currently active page" is not always saved. If you open a file, change which page is active, and then save the document immediately, the change in active page is not saved. To force Trellix to save all your changes, when you change the active document, make sure you also change something else about the document: for example, a few characters on any page. The map window always stays in front of the application window; it cannot be sent "behind" the application. However, you can hide it by clicking buttons on the toolbar or using commands on the Map menu. When you use Save As to change the name of a document, the Trellix history lists extend from the current document back to the previous document. If you use either the lists or the toolbar buttons to go "back", the previous document will open in a separate Trellix session. Editing ------- In the map, if you select a group of objects, copy them, and then paste them, you can paste in such a way that some of the objects are 'off the map'. Such objects can no longer be viewed or selected. In Outline View you cannot drag a page to the end of a sequence. There are two possible workarounds: (1) use the map to drag it to the exact location you intend; (2) use Outline View to drag it to the next-to-last position, and then drag the last page up above it. When you select an Up level for a page, an Up level link is automatically activated. However, in some document designs, the border that shows the Up level link may only appear when the page is on a sequence. In such a case, to have the Up level link appear on a border that is already displaying, you must create that link yourself using Link - Create Navigation To - Up Level. You can select one or more text labels in the map and change the font family, size, and style (bold, italic, or underlined) of that entire group of labels. However, you cannot use the other text toolbar items to edit map labels; for example, map label colors can only be changed by selecting the label and then right-clicking to see its Properties. When you use Edit - Copy to move text and images from a page into the Windows clipboard, the resulting text can be pasted to a variety of software programs. However, images copied from Trellix pages to the clipboard can only be pasted into another Trellix document; they do not show up in the clipboard when pasting into other applications. Images copied from the Trellix map cannot be pasted back into Trellix. In Viewer Preview, it is not possible to copy entire Trellix pages. Occasionally it may be possible to select a page in the map and choose Edit - Copy, but the clipboard will not contain anything equivalent to a page that can be pasted. In the Tab dialog, if you press Clear followed by OK, you replace all tab settings (both the defaults and any tabs entered manually) with paragraph characters ("carriage returns"). Clear All does not have this problem, and no problems are caused if you click Clear and then Cancel. Trellix warns you if you delete the page that is contained in the current page. However, this warning does not occur if you repeat this action twice, or if the container page is not currently displaying. To restore pages deleted by accident, use Edit - Undo. Printing -------- Trellix printing is not optimized for black and white printers, so it may not use their full range of available gray scales. It is not possible to print documents whose maps contain more than 1000 objects (counting pages, maps, sequences, and labels). Trellix images can be stretched to fit the regions where they are inserted. However, later changes to the size of the region, whether onscreen or during printing, do not cause further changes to the size of the image; images may therefore print differently than they look. Certain Windows 95 printer drivers have trouble with light text on dark backgrounds. With these drivers, we have noticed problems in the printing of small numbers that indicate footnotes when the text is light and the background is dark. If you see this problem, it can be alleviated by switching to a dark font on a light background, sending the job to a different printer, or printing from within Windows NT. Sending Trellix Documents Via E-Mail ------------------------------------ You can use File - Send to automatically compress a Trellix document and enclose it in an email message. Your recipient must have Trellix Viewer or Trellix to execute and read the document; if neither program is present, a message explains how to obtain them. If you have problems using "Send To," check whether you are using an email program that is already an MS Exchange Supported MAPI client. If not, make your email program the MAPI client. Page Layouts and Styles ----------------------- In many existing page layouts, the border that contains the title is filled with text that came from the page layout. In other words, there is no room for authors to type text in the title border, unless they use Edit - Paragraph - "Edit text included with document design" to change that area so it is editable. This will be fixed in future releases of Trellix. In Page Properties, when you click the 3-D bars and set the width to zero, you get a visible edge of about a pixel. This is because the width refers to the space between the 3-d borders: 0 means that there is no space between the highlight and the shadow. It is possible to get anomalous results when you create an automatic list (using Link - Create List Using) that is indented, from a location where there is already an indented style. If anomalies occur, delete the list and re-create it to fix them. Importing from Microsoft Word ----------------------------- The \Trellix\Samples directory contains a file, WORDIMP.DOC, that walks through the steps of importing a Word document into Trellix. In the process of importing Microsoft Word files, Trellix opens Word. Before starting to import, manually close any Word sessions that are open, and do not attempt to launch Word again until the import has finished. Opening another Word session during import can introduce errors; in addition, since Trellix closes Word after importing, changes you enter in the that Word session will also be lost. Miscellaneous ------------- In saved documents that contain tour sequences, one of the tour lines is always gray. This is likely to be the last tour sequence touched by the document's author. The document's functionality is not affected. When you delete a file you have previously been reading, and then use the list of recently used files on the File menu to try to open the non- existent file, the resulting message is misleading: it implies that the file is not a Trellix document. When you use Save As to convert a Sneak Peek document to Trellix 1.0 format, and the Sneak Peek document was saved using Viewer Preview, the new document will be in author mode. To restore Viewer Preview, you must change modes manually and save the document again. Under Windows NT, if you log onto the current machine as any user other than the user who installed Trellix, you may be able to start Trellix, but you cannot see the "Publish to HTML" menu item. To see it, re- install Trellix using your current user name. Help and Quick Tour ------------------- There is a known problem running the Quick Tour on certain displays set to "True Color": portions of the tour graphics may be black as a result of interactions between PLAYER.EXE and some video drivers. If you see this anomaly, you can view the Tour as designed by temporarily changing your display settings to display fewer colors. Trellix Help is subject to a known Windows Help problem: If you open a Help topic that appears in a sub-window (for example, a procedure-style window) and then minimize it, and then choose Help again from the menu, the sub-window will attempt to display and then cause an application error. This error can usually be dismissed without crashing Trellix. ------------------------------------------------------------------------ ------------------------------------------------------------------------ Publishing to HTML Both HTML and browser specifications and practices continue to evolve. For the latest information on Trellix and HTML, contact Trellix Technical Support (choose Help - Technical Support). When Trellix produces an interactive map as part of its publication process, the map is always positioned in a frame above the page body, no matter where the map was positioned (on the side, or below) in the Trellix document. Maps in different positions are expected to be added in a future release of Trellix. It is possible to create file links in Trellix that do not correctly export to HTML running under Netscape Navigator 3X and above. Links are created when you choose Link - Create Link to URL or File. The correct approach is to first choose whether you want a URL or a File; links created with the correct prefix should export correctly. However, Trellix does not check whether the name you entered is a match. For example, if you choose URL, but replace the "http://" with a file's UNC path such as \\servername\path\filename, the link will ultimately be exported as "\\servername\path\filename", which can be understood by IE but not by Netscape. You will see browser problems if you export a Trellix document when no page is visible onscreen. ("No page is visible" when you delete the current page and you have not yet selected another.) "Con" is not a valid name for the directory to which HTML is exported. It is possible to get in a state where the interactive map does not work correctly, usually after printing in Internet Explorer. Using the browser's Back and Next buttons to move off and on the Trellix document usually restores the map's function. HTML Details Fonts in Trellix documents exported to HTML are optimized for the default font settings of Netscape Navigator 3 and 4 (Proportional Font Size = 12pt) and Internet Explorer 3 and 4 (Medium). If you have changed these settings your exported document may look different from its Trellix version. Exported background images always scroll with text. Alignment settings are not applicable, but a background image's Tile settings are honored: When neither Tile Vertically nor Tile Horizontally is selected, the background image always appears as top left aligned with no tiling. When Tile Vertically is selected, the background image appears left aligned and vertically tiled. When Tile Horizontally is selected, the background image appears top left aligned and horizontally tiled. When both Tile Vertically and Tile Horizontally are selected, the background image appears as top left aligned, tiled both vertically and horizontally. The image description you can set on the General tab of the Image Properties sheet is used for the image's tag content, the description shown as a pop-up on some browsers. Bulleted lists are always indented, with two breaks (
)at the end of the list. In Netscape Navigator 3 only, all bullets appear black (colors are not preserved). Any indented paragraph will be put in the tag when exported to html, and results in having an extra blank line at the end. Link colors after export: - The basic (non-visited) link color used for each border is the color of the first link in the region (whether or not multiple colors are used in the Trellix document). - Visited links are the color of a region's default font, specified on its Properties sheet (Advanced - Modify - Font). Edges on Trellix borders are not exported. Navigation buttons are always exported to HTML, whether or not pages that contain them are on sequences. If you do not want buttons to appear in HTML, delete them manually before exporting. End of file - last edited 8 November 1997