Help:Naming conventions - Revision history

NickHunt: /* Collection pieces */

2026-04-02T06:57:23Z

Collection pieces

NickHunt: /* Naming conventions for files */

2026-04-02T06:56:00Z

Naming conventions for files

NickHunt: /* Persons */

2026-03-23T16:44:58Z

Persons

NickHunt: /* Naming conventions for files */

2026-03-23T12:43:41Z

Naming conventions for files

NickHunt at 12:23, 23 March 2026

2026-03-23T12:23:19Z

EmmaR: Created page with "== Naming conventions documents == All documents are placed in a repositery that so they can be used in multiple places. Therefore we need to give a unique name that makes it..."

2026-03-19T11:54:06Z

Created page with "== Naming conventions documents == All documents are placed in a repositery that so they can be used in multiple places. Therefore we need to give a unique name that makes it..."

New page

== Naming conventions documents ==
All documents are placed in a repositery that so they can be used in multiple places. Therefore we need to give a unique name that makes it possible to find them back.

* name has to be a title without spaces, therefore we use underscores to fill the spaces.
* the name can be given in the upload process, but it is easier to rename them in advance.

=== Images ===
The principle idea is that pictures should have a human recognisable file name that differentiates it from other files.
* '''IMG1234''' is hard to read or understand
* '''John_Doe_portret''' is recognisable

==== Logo's ====
* naming: brand_name_logo
* additional a time span can be added
Example
* ADB_Logo_till_1950s

==== Collection pieces ====
* naming: Collection_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 items.
* naming: Last_name_Fist_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, look up ISO code in the country item
** Use the Enlish name of the city as staed in the item
* 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

@@ Line 2: / Line 2: @@
 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. Therefore we need to give each one a unique name that makes it possible to find it again.
-* the name has to be a title without spaces, therefore we use underscores to fill the spaces.
+=== Basic Principles ===
-* the name can be given during the file upload process, but it is easier to rename them in advance.
-* avoid using special characters with accents in the file names, as they can cause issues.
+* File names in the repository cannot have spaces in them. The Repository will automatically replace any spaces with underscores.
 === Images ===

@@ Line 28: / Line 28: @@
 ==== Persons ====
 For persons, we follow the naming conventions in the item:
-* naming: Last_name_First_name
+* naming: First name_Last name
 * when there are multiple pictures, a reference to the exact content or a number can be added

@@ Line 4: / Line 4: @@
 * the name has to be a title without spaces, therefore we use underscores to fill the spaces.
 * the name can be given during the file upload process, but it is easier to rename them in advance.
 === Images ===

@@ Line 19: / Line 19: @@
   * ADB_Logo_till_1950s
-==== Collection pieces ====
+==== Items from collections ====
 * naming: Collection_collection_number
 * when there are multiple pictures, a reference to the exact content can be added

@@ Line 1: / Line 1: @@
-== Naming conventions documents ==
+== Naming conventions for files ==
-All documents are placed in a repositery that so they can be used in multiple places. Therefore we need to give a unique name that makes it possible to find them back.
+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. Therefore we need to give each one a unique name that makes it possible to find it again.
-* name has to be a title without spaces, therefore we use underscores to fill the spaces.
+* the name has to be a title without spaces, therefore we use underscores to fill the spaces.
-* the name can be given in the upload process, but it is easier to rename them in advance.
+* the name can be given during the file upload process, but it is easier to rename them in advance.
 === Images ===
-The principle idea is that pictures should have a human recognisable file name that differentiates it from other files.
+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_portret''' is recognisable
+  * '''John_Doe_portrait''' is recognisable
-==== Logo's ====
+==== Logos ====
 * naming: brand_name_logo
-* additional a time span can be added
+* a time span can be also added
   Example
   * ADB_Logo_till_1950s
@@ Line 26: / Line 26: @@
 ==== Persons ====
-For persons, we follow the naming conventions in the items.
+For persons, we follow the naming conventions in the item:
-* naming: Last_name_Fist_name
+* naming: Last_name_First_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
+  * Jane_Doe_early_1960s
   * Louis_Inconue_1
 ==== Buildings ====
-For pictures of buildings we follow the conventions of the item
+For pictures of buildings we follow the conventions of the item:
 * naming: Country code_city_building
-** to find the country code, look up ISO code in the country item
+** to find the country code, search for the country in Canonbase, and find its ISO code
-** Use the Enlish name of the city as staed in the item
+** 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