Naming Files

Consider the following when naming files: Longevity, Readability and Irish Language and Internationalisation

The following should help you produce a good readable URL

  1. Make the filename all lowercase
  2. Remove spaces
    If removing all spaces makes the filename ambiguous, replace spaces with hyphens
  3. Use a limited set of characters, for example only a to z, 0 to 9 and hyphens ("é" replace with "e", "&" replace with "and" etc.)
  4. Remove non-essential words like "and", "or", "the", "with" etc. so you are left with keywords
  5. Where possible limit technology indicators (.php), see the section below for complete instructions
  6. Remove repeated words, with respect to the final URL

For example the following steps illustrate how to go:

From
tcd.ie/area/research/Our Research News & Events.php

To
tcd.ie/area/research/newsevents/

  1. our research news & events.php (filename made lowercase)
  2. ourresearchnews&events.php (spaces removed)
  3. ourresearchnewsandevents.php (limit the set of characters being used)
  4. researchnewsevents.php (remove non-essential words)
  5. researchnewsevents/index.php (limit technology indicators)
  6. newsevents/index.php (remove repeated words, "research" was already in the final URL therefore better removed in this instance)
  7. The final URL becomes tcd.ie/area/research/newsevents/

Please see the ISS website for further details on Naming Files & Folders and Using Appropriate URLs.

 

Longevity is primarily about whether the document represents the latest information, or an archive.
The practical difference is whether to include date information in the filename or not.

Let's say you have a PDF brochure relevant for the academic year 2014-2015 ready to upload.
Do you name it "brochure.pdf" or "brochure-2014-2015.pdf" or both?

Latest Information

Name it "brochure.pdf" when no online archive of the brochure is wanted.
Each following year overwrite "brochure.pdf" with the latest version.
Website links to this document can remain the same year-on-year and people can bookmark this document without updating the bookmark in future.

Archive

Name it "brochure-2014-2015.pdf" when an online archive is wanted, which means you want to provide access to historical versions of the brochure.
Each following year upload another document with the date in the filename e.g. "brochure-2015-2016.pdf", "brochure-2016-2017.pdf" etc.

Both

Provide two documents "brochure-2014-2015.pdf" and "brochure.pdf" when an online archive and latest information of the brochure is wanted.
Make sure to limit linking to "brochure-2015-2016.pdf" to only when referring to the archive version, for example from an archive listings page.
For all other links use "brochure.pdf" as it represents the latest information.

If the brochure is a web page the following would be equivalent to those given above:
"brochure/index.php"
"brochure/2014-2015.php"

An Irish language page will typically be an equivalent of an existing page. If this is the case they are named as follows to best integrate with a language switcher on the website:

  • If the existing page is /contact/index.php, name the Irish language page /contact/index.ga.php
  • If the existing page is /contact.php, name the Irish language page /contact.ga.php.