Tutorial 4: Difference between revisions

From DAAP
Jump to navigation Jump to search
No edit summary
 
(13 intermediate revisions by the same user not shown)
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.
==Editing Item pages==
===Step 1===
===Things you need to know about Item Pages===
Click on “+ add statement”.
This is what a new Item looks like after it has been created and added to the archive. It is automatically assigned a unique ID number from the database, this number always starts with the letter Q, in this example the unique ID for the publication “Surviving Art School” is Q1272. Once created an ID cannot be changed, but everything else about an Item is editable.
===Step 2===
 
Start typing "creators / contributors" in the box with the text "Properties."
https://daap.bannerrepeater.org/w/images/9/95/Tutorial3_img1.png
The box will auto-suggest the property "creators / contributors". Click on the right suggestion to complete it automatically.
 
'''Edit page information:''' You may edit, or add to the basic information entered in the '''[https://daap.network/tutorial_3 Creating a new Item tutorial]'''; including Label, Description, and Aliases (alternative names the Item is known as), at any time.  
 
To make a change, simply click on the “edit” button at the upper right corner of the page. When you are satisfied with the changes you’ve made, remember to click “save”.
 
'''Add statements:'''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.
Each Statement includes two main parts: a Property and a single (or multiple) Values.
 
The Properties and Values attached to the Item for a published work will typically include its creator(s) and its publisher, as well as its format, binding, material, and physical dimensions. You can also add many further details, such as edition size, ISBN, whether it is available as a digital facsimile, and which collections hold a copy.
 
Properties are a set of links that connect an Item with different aspects of information about it. The Values corresponding to each Property represent unique information about individual Items in the DAAP. See the table with some examples below:


https://daap.bannerrepeater.org/w/images/a/af/Tutorial4_img1.png
{| class="wikitable"
|-
! Item
! Property
! Value(s)
|-
| Q1272
| instance of
| work
|-
| Q1272
| title
| Surviving Art School: An Artist of Colour Toolkit
|-
| Q1272
| creators / contributors
| Evan Ifekoya, Raisa Kabir, Raju Rage, Rudy Loewe, Said Adrus, Claudette Johnson, Keith Piper
|}


===Step 3===
<p></p>
Before we add any new items we always want to make sure it doesn’t already exist in the database.
<p></p>


To do this, start typing the name of the creator in the value bar on the right.
Our team has created a [https://docs.google.com/spreadsheets/d/1PtX5g-T6T8d7GSq7uYNNhPPrbHU91U-GV4aF2W18occ/edit#gid=0 Data Model], which lists the Properties currently available in the DAAP, alongside examples of possible Values, to support you as you build your Statements. You may find it useful to refer back to the data model whenever you are working in the database. You can also navigate to the Data Model via the [https://daap.bannerrepeater.org/wiki/Main_Page Main page], under the heading ‘Data model reference’.


https://daap.bannerrepeater.org/w/images/9/93/Tutorial4_img2.png


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


https://daap.bannerrepeater.org/w/images/b/b2/Tutorial4_img3.png
You may only use existing Properties (listed in the Data Model). This is important because we want the database to remain focused and workable. If you feel a Property is missing, please email us (daap [dot] community [at] disroot [dot] org) to discuss your ideas before adding a new one.
You do not need to make use of all the Properties listed here. Choose only those Properties which are relevant to the Item you are creating.
You are not required to add Statements in any specific order. However, the Data Model introduces one approach, of considering Statements in 5 sets relating to:


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.
1. '''how the work is referred to in the world,''' e.g., its title, subtitle, language, and series number;
===Step 4===
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”.
2. '''the publication event,''' e.g., creators/contributors, publisher, imprint, place and date of publication;


For a reminder of how to create a new item, follow the [https://daap.network/tutorial_2 Create a new Item tutorial].
3. '''the material characteristics of the work,''' e.g., its medium, format, binding, height, width, thickness, and the material processes it comprises;
===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.
4. '''information about a work’s distribution,''' e.g., its digital facsimiles, distributor links, library links and ISBN;
===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
5. and finally, '''anecdotal histories''' including description, distribution and exhibition history.


Click on "+add qualifier" to assign additional information about the role the person has in relation to the item.
You may also find it useful to consider this Example Item page which uses blank Values to demonstrate all Properties which can be used to describe different publication Items.


https://daap.bannerrepeater.org/w/images/b/b6/Tutorial4_img6.png
===Step 1===
To begin adding Statements about your Item, click on “+ add statement”.


In the box that appears with the text "Property" start typing “role” and select the auto-suggested option “role”.  
https://daap.bannerrepeater.org/w/images/b/b4/Tutorial3_img3.png


https://daap.bannerrepeater.org/w/images/4/4a/Tutorial4_img7.png
===Step 2===
Before adding anything else, you must include a Statement to define the Item in terms of ''what it is an instance of'' in the database. Unlike most other statements, this one is mandatory rather than  optional.
Are you describing a published work?


In the next box that appears to the right add the role of the person, for example writer.
A person (or group of people) who have created/contributed to a work?


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].
Or an organisation who published a work?
   
   
https://daap.bannerrepeater.org/w/images/3/36/Tutorial4_img8.png
To specify this, you will need to use the Property <instance of>. This is the part of a Statement which enables you to record whether the Item you are describing is an “instance of” ''a published work'', or an “instance of” ''a creator/contributor'', or an “instance of” ''an organisation''.
Start typing "instance of" into the box labelled "Property", it will appear as an auto-suggested option. Click on the suggestion to select it and auto-complete the text.


You can add multiple qualifiers to the same person if they, for instance, had many roles in relation to the Item.  
https://daap.bannerrepeater.org/w/images/e/e0/Tutorial3_img4.png


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].
===Step 3===
Next, you will define the corresponding Value in the box to the right.


https://daap.bannerrepeater.org/w/images/5/5c/Tutorial4_img9.png
'''Remember:''' A Property links an Item with an aspect of information about it, and a Value is the information we want to capture.


When you have added your qualifiers press “save”.
In this example, the Item being added to the database is an instance of a published work.
===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".
So, here, we’ll record the Value "work".


Choose the property "source" and paste in the URL link to the source you are referring to.
Again, when you begin typing the word "work" in the Value field, you will find it available as an auto-suggested entry. Click on the suggestion to select it and auto-complete the text.
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
https://daap.bannerrepeater.org/w/images/4/4e/Tutorial3_img5.png


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.
''Tip: Auto-suggest functions as a search tool to find if something exists in the database. If no suggestions pop up as you start typing something, make sure you don’t have any typos first, and only then consider making a new Item if required.''
===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
===Step 4===
Click '''save'''. You have successfully made your first Statement in the DAAP.
The following Tutorials will guide you through making some further Statements.
Creating Statements about who created/contributed, published, or commissioned a work might involve referring to multiple other Items.  


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.
https://daap.bannerrepeater.org/w/images/d/d0/Tutorial3_img6.png


https://daap.bannerrepeater.org/w/images/0/02/Tutorial4_img13.png
What is critical to remember is that '''each and every Item you refer to must exist within the database''' for the Statement to be made. You may find it useful to return to [https://daap.network/tutorial_3 Tutorial 3] to refresh your knowledge of how to Create a new Item. Or continue to [https://daap.network/tutorial_5 Tutorial 5] to learn how to link other Items needed to describe a published work in.

Latest revision as of 14:04, 3 August 2021

Tutorial 4

Editing Item pages

Things you need to know about Item Pages

This is what a new Item looks like after it has been created and added to the archive. It is automatically assigned a unique ID number from the database, this number always starts with the letter Q, in this example the unique ID for the publication “Surviving Art School” is Q1272. Once created an ID cannot be changed, but everything else about an Item is editable.

Tutorial3_img1.png

Edit page information: You may edit, or add to the basic information entered in the Creating a new Item tutorial; including Label, Description, and Aliases (alternative names the Item is known as), at any time.

To make a change, simply click on the “edit” button at the upper right corner of the page. When you are satisfied with the changes you’ve made, remember to click “save”.

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

Each Statement includes two main parts: a Property and a single (or multiple) Values.

The Properties and Values attached to the Item for a published work will typically include its creator(s) and its publisher, as well as its format, binding, material, and physical dimensions. You can also add many further details, such as edition size, ISBN, whether it is available as a digital facsimile, and which collections hold a copy.

Properties are a set of links that connect an Item with different aspects of information about it. The Values corresponding to each Property represent unique information about individual Items in the DAAP. See the table with some examples below:

Item Property Value(s)
Q1272 instance of work
Q1272 title Surviving Art School: An Artist of Colour Toolkit
Q1272 creators / contributors Evan Ifekoya, Raisa Kabir, Raju Rage, Rudy Loewe, Said Adrus, Claudette Johnson, Keith Piper

Our team has created a Data Model, which lists the Properties currently available in the DAAP, alongside examples of possible Values, to support you as you build your Statements. You may find it useful to refer back to the data model whenever you are working in the database. You can also navigate to the Data Model via the Main page, under the heading ‘Data model reference’.


Tutorial3_img2.png

You may only use existing Properties (listed in the Data Model). This is important because we want the database to remain focused and workable. If you feel a Property is missing, please email us (daap [dot] community [at] disroot [dot] org) to discuss your ideas before adding a new one. You do not need to make use of all the Properties listed here. Choose only those Properties which are relevant to the Item you are creating. You are not required to add Statements in any specific order. However, the Data Model introduces one approach, of considering Statements in 5 sets relating to:

1. how the work is referred to in the world, e.g., its title, subtitle, language, and series number;

2. the publication event, e.g., creators/contributors, publisher, imprint, place and date of publication;

3. the material characteristics of the work, e.g., its medium, format, binding, height, width, thickness, and the material processes it comprises;

4. information about a work’s distribution, e.g., its digital facsimiles, distributor links, library links and ISBN;

5. and finally, anecdotal histories including description, distribution and exhibition history.

You may also find it useful to consider this Example Item page which uses blank Values to demonstrate all Properties which can be used to describe different publication Items.

Step 1

To begin adding Statements about your Item, click on “+ add statement”.

Tutorial3_img3.png

Step 2

Before adding anything else, you must include a Statement to define the Item in terms of what it is an instance of in the database. Unlike most other statements, this one is mandatory rather than optional.

Are you describing a published work?

A person (or group of people) who have created/contributed to a work?

Or an organisation who published a work?

To specify this, you will need to use the Property <instance of>. This is the part of a Statement which enables you to record whether the Item you are describing is an “instance of” a published work, or an “instance of” a creator/contributor, or an “instance of” an organisation.

Start typing "instance of" into the box labelled "Property", it will appear as an auto-suggested option. Click on the suggestion to select it and auto-complete the text.

Tutorial3_img4.png

Step 3

Next, you will define the corresponding Value in the box to the right.

Remember: A Property links an Item with an aspect of information about it, and a Value is the information we want to capture.

In this example, the Item being added to the database is an instance of a published work.

So, here, we’ll record the Value "work".

Again, when you begin typing the word "work" in the Value field, you will find it available as an auto-suggested entry. Click on the suggestion to select it and auto-complete the text.


Tutorial3_img5.png

Tip: Auto-suggest functions as a search tool to find if something exists in the database. If no suggestions pop up as you start typing something, make sure you don’t have any typos first, and only then consider making a new Item if required.

Step 4

Click save. You have successfully made your first Statement in the DAAP.

The following Tutorials will guide you through making some further Statements. Creating Statements about who created/contributed, published, or commissioned a work might involve referring to multiple other Items.

Tutorial3_img6.png

What is critical to remember is that each and every Item you refer to must exist within the database for the Statement to be made. You may find it useful to return to Tutorial 3 to refresh your knowledge of how to Create a new Item. Or continue to Tutorial 5 to learn how to link other Items needed to describe a published work in.