Tutorial 3: Difference between revisions

From DAAP
Jump to navigation Jump to search
No edit summary
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
=Tutorial 3=
=Tutorial 3=


==Create a new Item==
==Creating a new Item==
=== ===
=== ===
You can use the '''Create a new Item''' form to add a new '''Item''' to the database. In the DAAP, Item is used to represent any published work, any person (or group of people), any institution, or any place in the world.
You can use the '''Create a new Item''' form to add a new '''Item''' to the database. In the DAAP, Item is used to represent any published work, any person (or group of people), any institution, or any place in the world.
Line 10: Line 10:


===Step 1===
===Step 1===
To add a new item to the database please go to the '''Create a new Item''' page using [https://daap.bannerrepeater.org/wiki/Special:NewItem this link].  
Before attempting to add a new Item to the database, you must make sure that the Item you want to add is not already included.
You can always find this function in the sidebar to the left on your screen, or by using the '''Create new item''' button under the heading Adding new data in the archive on the [https://daap.bannerrepeater.org/wiki/Main_Page Main Page].
You can help us to avoid duplication by searching for any Item you wish to add first. Use the search bar in the upper right corner of the [https://daap.bannerrepeater.org/wiki/Main_Page Main Page] to search the DAAP.


https://daap.bannerrepeater.org/w/images/e/ee/Tutorial2_img1.png
https://daap.bannerrepeater.org/w/images/e/ee/Tutorial2_img1.png


In order to do so you should log in. If you are not logged in an error message will be shown:
You must be logged in to Create a new item. If not, an error message will be shown:


https://daap.bannerrepeater.org/w/images/3/34/Tutorial2_img2.png
https://daap.bannerrepeater.org/w/images/3/34/Tutorial2_img2.png


You can login using [https://daap.bannerrepeater.org/w/index.php?title=Special:UserLogin&returnto=Main+Page this link] or from the Main Page.  
Login to your account via [https://daap.bannerrepeater.org/w/index.php?title=Special:UserLogin&returnto=Main+Page this link], or find the Log in button in the upper right corner of the Main Page.
 
===Step 2===
===Step 2===
Make sure the item you want to add is not already in the database before you attempt to add it. You can do this by searching for it using the search bar in the top right corner of the Main Page containing the text “Search DAAP”.  
When you are sure that the Item does not yet exist in the database, navigate to the Create new Item page via [https://daap.bannerrepeater.org/wiki/Special:NewItem this link]. Alternatively, find the Create new Item button on the sidebar at the left edge, or under the heading ‘Adding new data in the archive’ on the [https://daap.bannerrepeater.org/wiki/Main_Page Main Page].


https://daap.bannerrepeater.org/w/images/c/c3/Tutorial2_img3.png
https://daap.bannerrepeater.org/w/images/c/c3/Tutorial2_img3.png


===Step 3===
===Step 3===
Then, start adding the details into the form on the Create a new Item page.
Begin by adding some basic details using the form on the Create a new Item page.


https://daap.bannerrepeater.org/w/images/5/5c/Tutorial2_img4.png
https://daap.bannerrepeater.org/w/images/5/5c/Tutorial2_img4.png


'''Language:'''
'''Language:'''
Here you choose the language you will use to describe the item. If the original language of the work is different from English, there will be opportunity at a later stage (i.e. statement editing) to indicate that. For search purposes all item labels and descriptions have to be in English (NB: NOT British English, as that would create discrepancies in the database). Please enter “en” for English in this field, if it’s not your default language already.
Select the language you will be using to describe the item. If the published work is written in a language other than English, there will be opportunity to record this at a later stage. To facilitate effective search, we ask that all item Labels and Descriptions be given in English. Please make sure you select: '''en-English''' rather than '''en-GB''' to avoid discrepancies in the database.


'''Label:'''
'''Label:'''
The Label is like a title – how this "thing" is referred to in the database. If your item is a publication or artwork its title would be the Label. If your item is a person this would be the person’s name, and so on.  
All Items must be accompanied by a suitable Label. The Label will appear as the main heading on your Item page, so you will want to make this as clear as possible. For an Item which is a published work, you can use the work’s title as its Label; for a person (or group of people) use their individual (or collective) name and so on, for an institution, a city or country in the world.


'''Description:'''
'''Description:'''
Your description should be a very short statement (max 250 characters) that distinguishes one thing in the database from another. If two items in the database would have the same label, for instance two artworks both called "untitled", the descriptive text would help the user quickly distinguish between the two.  
Each Item also requires a brief description (maximum 250 characters) to distinguish it from other Items in the database. It is possible that two Items in the database will share the same Label, for instance, there may be several artworks with the title "Untitled". So, the Description helps users of the DAAP to quickly differentiate one Item from another.


Once the item is created, the description will appear at the top of the item page (see Step4).  
Once your Item is created, you will notice that the Description appears at the top of the Item page (see Step 4).


'''Aliases, pipe-separated:'''
'''Aliases, pipe-separated:'''
Aliases are alternative ways of spelling or calling the item. For example, aliases for the city "New York" would be "NYC", or "New York City", etc. There is no limit to the number of aliases that can be added, they just need to be separated by the pipe symbol | .
Aliases are included to account for any variations in spelling, or alternative names which can be used to name an Item. For example, common aliases for the city of "New York" are "NYC” and "New York City".
Please include as many aliases as you require – there isn’t a limit. In fact, more aliases increase searchability of the database. Any alias entered becomes searchable as a keyword – making it easier to find an item even if you're not sure which spelling or abbreviation to search for. Provide aliases in a list with each one separated by the ‘pipe’ symbol |. For example:
NYC | New York City | The Big Apple


Here we have entered the details for the publication ''Surviving art school : an artist of colour tool kit''.
Here we have entered the details for the publication ''Surviving art school : an artist of colour tool kit''.


https://daap.bannerrepeater.org/w/images/3/30/Tutorial2_img5.png
https://daap.bannerrepeater.org/w/images/3/30/Tutorial2_img5.png


===Step 4===
===Step 4===
Press the “Create” button to finalise this step. In the next tutorials we’ll show you how we added this item to the DAAP database and you can follow along the steps with the item you want to add.  
Click the “Create” button to finalise your new Item. In the following Tutorials we’ll guide you through the process of adding more information to an Item page.


https://daap.bannerrepeater.org/w/images/c/c2/Tutorial2_img6.png
https://daap.bannerrepeater.org/w/images/c/c2/Tutorial2_img6.png

Latest revision as of 23:22, 1 August 2021

Tutorial 3

Creating a new Item

You can use the Create a new Item form to add a new Item to the database. In the DAAP, Item is used to represent any published work, any person (or group of people), any institution, or any place in the world.

We also use Item to represent common objects, processes and ideas: "paper", "offset printing", "softcover binding” in the database.

An Item page for a published work may become richly detailed, with lots of information attached to it. While an Item page for a process, such as "softcover binding", may be simple, comprising only a basic definition.

Step 1

Before attempting to add a new Item to the database, you must make sure that the Item you want to add is not already included. You can help us to avoid duplication by searching for any Item you wish to add first. Use the search bar in the upper right corner of the Main Page to search the DAAP.

Tutorial2_img1.png

You must be logged in to Create a new item. If not, an error message will be shown:

Tutorial2_img2.png

Login to your account via this link, or find the Log in button in the upper right corner of the Main Page.

Step 2

When you are sure that the Item does not yet exist in the database, navigate to the Create new Item page via this link. Alternatively, find the Create new Item button on the sidebar at the left edge, or under the heading ‘Adding new data in the archive’ on the Main Page.

Tutorial2_img3.png

Step 3

Begin by adding some basic details using the form on the Create a new Item page.

Tutorial2_img4.png

Language: Select the language you will be using to describe the item. If the published work is written in a language other than English, there will be opportunity to record this at a later stage. To facilitate effective search, we ask that all item Labels and Descriptions be given in English. Please make sure you select: en-English rather than en-GB to avoid discrepancies in the database.

Label: All Items must be accompanied by a suitable Label. The Label will appear as the main heading on your Item page, so you will want to make this as clear as possible. For an Item which is a published work, you can use the work’s title as its Label; for a person (or group of people) use their individual (or collective) name and so on, for an institution, a city or country in the world.

Description: Each Item also requires a brief description (maximum 250 characters) to distinguish it from other Items in the database. It is possible that two Items in the database will share the same Label, for instance, there may be several artworks with the title "Untitled". So, the Description helps users of the DAAP to quickly differentiate one Item from another.

Once your Item is created, you will notice that the Description appears at the top of the Item page (see Step 4).

Aliases, pipe-separated: Aliases are included to account for any variations in spelling, or alternative names which can be used to name an Item. For example, common aliases for the city of "New York" are "NYC” and "New York City".

Please include as many aliases as you require – there isn’t a limit. In fact, more aliases increase searchability of the database. Any alias entered becomes searchable as a keyword – making it easier to find an item even if you're not sure which spelling or abbreviation to search for. Provide aliases in a list with each one separated by the ‘pipe’ symbol “|”. For example:

NYC | New York City | The Big Apple

Here we have entered the details for the publication Surviving art school : an artist of colour tool kit.

Tutorial2_img5.png

Step 4

Click the “Create” button to finalise your new Item. In the following Tutorials we’ll guide you through the process of adding more information to an Item page.

Tutorial2_img6.png