HTML Rename!(TM) version 1.21 Copyright (c) 1996, 1997 Parker & Associates All rights reserved WHAT DOES HTML RENAME! DO? -------------------------- HTML Rename!(TM) eliminates the problems encountered when moving files between DOS/Windows, Macintosh, and UNIX file systems. By changing file names (case, length, and invalid characters) and fixing links in HTML code, HTML Rename! ensures that your files and Web pages will work on any operating system. Using HTML Rename! before you transfer files (for example, uploading a Web site to a UNIX server) saves you from needing to repair mangled filenames, broken links, and extra or missing carriage return characters in text files. HTML Rename! assists Web site development by checking the consistency of URL links and generating reports on local and external URLs. It guarantees that your site will work on any operating system by enforcing a file naming convention. HTML Rename! can automatically change every filename to fit a new naming convention, or you can choose to individually alter each invalid filename as HTML Rename! reviews it. Run HTML Rename! before each Web site upload and never have another broken link! HTML RENAME!'S FEATURES ----------------------- * Targets DOS, Macintosh, UNIX, and other filesystems -- including ISO 9660 (the most universal naming structure on the planet) * Reports and renames files whose names are invalid on a target system * Automatically or interactively generates valid filenames * Updates links in your HTML pages for renamed files * Converts local links to relative or absolute URLs * Forces URL links to be case consistent with filenames * Alters file extensions such as HTML, JPEG, MPEG, & PING for the DOS/Windows, Macintosh, or UNIX convention (and fixes the names in the HTML code simultaneously) * Reports missing and external links * Reports files not referenced in a Web site (great for finding stray graphics and old files no longer in use) * Updates ASCII line ends for DOS/Windows, Macintosh, or UNIX format * Works on a single directory or an entire directory tree * Uses a clear, easy-to-follow, graphical wizard interface WHAT PROBLEMS DOES HTML RENAME! SOLVE? -------------------------------------- 1) Moving a Web Site to a Different System Can Break URL Links. Typically, development of a Web site is done locally on a PC or Macintosh and then uploaded to a server as the final "publishing" step. If the server runs a different operating system than the local development system, transferring the site to the server may break local URL links. One example of this is the strict filename upper and lower case sensitivity in UNIX. If you have an image file named "Janine.gif" and reference that file as the image will work when testing on Macintosh or Windows. On a UNIX server, however, you will get a broken GIF because UNIX enforces stricter case sensitivity than the Macintosh or Windows. HTML Rename! fixes this by changing the URL link to , matching the filename exactly. Other examples are characters which can appear in filenames on one system but not on another. For example, the filename ".gif" is valid on Macintosh and UNIX but not on Windows because of the greater- than and less than "<>" characters. If you transfer a Web site containing this file to an NT server, the links to this file will be broken. Yet another example is differing filename extensions. For HTML, JPEG, MPEG, and PING files; Macintosh and UNIX require the filename extensions "html", "jpeg", "mpeg", and "ping"; while Windows requires "htm", "jpg", "mpg", and "png". HTML Rename! fixes all of the above problems, and more! 2) Verifying Your Web Site's URL Links You can also use HTML Rename! to verify that your site is squeaky-clean with no broken links. HTML Rename! directly checks your local links and generates a list of external URLs which you can check by loading the list into your Web browser. At the same time, HTML Rename! can verify that no links will get broken in the process of uploading your Web site to your server. 3) ISO 9660 Filenames for CD-ROMs Many CD-ROM burning programs give you the option to automatically convert filenames to ISO 9660 format, a specification which guarantees all operating systems will understand the filenames. HTML Rename! gives you a finer granularity of control, allowing you to generate a report of needed changes without renaming files, or to interactively rename files, providing names which make more sense for your documents/data. 4) Graphical, Directory-based unix2dos, dos2unix, unix2mac, etc. DOS/Windows, Macintosh, and UNIX all differ in their conventions for line endings of ASCII text files. As a result, files created on one system and read on another may appear as one very long line, or with garbage characters at the beginning or end of every line. Most UNIX systems have the dos2unix and unix2dos command line utilities to convert files one at a time. HTML Rename! provides a graphical user interface to perform these operations on entire directories of files in one pass. SYSTEM REQUIREMENTS ------------------- HTML Rename! for Windows: 486/33MHz or greater processor 8MB RAM 5MB of free disk space Windows 95 or Windows/NT 3.51 or greater HTML Rename! for Macintosh: 68020, 68030, or PowerPC 8MB RAM 5MB of free disk space MacOS System 7 or greater (7.5 or greater recommended) INSTALLATION ------------ No special installation is required. Simply extract the files from the archive and HTML Rename! will be ready for use. HTML Rename! is distributed either as a self-extracting archive ("renawNNN.exe" for Windows, "renamNNN.sea" for Macintosh) or as a Windows zipped file ("renawNNN.zip") or Macintosh Stuffit file ("renamNNN.sit"), where "NNN" represents the version number. If you have a self-extracting archive, simply double click on it to extract the files. Otherwise launch your favorite application to unzip or unstuff the archive. See below for the list of files in the archive. PRICING OF HTML RENAME! ----------------------- HTML Rename! is shareware. As such, it is available for a free 60 day evaluation period, after that the software will disable itself. If you find HTML Rename! useful you must register and pay a registration fee as follows: HTML Rename! for Windows 95/NT: US$20 per user HTML Rename! for Macintosh: US$20 per user When your registration payment is received you will be sent a registration key and be granted a license to have unlimited use of a single copy of HTML Rename!. A Site License costs US$500 (equal to 25 users) and covers all locations for your organization within a 160 kilometer radius of your site (100 miles). One big advantage of a Site License is that you do not need to keep track of how many people at your site are using the software. A World-Wide License costs US$2000 and it covers all locations for your organization on the planet earth. Site and World-Wide Licenses for HTML Rename! for Windows or HTML Rename! for Macintosh must be purchased separately. HOW DO I REGISTER HTML RENAME! ------------------------------ Registering HTML Rename! is fairly simple. Click the "Register..." button in the initial Shareware Notice dialog. Then either click on "Register online with a credit card..." to launch your browser and take you to HTML Rename!'s online registration site, or click on "Register via email, fax, or postal mail..." to launch the Register program. Kagi handles payment processing for HTML Rename!, you will make your payments out to them. See more information about Kagi below. NOTE: It is important that you provide YOUR EMAIL ADDRESS during registration. Parker & Associates uses your email address to generate the registration key which grants you unlimited use of a single copy of HTML Rename!. If you are ordering multiple copies or a Site or World- wide License, Parker & Associates will contact you with information on how to complete your registration. REGISTERING ONLINE ------------------ Currently, only credit and debit card transactions and payment via First Virtual can be handled online. Click on "Register online with a credit card..." from HTML Rename!'s registration dialog or point your browser at "http://order.kagi.com/?NK&S" for a secure server or "http://order.kagi.com/?NK" for a normal server. Enter your name, your email address, and the number of single user licenses you desire for each program you wish to purchase (or Site or Word-Wide licenses). Click the "Submit" button to continue to the next page and enter your credit card information for submission to Kagi. REGISTERING WITH THE REGISTER PROGRAM ------------------------------------- Registration via the Register program allows payment by credit card, check, cash, and some forms of digital payment and may be submitted via email, fax, or "snail mail." Enter your name, your email address, and the number of single user licenses you desire for each program you wish to purchase (or Site or Word-Wide licenses). Save or Copy or Print the data from the Register program and send the data and payment to Kagi. If paying with Credit Card or First Virtual, you can email or fax the data to Kagi. Their email address is sales@kagi.com and their fax number is +1 510 652-6589. You can either Copy the data from Register and paste into the body of an email message or you can Save the data to a file and you can attach that file to an email message. There is no need to compress the data file, it's already pretty small. If you have a fax modem, just Print the data to the Kagi fax number. Payments sent via email are processed within 3 to 4 days. You will receive an email acknowledgment when it is processed. Payments sent via fax take up to 10 days and if you provide a correct Internet email address you will receive an email acknowledgment. If you are paying with Cash or USD Check you should print the data using the Register application and send it to the address shown on the form, which is: Kagi 1442-A Walnut Street #392-NK Berkeley, California 94709-1405 USA You can pay with a wide variety of cash from different countries but at present if you pay via check, it must be a check drawn in US Dollars. Kagi cannot accept checks in other currencies, the conversion rate for non-USD checks is around USD 15 per check and that is just not practical. If you have a purchasing department, you can enter all the data into the Register program and then select Invoice as your payment method. Print three copies of the form and send it to your accounts payable people. You might want to highlight the line that mentions that they must include a copy of the form with their payment. Kagi can not invoice your company, you need to act on our behalf and generate the invoice and handle all the paperwork on your end. Please do not fax or email payment forms that indicate Cash, Check or Invoice as the payment method. As far as we know, there is still no technology to transfer physical objects via fax or email and without the payment, the form cannot be processed. Payments send via postal mail take time to reach Kagi and then up to 10 days for processing. Again, if you include a correct email address, you will hear from Kagi when the form is processed. WHAT IS THE CURRENT VERSION OF HTML RENAME! ------------------------------------------- Check "http://www.visiontec.com/rename" to download the latest version. If you are a registered user of HTML Rename!, you will receive email notifying you of new releases. Here is the current revision history: HTML Rename! for Windows: v1.00 27-Nov-96 Initial release v1.10 10-Mar-97 Support for new tags, external text editor v1.20 08-May-97 Relative or absolute URLs, ISO-8859-1 charset v1.21 14-May-97 Fix relative URL substitution bug, base tags HTML Rename! for Macintosh: v1.00 27-Nov-96 Initial release v1.10 10-Mar-97 Support for new tags, external text editor v1.20 08-May-97 Relative or absolute URLs, ISO-8859-1 charset v1.21 14-May-97 Fix relative URL substitution bug, base tags See the "History.txt" file for specific changes in each release. FILES IN THIS DISTRIBUTION -------------------------- HTML Rename! for Windows 95/NT: Readme-Rename.txt -- This file Rename!.exe -- HTML Rename! for Windows executable program Register.exe -- Shareware registration program for HTML Rename! Register.hlp -- Windows Help file for Register.exe License.txt -- Software license agreement for this software LocalReg.html -- Points to online registration page File_id.diz -- Quick identifier with product and version info History.txt -- Version history for what is new in each version HTML Rename! for Macintosh: Readme-Rename.txt -- This file HTML Rename! -- HTML Rename! for Macintosh application Register -- Shareware registration app for HTML Rename! License.txt -- Software license agreement for this software LocalReg.html -- Points to online registration page History.txt -- Version history for what is new in each version WHO DEVELOPED HTML RENAME! -------------------------- HTML Rename! was developed by Parker & Associates, P.O. Box 2707, San Anselmo, CA 94979 (tparker@kagi.com). Terence M. Parker (Terry) founded Parker & Associates in 1994 after 10 years of experience in Berkeley software companies. Terry's roles in software startups have included Vice President of Engineering at Vividata, Inc. and principal designer of Caere's OmniPage optical character recognition product for UNIX/Motif. His work has included all aspects of software development and support, from initial design through end-user support. This experience is all brought to bear on HTML Rename!. HTML Rename! was born when Ken Milburn, one of the authors of "Converting Content for Web Publishing" called Terry, saying that he had not been able to find a much-needed utility to rename files. Terry, who has developed products for DOS, Windows, Macintosh, UNIX, etc., saw the usefulness of such a utility and got a little carried away. The result (together with insights from the authors of Converting Content for Web Publishing) is HTML Rename! -- a sophisticated, professional program carefully designed and tested, and ready for serious work. To find out more about Terry and the authors of "Converting Content for Web Publishing", check out the Web site "http://www.visiontec.com". Last updated: 14-May-97 ###