You can use the smallscreenignore HTML tag to create HTML pages that display differently on different platforms. This tag allows you to specify that portions of the page are ignored when the HTML page is viewed on a Palm PoweredTM handheld. When returning HTML pages back to the device, the Palm proxy servers strip out any content that is found between the <smallscreenignore> and </smallscreenignore> tags. For example, if your online page includes the following code:

<smallscreenignore>
      <img src="largepic.gif">
</smallscreenignore>

Then the largepic.gif image displays when the page is viewed on a desktop browser, but not when the page is viewed in your web clipping application.

Link to local files

One simple way to reduce the amount of data that needs to be transmitted from the Palm proxy servers to the user's Palm Powered handheld is to use local content, which is data stored in your web clipping application (.pqa) file. You can refer to this content-images or HTML file-in your links.

If any page in your local web refers to local content, the Web Clipping Application Builder (WCA Builder) program automatically builds includes the referred-to page or image in your application file. WCA Builder does this by traversing your entire web, following the links it finds:

• if a link on your index page refers to a local page, that file is bound into your built application, and its links are followed
• if a link on any included page refers to a local file, that file is bound into your built application, and its links are followed
• if a link on any page refers to a local image, that image file is bound into your built application

You can also use the Palm LOCALICON meta tag to force WCA Builder to bind in images or pages that are not referred to by other pages. When WCA Builder finds the LOCALICON meta tag in a page, it treats the content portion of the tag just like as it does a local file (HTML or image) that is linked to by another page in your web. The following is an example of using the LOCALICON meta tag:

<META name="LocalIcon" Content="My.gif">

To refer to a local image or HTML page in an URL, you use the file designator. Specify the name of your .pqa file as the directory name, and specify the image or HTML name as the file name. For example, to refer to the image file shown in the previous example, you would use the following HTML statement:

<IMG SRC="file:myapp.pqa/my.gif">

or in the case of a local html file

<a href="file:mypqa.pqa/personal.html">My Personal Page</a>

About Images

The Web Clipping Application Viewer (the Viewer) treats image borders differently than many browsers. You need to be aware of the following issues:

• The default border value is 0.
• To display a border, you must specify an even number value.
• Borders are always drawn as one pixel wide.
• The Viewer does not automatically draw a border around an image that is part of an anchor tag.
• Starting with version 4.0 of the Palm OS, the Viewer allows horizontal scrolling of images. Image scrolling only works, however, if the page includes the PalmComputingPlatform meta tag.
• In earlier versions, the maximum width of an image on the Palm VIITM and similar Palm Powered handhelds was 153 pixels, and if you attempted to include an image that wider than 153 pixels, the Web Clipping Application Builder generated an error.
• The height of the content area on Palm Powered handhelds is 144 pixels. If you include an image that is taller than 144 pixels, the Viewer displays it and allows the user to scroll down to see the remainder of the image. However, Palm, Inc. strongly discourages this behavior, because requiring the user to scroll lessens the quality of his or her experience.
• Starting with version 4.0 of Palm OS, you can include images with varying bit depths in your web clipping pages. The proxy server maps images into the appropriate bit depth for the device. For example, the proxy server will scale a 16-bit color image down to 2-bit or 4-bit grayscale if sending the image to an older Palm device.