Expandable Language  
  Home Order Download
 
 
Products
ChangeAgent
HTML Rename!
Services
 
Support
ChangeAgent FAQ
HTML Rename! FAQ
 
News
About xlanguage
Mailing lists
Site Map
 
If Tools Had Friends

ChangeAgent™ Frequently Asked Questions (FAQ)

What is the current version?
Why do some filenames have lines through them?
What does the yellow triangle overlayed on an icon mean?

Why can't I see inline images in the Link View?
Why can't I see external links in the Link View?
Why is the Link View always blank?
Why don't I see image and HTML file previews or thumbnails?
How can I undo a fix I applied in the "Fix All Links" or "Replace Link" dialogs?
Why is ChangeAgent reporting HTML syntax errors in my JavaScript?
Known bugs

What is the current version?

The current version of ChangeAgent is 1.20. View the version history.

Why do some of the file names have lines through them?
What does the yellow triangle overlayed on an icon mean?

ChangeAgent displays files that are unlinked in the site (orphan files) with a strikethrough text and a broom icon .

Why can't I see inline images in the Link View?
Why can't I see external links in the Link View?
Why is the Link View always blank?

The Link View toolbar contains several icons for filtering the list of links. When a button is in the "down" state the corresponding links are shown, when a button is in the "up" state the corresponding links are hidden.

Icon Filtering (down means show, up means hide)
Show/hide good links (when site is tracked)
Show/hide local links (when site is not tracked)
Show/hide bad links
Show/hide external links
Show/hide content links (href="url")
Show/hide embedded images/objects (src="url")

If you hide good links, bad, links, and external links, the list of links will always appear empty. Likewise, if you hide both content links and embedded images/objects, the list of links will always appear empty.

If you believe that a file contains a link that you are not seeing, toggle all of these toolbar buttons into the "down" state.

Why don't I see image and HTML file previews or thumbnails?

Previews and thumbnails use a Windows® API that is a part of the Windows® Active Desktop®. Active Desktop® was not available on the original releases of Windows® 95 and Windows NT® but is an optional installation when upgrading Internet Explorer. (Active Desktop® is available on all Windows® 98, Windows® me, Windows® 2000, and Windows® XP systems). You can check for Active Desktop® by selecting the Windows® Explorer "View" menu. If you see an "as Web Page" menu item in this "View" menu, Active Desktop® is installed®.

If you do not have Active Desktop® installed on your system you can get ChangeAgent to display previews in one of two ways:

  • Install Active Desktop®
  • Install the Glab ActiveX® control

To install Active Desktop®, go to the following URL at Microsoft's web site and follow the directions there (note that it is always prudent to make a full system backup when upgrading system components):

  • http://support.microsoft.com/support/kb/articles/Q165/6/95.ASP

To install the Glab ActiveX® control, go to the following URL at Expandable Language® web site to download the installer program, and then run it.

  • http://www.xlanguage.com/bin/glab.exe

NOTE: Installing the Glab ActiveX® control will enable ChangeAgent to show image previews in the "Fix Links" dialogs, the "Remove Orphans" dialog, the "Find Target" dialog, and the Details/Links View, but it will not show thumbnails of multiple files in the Details/Links View when a folder is selected.

Can ChangeAgent replace links using a relative URL format?

Yes. ChangeAgent does not change the format of links when it replaces links—relative links stay relative, "rooted" links stay "rooted", and absolute links stay absolute.

The "Fix Link" dialogs show links in "rooted" format to indicate the directory path to the actual target file (e.g., "/support/contact.htm"), but if a relative link in a "support\index.htm" file is replaced, the tag will read <a href="new_contact.htm">.

Why are links in the Fix All dialog showing up in the "_Broken" group rather than the "_Filter out" group?

If you are tracking sections of a site and a link that should be in the "_Filter out" group is in the "_Broken" group, you need to make sure that the folder containing the link target exists.

For example, if you want to exclude an "/in_progress" section but you deleted the "in_progress" folder from the local copy of your site, all links to the "in_progress" section will appear broken. To make them appear in the "_Filter out" group:

  1. Create an empty folder named "in_progress" at the root of your site
  2. Open the "Include/Exclude Site Sections" dialog from the "Define Web Site" dialog
  3. Explicitly exclude the "in_progress" section by unchecking it
  4. Close the dialogs, which retracks the site

Now that the "in_progress" folder is explicitly filtered out, links into that section of the site will appear in the "_Filter out" dialog.

How can I undo a fix I applied in the "Replace Link" or "Fix All Links" dialogs?

  • For the "Replace Links" dialog, after clicking "OK" to apply the fix and pop down the dialog, select the "Edit:Undo" menu item to undo the fix.
  • For the "Fix All Links" dialog, first click on the "Done" button to pop down the dialog, then select the "Edit:Undo" menu item to undo the fix.

Why is ChangeAgent reporting HTML syntax errors in my JavaScript or ASP code?

ChangeAgent parses pages looking for tags delimited by '<' and '>'. If it sees HTML code with a greater than or less than sign (rather than &gt; and &lt;) and no matching angle bracket it reports it as an HTML syntax error, since it is possibly a broken tag.

Within script code, ChangeAgent tries to ignore the greater than and less than comparison operators while still looking for static URL text. In some cases ChangeAgent is "overly vigilant" in reporting HTML syntax errors where it shouldn't.

One example is when ChangeAgent searches for literal URLs in JavaScript function calls. If your JavaScript uses parentheses to group an expression containing a greater than or less than operator, such as "(a.getMonth() > 10)", ChangeAgent may interpret the parentheses as a function call and falsely report an HTML syntax error.

False HTML syntax error reports of this type will be fixed in a future version.

NOTE: These HTML syntax error are advisory only and do not indicate critical errors. You can disable the report of HTML syntax errors by selecting "Options..." from the "View" menu, clicking on "Logging & Notifications" in the list on the left side of the Options dialog, and unchecking "Report syntax errors on site loading and in statistics report".

Known Bugs in ChangeAgent version 1.2

URL lists in the "archive" attribute of an <APPLET> or <OBJECT> tag

URL lists in the "archive" attribute of <APPLET> or <OBJECT> tags are not handled correctly. They are treated as a single URL and reported as broken links. Files in the URL list will be reported as orphans unless they are referenced by themselves elsewhere in the site.

The workaround is to move the URL list into the "_Ignore" list in the Fix All Links dialog and uncheck the incorrectly reported orphans in the Orphans dialog.

Undoing a Rename command sometimes renames previously broken links

If a file has a link to "good.htm" and a second broken link to "aardvark.htm", renaming "good.htm" to "aardvark.htm" will result in the good link being renamed and the bad link being resolved (after the rename, the file has two links to "aardvark.htm"). Undoing the command fails to leave the second "aardvark.htm" alone and instead changes both of the links back to "good.htm".