Tutorial 3: Difference between revisions

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


==Edit Item page==
==Creating a new Item==
https://daap.bannerrepeater.org/w/images/9/95/Tutorial3_img1.png
=== ===
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.


This is what a new item looks like after it has been created and added to the archive. You can always edit or add to the information that was entered when creating the item, such as the description, alias and even the label. To do this you simply click on the “edit” button at the top right side corner of the page. When you are happy with the changes you’ve made, press “save”.
===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 [https://daap.bannerrepeater.org/wiki/Main_Page Main Page] to search the DAAP.


'''Add statement:'''
https://daap.bannerrepeater.org/w/images/e/ee/Tutorial2_img1.png
To start adding information to describe different aspects of the item you will add “statements”. This will be familiar to you if you have used [https://www.wikidata.org/wiki/Wikidata:Main_Page Wikidata] before.  


Before we add anything let us just explain what we mean by statements. Each statement consists of a property and a value, and is used to add descriptive information, in other words metadata, about an item. Properties are the links that connect different pieces of information together, such as a work and its title.
You must be logged in to Create a new item. If not, an error message will be shown:


Each statement can have a variety of different properties depending on the item it relates to. Each property can also have a variety of different values such as other items, text, dates, or URLs, depending on the type of the property.
https://daap.bannerrepeater.org/w/images/3/34/Tutorial2_img2.png


The full list of properties, alongside examples and short descriptions of the role of each property, can be found in the section Data model reference on the [https://daap.bannerrepeater.org/wiki/Main_Page home page] of the database backend or by using [https://docs.google.com/spreadsheets/d/1PtX5g-T6T8d7GSq7uYNNhPPrbHU91U-GV4aF2W18occ/edit#gid=123424532 this link].  
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.


https://daap.bannerrepeater.org/w/images/6/6d/Tutorial3_img2.png
===Step 2===
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].


===Step 1===
https://daap.bannerrepeater.org/w/images/c/c3/Tutorial2_img3.png
Now, to add statements to your Item page go to the page you have already created.  


Click on “+ add statement”.  
===Step 3===
Begin by adding some basic details using the form on the Create a new Item page.


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


To add statements please use the existing properties. This is important. We intend to keep the properties to a limited list, to ensure workability. If you think a property is missing please consult with us before adding a new one.  
'''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.


There is no required order for how to add the different statements. Still, to know how to start you can have a look at another item in the database, or this example page that demonstrates a wide range of properties, to see how they are used. 
'''Label:'''
===Step 2===
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.
As we are adding the publication ''Surviving art school: an artist of colour tool kit'' we want to state that this item is a work (and not a person or a place). To do this we're going to add a statement that makes this clear. In order to specify what kind of item we're entering in the database we're going to use the property "instance of".


Start writing "instance of" in the box with the text "Property" and the box will auto-suggest this property for you, click on the suggestion to auto-complete the text.
'''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.


https://daap.bannerrepeater.org/w/images/e/e0/Tutorial3_img4.png
Once your Item is created, you will notice that the Description appears at the top of the Item page (see Step 4).


===Step 3===
'''Aliases, pipe-separated:'''
In the box to the right, we're going to enter the value that describes what kind of item ours is. In this case, as we are adding a publication we’ll set the value to "work".  
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


All items that are things, like publications or artworks will have the value “work” and be an “instance of work”, as opposed to an instance of a person or a place.
Here we have entered the details for the publication ''Surviving art school : an artist of colour tool kit''.


Start writing "work" in the box following the property box we already set to “instance of”. The box will auto-suggest the value “work”. Click on the right suggestion to complete it automatically.
https://daap.bannerrepeater.org/w/images/3/30/Tutorial2_img5.png
 
https://daap.bannerrepeater.org/w/images/4/4e/Tutorial3_img5.png


===Step 4===
===Step 4===
Press '''save'''. You have now made your first statement.
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.
 
Now that you know how to add a statement to your Item, we'll go through how to add other kinds of statements.
 
To add a statement about who the creators/artists/contributors are to your own Item you need to make sure an Item page for the person, or collective, already exists, else you need to create one for them.
 
https://daap.bannerrepeater.org/w/images/d/d0/Tutorial3_img6.png
 
This is a process that you can repeat for adding an item for the publisher, the format, a specific binding method, etc. as needed.


To do so please follow the tutorial [https://daap.network/tutorial_4 Create other items needed to describe a work].
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

Retrieved from "https://daap.bannerrepeater.org/w/index.php?title=Tutorial_3&oldid=15482"