Microsoft KB Archive/174055

= FP98: How to Create a Channel Definition File =

Article ID: 174055

Article Last Modified on 8/27/2002

-

APPLIES TO


 * Microsoft FrontPage 98 Standard Edition

-



This article was previously published under Q174055



SUMMARY
This article describes how to create a Channel Definition Format (CDF) file and some of the tags used in the CDF file.



MORE INFORMATION
As a content provider, you can create one CDF file for each type of Channel you want for your Web site. A CDF file allows users to subscribe to your FrontPage Web as a Channel or a desktop component.

When users subscribe to your FrontPage Web as a Channel, they can browse your Web offline, display updates to your Web on their screen saver, and download or receive e-mail notifications when pages in your FrontPage Web are modified. This feature is available only in Web browsers that support Channel Definitions, such as Microsoft Internet Explorer, version 4.0.

Creating a Channel Definition Format File
You can use the Channel Definition Wizard to create a CDF file in FrontPage 98, using these steps:  In FrontPage Explorer, click Define Channel on the Tools menu. Click "Create a new Channel Definition Format file for the current FrontPage Web." Click Next. On the Channel Description panel, enter the following information:  In the Title box, enter a title for your Web page. In the Abstract box, enter a short description about your Web page. In the Introduction Page box, type the path and file for the page you want. Or, click Browse, select the file you want to use, and click OK. In the Logo Image box, type the path and file name of the image you want to use. Or, click Browse, select the image file you want to use, and click OK.</li> In the Icon Image box, type the path and file name of the image you want to use. Or, click Browse, select the image file you want to use, and click OK.</li></ol> </li> Click Next.</li> On the Choose Source Folder panel, in the Source Folder box, type the path for your Web content. Or, click Browse, select the folder you want to use, and click OK. Click Next.</li> On the Edit Page panel, select the page or pages you do not want to include in your channel and then click Exclude. NOTE: To select multiple files, press and hold the SHIFT or CTRL key as you click each file you want. Click Next.</li> On the Channel Item Properties panel, do the following.

NOTE: You can customize each item on this panel. <ol style="list-style-type: lower-alpha;"> In the Channel Items list, click the item you want to customize and then set the following properties or click Delete to delete it. <ul> Abstract</li> Page Cache</li> Usage</li></ul> </li> Repeat step a for each item you want to customize. When you are finished, click Next.</li></ol> </li> On the Channel Scheduling panel, set the following options: <ul> Start date.</li> End date.</li> How often you want the user's computer to check for updates</li> The time schedule you want to delay connections to your site.</li></ul> </li> <li>Click Next.</li> <li>On the Log Target panel, in the Log Target URL box, enter the Uniform Resource Locator (URL) of the Common Gateway Interface (CGI) script you will use to process the information, click Browse to locate the CGI script, or leave the Log Target URL box blank. Click Next.</li> <li>On the Finish panel, in the File Name box, enter the name of the CDF file you want or click Browse to select a specific file. Click Save.</li></ol>

NOTE: You can see your CDF file by clicking All Files on the Views bar in FrontPage Explorer.

Channel Tags
A CDF file is a text file that contains a list of HTML tags, which reference specific Web pages on a particular Web site. (These tags, along with the entire CDF file description, have been submitted to the Word Wide Web Consortium and are awaiting acceptance.) Some of the new HTML tags in the CDF file that are created by the wizard are discussed below.

All CDF files must begin with the following tag:

<?XML Version="1.0" encoding="iso-8859-1" ?>

This identifies the file as an Extensible Markup Language (XML) file so that it can be processed appropriately by the browser.

The <Channel> and </Channel> tags start and finish the CDF file. You can use multiple <Channel> tags to create sub-channels. The hyperlink reference (HREF) attribute for this tag points to the top-level Web page in the Channel.

The <Title> tag allows you to specify a title for the Channel. You will be able to see this in the Channels list on the Favorites menu.

The <Abstract> tag allows you to specify a text string that displays a ToolTip when the mouse passes over an item. You can specify an abstract for the primary Channel and each item within the Channel.

The <LogTarget> tag allows you to specify a custom CGI script that records information about browsing habits of users logged on to the Channel.

The <Schedule> tag allows you to schedule the time intervals for updating subscriptions and delaying connections.

The <Log> tag specifies which graphics are used in the Channel Bar on the Windows active desktop and in the Channels list on the Favorites menu.

The <Item> tag denotes each individual page of content on the Web-site that you want to be displayed in the Channel.

The <Scope> tag defines whether the pages in the Channel are to be downloaded to the subscriber's computer or the subscriber must connect to your Web to view changes.

The Channel Definition Wizard outputs a valid CDF file. The Channel Definition Wizard does not create some of the advanced features that can be used in CDF files. These features are:
 * Time zones in download schedules.
 * Multiple items for a given HREF.
 * Control of Web crawling levels.
 * Separate control of the Netcaster-compatibility anchor tag.
 * Sub-channels.
 * PurgeTime or Type On Tracking elements.
 * Per-item control over the Track attribute.
 * Per-item control over the Logo element.

NOTE: Microsoft FrontPage does not provide an interface that allows you to edit the CDF file and add these tags. However, if you edit the CDF file in Notepad, FrontPage will preserve your changes the next time you run the Channel Definition Wizard.

<div class="references_section">