Tutorial 4: Difference between revisions

From DAAP
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
=Tutorial 4=
=Tutorial 4=
==Create other items needed to describe a work==
To add all the information about your item you may have to create another item first. For example, if you want to make a statement about who is the creator or artist of the work, if the item for the artist doesn't already exist in the archive you must first add it.


We’ll show you how to do this by walking you through the steps of adding an author to your Item page.
==Edit Item page==
===Step 1===
https://daap.bannerrepeater.org/w/images/9/95/Tutorial3_img1.png
Click on “+ add statement”.  
===Step 2===
Start typing "creators / contributors" in the box with the text "Properties."
The box will auto-suggest the property "creators / contributors". Click on the right suggestion to complete it automatically.


https://daap.bannerrepeater.org/w/images/a/af/Tutorial4_img1.png
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 3===
'''Add statement:'''
Before we add any new items we always want to make sure it doesn’t already exist in the database.  
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.  


To do this, start typing the name of the creator in the value bar on the right.
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.  


https://daap.bannerrepeater.org/w/images/9/93/Tutorial4_img2.png
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.


If you see a suggestion corresponding to the name of the person you're looking for click on it and save the statement. No further action needed, unless you want to add a qualifier to describe the role of the person in relation to the work. If so, jump to Step 6 in this tutorial.
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].  


https://daap.bannerrepeater.org/w/images/b/b2/Tutorial4_img3.png
https://daap.bannerrepeater.org/w/images/6/6d/Tutorial3_img2.png


However, if you have finished typing the name of the creator, no suggestion appears and you see the message "No match was found" you need to create a new item for the creator's page. In this case you don't need to search for the item because we already know it doesn't exist.
===Step 1===
===Step 4===
Now, to add statements to your Item page go to the page you have already created.  
To do this go to the '''Create a new Item''' page. You can access it via the homepage, the sidebar, or directly via this link.  


We recommend working with this in a separate browser tab, so right click on the link and select “Open in new tab”.
Click on “+ add statement”.  


For a reminder of how to create a new item, follow the [https://daap.network/tutorial_2 Create a new Item tutorial].
https://daap.bannerrepeater.org/w/images/b/b4/Tutorial3_img3.png
===Step 5===
https://daap.bannerrepeater.org/w/images/2/2d/Tutorial4_img4.png


When you have created a separate item for the creator, try again to enter the name into the value bar on your first item page. The creator’s name should now appear through auto-suggestion when you type. Select and save.
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.  
===Step 6===
To add or change information added in a statement click on the text “edit” in the right side of the statement box.


https://daap.bannerrepeater.org/wiki/File:Tutorial4_img5.png
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. 
===Step 2===
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".


Click on "+add qualifier" to assign additional information about the role the person has in relation to the item.
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.


https://daap.bannerrepeater.org/w/images/b/b6/Tutorial4_img6.png
https://daap.bannerrepeater.org/w/images/e/e0/Tutorial3_img4.png


In the box that appears with the text "Property" start typing “role” and select the auto-suggested option “role”.  
===Step 3===
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".  


https://daap.bannerrepeater.org/w/images/4/4a/Tutorial4_img7.png
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.


In the next box that appears to the right add the role of the person, for example writer.  
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.


You can find the roles available in the Data model under the Item index tab at [https://docs.google.com/spreadsheets/d/1PtX5g-T6T8d7GSq7uYNNhPPrbHU91U-GV4aF2W18occ/edit?usp=sharing this link].
https://daap.bannerrepeater.org/w/images/4/4e/Tutorial3_img5.png
https://daap.bannerrepeater.org/w/images/3/36/Tutorial4_img8.png


You can add multiple qualifiers to the same person if they, for instance, had many roles in relation to the Item.
===Step 4===
 
Press '''save'''. You have now made your first statement.
If a role is missing from the options available in the [https://docs.google.com/spreadsheets/d/1PtX5g-T6T8d7GSq7uYNNhPPrbHU91U-GV4aF2W18occ/edit?usp=sharing Data model] under the Item index tab, you can add it as a new item. To do this, follow the [https://daap.network/tutorial_2 Create a new Item tutorial].
 
https://daap.bannerrepeater.org/w/images/5/5c/Tutorial4_img9.png
 
When you have added your qualifiers press “save”.
===Step 7===
https://daap.bannerrepeater.org/w/images/9/96/Tutorial4_img10.png
 
You can back up your statement by adding a reference, if you wish. To do this click on "+ add qualifier".
 
Choose the property "source" and paste in the URL link to the source you are referring to.
Press “save”.
 
(For search-related reasons we are not using the + add reference function. Please use +add qualifier instead.)
===Step 8===
You have now created and linked the artist page to your item.


https://daap.bannerrepeater.org/w/images/5/54/Tutorial4_img11.png
Now that you know how to add a statement to your Item, we'll go through how to add other kinds of statements.


If there are multiple creators you can add them in the same statement. To do so click on "+ add value" in the statement box “creators / contributors” and repeat the process from Step 2 in this tutorial – trying to type the name of the person you want to add, and choosing their role.
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.  
===Step 9===
You can see where an artist page has been linked to via the “What links here” option in the sidebar.


https://daap.bannerrepeater.org/w/images/c/c5/Tutorial4_img12.png
https://daap.bannerrepeater.org/w/images/d/d0/Tutorial3_img6.png


This is a fast and efficient way to discover cross-references and saves the work of adding reverse statements (i.e. “creator of” as a reverse of “creators/contributors”). Once an item, such as the item for creator or publisher, is linked to in the artwork page with a property such as “creators/ contributors” or “publisher”, that statement will automatically create a reverse link, too, accessible via the “What links here” option on each page for a creator or publisher, etc.
This is a process that you can repeat for adding an item for the publisher, the format, a specific binding method, etc. as needed.


https://daap.bannerrepeater.org/w/images/0/02/Tutorial4_img13.png
To do so please follow the tutorial [https://daap.network/tutorial_4 Create other items needed to describe a work].

Revision as of 22:23, 30 July 2021

Tutorial 4

Edit Item page

Tutorial3_img1.png

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”.

Add statement: 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 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.

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.

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 home page of the database backend or by using this link.

Tutorial3_img2.png

Step 1

Now, to add statements to your Item page go to the page you have already created.

Click on “+ add statement”.

Tutorial3_img3.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.

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.

Step 2

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.

Tutorial3_img4.png

Step 3

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".

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.

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.

Tutorial3_img5.png

Step 4

Press save. You have now made your first statement.

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.

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 Create other items needed to describe a work.

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