Help:Naming conventions

Naming conventions for files

All files such as images or digital documents are placed in the Canon repository that so they can be used in multiple places in the database and elsewhere. We therefore need to give each one a unique name so it is possible to find it again.

Basic Principles

File names in the repository cannot have spaces in them. The Repository will automatically replace any spaces with underscores.
You can change the file name during the uploading process, but it is easier to rename files in advance.
Avoid using special characters with accents in the file names, as they can cause issues.

Images

The principal idea is that image files should have a human recognisable file name that differentiates it from other files.

* IMG1234 is hard to read or understand
* John_Doe_portrait is recognisable

Logos

naming: brand_name_logo
a time span can be also added

Example
* ADB_Logo_till_1950s

Items from collections

naming: Collection_name_collection_number
when there are multiple pictures, a reference to the exact content can be added
- _top, _back, _front, _detail, _logo, _type_plate, …

Example
* TEAD_0123_front
* KSB_0386

Persons

For persons, we follow the naming conventions in the item:

naming: First name_Last name
when there are multiple pictures, a reference to the exact content or a number can be added

Example
* John_Doe
* Jane_Doe_early_1960s
* Louis_Inconue_1

Buildings

For pictures of buildings we follow the conventions of the item:

naming: Country code_city_building
- to find the country code, search for the country in Canonbase, and find its ISO code
- Use the English name of the city as stated in the item's Canonbase entry
when there are multiple pictures, a reference to the exact content or a number can be added

Example
* BE_Antwerp_Bourla_theatre
* BE_Antwerp_Bourla_theatre_House

Documents

Magazines

naming: magazine_name_issue_number
- If the magazine has a long name, you can use an abbrevation.
- If the issue number starts from 1 each year, add the year or series number.
- It is important to have the spelling for the same magazines identical.

Example
* Proscenium_19
* Tijdschrift_Theatertechniek_5_jrg_nr_4_1972 
* BTR_Band_2017_Heft_03

Books

naming: title_of_the_book

Articles

naming: title_of_the_article

Manuals

naming: brand_type_number_manual

Example
* Clear_Com_MS-400A_Manual
* CalyPaky_GoldenScanHPE_manual

Specification sheets

naming: brand_type_number_specsheet

Example
* Vari_Lite_VL2C_spot_luminaire_specsheet
* ADB_series_A_specsheet

Patents

naming: patents_country_patent_number

Example
* GB_191500127_A
* DE_386071_C

Plans

Theatre plans

naming: Country code_city_building_addition
- Addition can be: ground plan, section, ...
- If needed: add floor or other place (for example: first floor, backstage, ...)

Example:
* SE_Landskrona_teatrn_plan

Equipment plans

naming: equipment_brand_type_addition

Example:
*

Search