home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Computer Buyer 1998 July
/
dpcb0798.bin
/
Internet
/
Trellix
/
README.TXT
< prev
next >
Wrap
Text File
|
1998-01-05
|
31KB
|
652 lines
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 <ALT> tag content, the
description shown as a pop-up on some browsers.
Bulleted lists are always indented, with two breaks (<br>)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 <table> 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