Tutorial 5 - Revision history

Loz.ross: /* Tutorial 5 */

2021-07-30T23:24:36Z

Tutorial 5

← Older revision		Revision as of 23:24, 30 July 2021
Line 43:		Line 43:
	===Step 5===		===Step 5===
	After you create the new Item, don’t forget to add its type via the Property “instance of”. In this case the type is '''contributor''', but as you create more new Items in the database, you may need to use types such as '''collective''', '''organisation''', etc. It is important not to skip this step especially for all the creators or publishers of a work.		After you create the new Item, don’t forget to add its type via the Property “instance of”. In this case the type is '''contributor''', but as you create more new Items in the database, you may need to use types such as '''collective''', '''organisation''', etc. It is important not to skip this step especially for all the creators or publishers of a work.

			https://daap.bannerrepeater.org/w/images/8/81/Tutorial5_new_img.jpg

	===Step 6===		===Step 6===

Loz.ross: /* Step 5 */

2021-07-30T23:19:18Z

Step 5

← Older revision		Revision as of 23:19, 30 July 2021
Line 42:		Line 42:

	===Step 5===		===Step 5===
	After you create the new Item, don’t forget to add its type via the Property “instance of”. In this case the type is ~~“person”~~, but as you create more new Items in the database, you may need to use types such as ~~“collective”~~, ~~“organisation”~~, etc. It is important not to skip this step especially for all the creators or publishers of a work.		After you create the new Item, don’t forget to add its type via the Property “instance of”. In this case the type is '''contributor''', but as you create more new Items in the database, you may need to use types such as '''collective''', '''organisation''', etc. It is important not to skip this step especially for all the creators or publishers of a work.

	~~<img>~~

	===Step 6===		===Step 6===

Loz.ross: /* Linking other items needed to describe a work */

2021-07-30T23:14:22Z

Linking other items needed to describe a work

← Older revision		Revision as of 23:14, 30 July 2021
Line 42:		Line 42:

	===Step 5===		===Step 5===
			After you create the new Item, don’t forget to add its type via the Property “instance of”. In this case the type is “person”, but as you create more new Items in the database, you may need to use types such as “collective”, “organisation”, etc. It is important not to skip this step especially for all the creators or publishers of a work.

			<img>

			===Step 6===

	https://daap.bannerrepeater.org/w/images/2/2d/Tutorial4_img4.png		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.		When you have created a separate Item for the creator, return to your Item (the published work) page and try again to begin typing the creator’s name into the Value field. The creator’s name should now appear as an auto-suggestion when you type. Select it and save the Statement.
	===Step 6===
	To add or ~~change~~ information ~~added in~~ a ~~statement~~ click on the ~~text~~ “edit” in the right ~~side~~ of the ~~statement~~ box.		===Step 7===
			To add or edit information within a Statement, click on the “edit” button at the upper right corner of the shaded box.

	https://daap.bannerrepeater.org/wiki/File:Tutorial4_img5.png		https://daap.bannerrepeater.org/wiki/File:Tutorial4_img5.png

	Click on "+add qualifier" to ~~assign~~ additional ~~information~~ about the role the person ~~has~~ in ~~relation~~ to ~~the item~~.		Click "+add qualifier" to provide additional detail about the role the person performed in creating the publication or contributing to its creation.

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

	In the ~~box that appears with the text~~ "Property" ~~start~~ typing “role” and ~~select the~~ auto-~~suggested option “role”~~.		In the field labelled "Property", begin typing the word “role”. Click on the suggestion to select it and auto-complete the text.

	https://daap.bannerrepeater.org/w/images/4/4a/Tutorial4_img7.png		https://daap.bannerrepeater.org/w/images/4/4a/Tutorial4_img7.png

	In the ~~next box that appears~~ to the right add the role ~~of the person~~, ~~for example~~ writer.		In the Value field to the right, add the person’s role. For example, writer, editor, or graphic designer.

	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]~~.		You can find a sample of available roles in the [https://docs.google.com/spreadsheets/d/1PtX5g-T6T8d7GSq7uYNNhPPrbHU91U-GV4aF2W18occ/edit?usp=sharing Item Index tab of our Data Model] spreadsheet. However, keep in mind, this Index is not always up-to-date, so the best way to make sure if a role exists is to search for it in the database. If it does not exist, remember that you need to add a new Item for that role.

	https://daap.bannerrepeater.org/w/images/3/36/Tutorial4_img8.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~~.		You may add multiple qualifiers to one individual if they played multiple roles.

	~~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

	~~https://daap~~.~~bannerrepeater.org/w/images/5/5c/Tutorial4_img9.png~~		When you are satisfied with the roles and qualifiers you’ve recorded in the Statement, click “save”.

	~~When you have added your qualifiers press “save”.~~		===Step 8===
	===Step 7===
	https://daap.bannerrepeater.org/w/images/9/96/Tutorial4_img10.png		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"~~.		Qualifiers can be used within various statements to add different details around a particular statement, i.e. they are not inherently linked to the property “role”.

	Choose the ~~property~~ "source" ~~and paste~~ in the URL ~~link~~ to the source ~~you are referring~~ to.		For example, if you wish, you can support any Statement with a reference/citation. To do this, click "+ add qualifier" once again.

	~~Press “save”~~.		Choose the Property "source", then in the Value field add a URL to your reference. Click “save”.

			''N.B. We are not using Wikidata’s “+ add reference” function. Please use “+add qualifier” instead.''

			We recommend adding a source only in cases where it may not be obvious, e.g. there is no need to record the publication colophon as source for every statement. However, a source could be useful to add if there is conflicting information available in multiple sources, for example, if a different publication date is listed on the publication colophon than on the artist’s website.

	~~(For search-related reasons we are not using the + add reference function. Please use +add qualifier instead.)~~		===Step 9===
	===Step 8===		You have now successfully linked a new Creator (Item) to a published Work (Item).
	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/5/54/Tutorial4_img11.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.		Where there are multiple creators/contributors, we suggest adding them within a single Statement. Simply click "+ add value" in the lower right of the shaded box, and repeat the process outlined from Step 2 of this tutorial. Each time, start by trying to type the name of the creator you want to name, establishing whether a record for them already exists in the database (or not – add it, if necessary), and defining their role.
	===Step 9===
	~~You can see where~~ an ~~artist~~ page ~~has been~~ linked to via the “What links here” option in the sidebar.		===Step 10===
			Any Items linked as Values within an Item page, will automatically operate as reverse links, too.

			For example, once an Item, such as the Item for creator or publisher, is linked to in the publication’s Item page via the properties “creators / contributors” or “publisher”, that statement will automatically create a reverse link within the database, too. These links are accessible via the “What links here” option in the Tools section of the Menu sidebar on the respective Item pages for the creator or publisher.

	https://daap.bannerrepeater.org/w/images/c/c5/Tutorial4_img12.png		https://daap.bannerrepeater.org/w/images/c/c5/Tutorial4_img12.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 fast and efficient way to discover cross-references within the database, which removes the need to manually create ‘reverse Statements’ (i.e. manually listing all the works an artist has created on their own Item page).

	https://daap.bannerrepeater.org/w/images/0/02/Tutorial4_img13.png		https://daap.bannerrepeater.org/w/images/0/02/Tutorial4_img13.png

			''Once you have added sufficient information about your publication Item in the database, feel free to add the Property “date added” and add today’s date as the Value. This is a special property (which is not mandatory, but recommended), as it will ensure your publication gets featured on the homepage of the archive.''

Loz.ross: /* Step 4 */

2021-07-30T23:07:35Z

Step 4

← Older revision		Revision as of 23:07, 30 July 2021
Line 35:		Line 35:

	===Step 4===		===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.		Navigate to the Create a new Item page. You can access it via the Main page, from the left side menu, or directly via [https://daap.bannerrepeater.org/wiki/Special:NewItem this link].

			We recommend opening this page in a separate browser tab. Right/option click on the link and select “Open in new tab”.

	~~We recommend working with this in~~ a ~~separate browser tab~~, ~~so right click on the link and select “Open in new tab”~~.		For a reminder of how to create a new Item, follow [https://daap.network/tutorial_3 Tutorial 3].

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

Loz.ross: /* Step 3 */

2021-07-30T23:06:26Z

Step 3

← Older revision		Revision as of 23:06, 30 July 2021
Line 22:		Line 22:

	===Step 3===		===Step 3===
	Before we add any new ~~items we~~ always want to make sure it doesn’t already exist in the database.		Before you add any new Item you always want to make sure it doesn’t already exist in the database.

	~~To do this, start~~ typing the name of the creator in the ~~value bar~~ on the right.		Start typing the name of the creator in the Value field on the right.

	https://daap.bannerrepeater.org/w/images/9/93/Tutorial4_img2.png		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.		If you see an auto-suggestion corresponding to the name of the person you're looking for, click to select it, then click to Save the statement. No further action is needed, unless you want to add a qualifier to describe the role that person performed in relation to the work. If so, jump ahead to Step 6 of this tutorial.

	https://daap.bannerrepeater.org/w/images/b/b2/Tutorial4_img3.png		https://daap.bannerrepeater.org/w/images/b/b2/Tutorial4_img3.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.		However, if you finish typing the name of the creator, but no suggestion appears you will encounter the message: "No match was found". This indicates that you will need to make a new Item for the creator because they do not yet exist in the database.

	===Step 4===		===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.		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.

Loz.ross: /* Step 2 */

2021-07-30T23:02:43Z

Step 2

← Older revision		Revision as of 23:02, 30 July 2021
Line 17:		Line 17:
	Click on “+ add statement”.		Click on “+ add statement”.
	===Step 2===		===Step 2===
	Start typing "creators / contributors" in the box ~~with the text~~ "~~Properties.~~"		Start typing "creators / contributors" in the box labelled "Property", it will appear as an auto-suggested option. Click on the suggestion to select it and auto-complete the text.
	~~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		https://daap.bannerrepeater.org/w/images/a/af/Tutorial4_img1.png

Loz.ross: /* Create other items needed to describe a work */

2021-07-30T23:01:50Z

Create other items needed to describe a work

← Older revision		Revision as of 23:01, 30 July 2021
Line 1:		Line 1:
	=Tutorial 5=		=Tutorial 5=
	==~~Create~~ other items needed to describe a work==		==Linking 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.		=== ===
			At the end of [https://daap.network/tutorial_4 Tutorial 4], we established that adding Statements about who created/contributed, published, or commissioned a work often involves referring to multiple other Items (which, as explained in [https://daap.network/tutorial_3 Tutorial 3], can be person(s) or organisations as well as published works, objects and processes, among other things).

			'''Each and every Item you refer to must exist within the database''' for a Statement to be made.

			So, to add all the information relevant to your Item, you may find you need to create other new Items first.

			For example, to make a Statement about who created a work (Item), you must ensure that an Item page exists for the creator as well.

			Search the database to check. Then, if the creator (Item) does not yet exist in the archive, you must add it.

			The following steps will guide you through adding a Statement about the creator/contributors of a published work to your Item page about this work.

	~~We’ll show you how to do this by walking you through the steps of adding an author to your Item page.~~
	===Step 1===		===Step 1===
	Click on “+ add statement”.		Click on “+ add statement”.

Loz.ross at 22:23, 30 July 2021

2021-07-30T22:23:07Z

Show changes

Loz.ross: /* Step 6 */

2020-12-14T16:57:46Z

Step 6

← Older revision		Revision as of 16:57, 14 December 2020
Line 31:		Line 31:
	We have three types of licenses in the database:		We have three types of licenses in the database:

	# Public domain (CC0), which means you give up all rights to your work (we don’t really recommend this unless it’s a conceptual part of your work).		1. Public domain (CC0), which means you give up all rights to your work (we don’t really recommend this unless it’s a conceptual part of your work).
	# Creative Commons license – there are a range of nuance and variation among these, but there are very good sources online to pick and choose the right one for you. For example, you can read more about all CC options here, or use the Chooser tool here.
	# Copyrighted, meaning you reserve all your rights and no one can use your image for any purpose without your permission; This can be necessary sometimes, but our recommendation is to consider among the more nuanced creative commons options.		2. Creative Commons license – there are a range of nuance and variation among these, but there are very good sources online to pick and choose the right one for you. For example, you can read more about all CC options here, or use the Chooser tool here.

			3. Copyrighted, meaning you reserve all your rights and no one can use your image for any purpose without your permission; This can be necessary sometimes, but our recommendation is to consider among the more nuanced creative commons options.

	===Step 7===		===Step 7===
	'''Upload Options:'''		'''Upload Options:'''

Loz.ross at 16:57, 14 December 2020

2020-12-14T16:57:03Z

← Older revision		Revision as of 16:57, 14 December 2020
Line 30:		Line 30:

	We have three types of licenses in the database:		We have three types of licenses in the database:

	# Public domain (CC0), which means you give up all rights to your work (we don’t really recommend this unless it’s a conceptual part of your work).		# Public domain (CC0), which means you give up all rights to your work (we don’t really recommend this unless it’s a conceptual part of your work).
	# Creative Commons license – there are a range of nuance and variation among these, but there are very good sources online to pick and choose the right one for you. For example, you can read more about all CC options here, or use the Chooser tool here.		# Creative Commons license – there are a range of nuance and variation among these, but there are very good sources online to pick and choose the right one for you. For example, you can read more about all CC options here, or use the Chooser tool here.