Tutorial 3 - Revision history

Loz.ross: /* Create a new Item */

2021-08-01T23:22:46Z

Create a new Item

← Older revision		Revision as of 23:22, 1 August 2021
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.

Loz.ross: /* Step 4 */

2021-07-30T22:40:49Z

Step 4

← Older revision		Revision as of 22:40, 30 July 2021
Line 54:		Line 54:

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

Loz.ross: /* Step 3 */

2021-07-30T22:40:28Z

Step 3

← Older revision		Revision as of 22:40, 30 July 2021
Line 27:		Line 27:

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

Loz.ross: /* Step 2 */

2021-07-30T22:38:39Z

Step 2

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

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

Loz.ross: /* Step 1 */

2021-07-30T22:37:40Z

Step 1

← Older revision		Revision as of 22:37, 30 July 2021
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”.		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”.

Loz.ross: /* */

2021-07-30T22:33:29Z

← Older revision		Revision as of 22:33, 30 July 2021
Line 2:		Line 2:

	==Create a new Item==		==Create 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.

Loz.ross: /* Create a new Item */

2021-07-30T22:33:10Z

Create a new Item

← Older revision		Revision as of 22:33, 30 July 2021
Line 2:		Line 2:

	==Create a new Item==		==Create a new Item==
	You can use the '''Create a new Item''' form to add new '''~~items~~''' to the database ~~whether~~ the ~~item~~ is ~~a thing such as a specific artwork or object~~, a person, an institution, or a place in the world. ~~Items can~~ also ~~be less specific "things" such as~~ "paper", "offset printing", "softcover ~~binding", etc~~. Item ~~records can be very complex~~, with lots of information attached to ~~them, as is the case~~ for ~~artworks, or very simple with only one or two pieces of information attached~~, such as ~~the record for~~ "softcover binding" ~~for example~~.		==== ====
			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===		===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].		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].

Loz.ross at 22:23, 30 July 2021

2021-07-30T22:23:48Z

← Older revision		Revision as of 22:23, 30 July 2021
Line 1:		Line 1:
	=Tutorial 3=		=Tutorial 3=

	==~~Edit~~ Item ~~page~~==		==Create 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 new '''items''' to the database whether the item is a thing such as a specific artwork or object, a person, an institution, or a place in the world. Items can also be less specific "things" such as "paper", "offset printing", "softcover binding", etc. Item records can be very complex, with lots of information attached to them, as is the case for artworks, or very simple with only one or two pieces of information attached, such as the record for "softcover binding" for example.

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

	~~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 [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/6/6d/Tutorial3_img2.png~~

	===Step 1===		===Step 1===
	~~Now,~~ to ~~add statements~~ to ~~your~~ Item page go to the ~~page you have already created~~.		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].
			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].

	~~Click on “+ add statement”~~.		https://daap.bannerrepeater.org/w/images/e/ee/Tutorial2_img1.png

	~~https~~:~~//daap.bannerrepeater.org/w/images/b/b4/Tutorial3_img3.png~~		In order to do so you should log in. If you are not logged in an error message will be shown:

	~~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~~.		https://daap.bannerrepeater.org/w/images/3/34/Tutorial2_img2.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~~.		You can login using [https://daap.bannerrepeater.org/w/index.php?title=Special:UserLogin&returnto=Main+Page this link] or from the Main Page.
	===Step 2===		===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"~~.		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”.

	~~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/c/c3/Tutorial2_img3.png

	~~https://daap~~.~~bannerrepeater.org/w/images/e/e0/Tutorial3_img4.png~~		===Step 3===
			Then, start adding the details into the form on the Create a new Item page.

	~~===Step 3===~~		https://daap.bannerrepeater.org/w/images/5/5c/Tutorial2_img4.png
	~~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~~.		'''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.

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

	~~https~~:~~//daap~~.~~bannerrepeater~~.~~org/w/images/4/4e/Tutorial3_img5.png~~		'''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.

	~~===Step 4===~~		Once the item is created, the description will appear at the top of the item page (see Step4).
	~~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~~.		'''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 \| .

	~~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~~.		Here we have entered the details for the publication ''Surviving art school : an artist of colour tool kit''.

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

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

Loz.ross at 15:35, 14 December 2020

2020-12-14T15:35:00Z

← Older revision		Revision as of 15:35, 14 December 2020
Line 1:		Line 1:
	~~Coming soon!~~		=Tutorial 3=

			==Edit Item page==
			https://daap.bannerrepeater.org/w/images/9/95/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 [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.

			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 [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/6/6d/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”.

			https://daap.bannerrepeater.org/w/images/b/b4/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.

			https://daap.bannerrepeater.org/w/images/e/e0/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.

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

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

Loz.ross: Created page with "Coming soon!"

2020-12-08T17:53:35Z

Created page with "Coming soon!"

New page

Coming soon!