WebHare is transitioning away from the RTD extension. We no longer set this extension on new RTD files and remove it during publication.

Unfortunately the automatic extension removal is still triggering some subtle bugs - if a folder contains both a file development.rtd and a folder development they will attempt to claim the same URL. To finalize the migration away from the RTD extension we need existing files to be renamed.

Fortunately, we have a migration tool for that - publisher:whfstool.

# Trial conversion of a single folder - will report name conflicts:
wh publisher:whfstool --striprtdextension --recursive --dryrun "site::mysite/myfolder"

# Remove the RTD extension for a site:
wh publisher:whfstool --striprtdextension --recursive "site::mysite"

# Convert your entire installation:
wh publisher:whfstool --striprtdextension --recursive "/"

(The last command requires WebHare 5.2 or higher as earlier versions of whfstool didn't support '/' as a starting point)

If your templates or apply rules hardcoded some filenames this conversion may break things. The following command may help you find potential issues by looking for strings ending with a .rtd extension:

 wh dev:codegrep "\.rtd[\"\']"

We intend to remove the automatic extension removal in a future version of WebHare to get rid of aformentioned bugs so existing sites will either have to strip RTD extensions at some point in the future, or accept the .rtd parts appearing in URLs again.