Giving your asset a name
The web can be weird and temperamental. This is especially true with regard to how it handles the names of things living within it. Here’s a guide on naming your Cascade assets so that the web deities stay happy.
...
The name provided in the File (or Page, or Folder, or …) Name field is how it will appear in URLs. You’ll want to replace the pre-filled value with something more meaningful and appropriate.
Info |
---|
Yes, the help text for this field is awkwardly worded. Unfortunately it can’t be changed or customized. Sorry 'bout that. |
A quick cheat sheet
Asset type | Special characters | Spaces | Capital letters |
---|---|---|---|
Pages | Only dashes and underscores | No | No |
Folders | Only dashes and underscores | No | No |
Files | Only dashes and underscores | No | Mostly no, sometimes ok. |
Non-publishable assets | Only dashes and underscores | Ok | Ok |
Pages and folders
Keep names to lowercase basic latin characters, numbers, dashes, and underscores only. Character with diacritics (i.e., accents and such) are risky. Some browsers may handle uncommon characters gracefully, but results are not guaranteed.
If your page or folder name includes spaces, it best to replace those with dashes. Underscores technically work to, but in some scenarios aren’t as readable as dashes (think underlined names).
Files
Generally the rules that apply to pages and folders also apply to files. However, some file types are best served with camel casing – beginning each word in a name, except the first, with a capital letter.
...
The use of camel casing is generally file naming convention used by programmers / developers, so if you don’t normally do it, don’t start…. just stick to the rules for pages and folders.
All non-publishable assets
Anything that exclusively lives in Cascade and is never published to the web, including non-publishable files and folders, can safely have nice human-readable names….
Spaces? Ok!
Capital letters? Sounds great!
Special characters? Woah, let’s not get crazy here. (That’s a no.)
Giving your asset a home
...
Use the folder chooser to select where in Cascade you want your asset to be located.
The location indicated here defaults to whatever Cascade folder you’re currently in. That may not be where you want the asset to be actually located in Cascade, so be sure to check this and change the location as desired.
Note |
---|
Placing an asset such as a page, file, or folder inside a non-publishable folder will make the place asset non-publishable too. |