Difference between revisions of "Tools: Basic wiki skills & palaeographical tips"

From MarineLives
Jump to: navigation, search
m (Creating a short biography)
m (ColinGreenstreet moved page Tools: Basic wiki skills to Tools: Basic wiki skills & palaeographical tips without leaving a redirect)
 
(38 intermediate revisions by the same user not shown)
Line 1: Line 1:
'''THIS PAGE IS UNDER CONSTRUCTION AND IS NOT READY FOR USE'''
+
==Week One goals==
 +
 
 +
'''In the first week of the MarineLives/Warwick Autumn 2017 & Spring 2018 transcription skills training we will:'''
 +
 
 +
'''(1) Learn basic wiki writing and editing skills by creating biographical profiles, by adding to an online index of Admiralty Court witnesses, and by creating new form-based wiki pages with accompanying images ready for transcription.'''
 +
 
 +
'''(2) Take a look at some of the palaeographical challenges presented in English Admiralty Court documents, together with a number of MarineLives resources such as check-lists and glossaries to help solve these challenges.'''
  
 
==Wiki practice==
 
==Wiki practice==
Line 16: Line 22:
 
(2) Type in the text of your profile. Use carriage return and a line space if you wish to separate lines in the text when published.
 
(2) Type in the text of your profile. Use carriage return and a line space if you wish to separate lines in the text when published.
  
(3) Make use of bold, underlining and italics as you see fit in your text.
+
(3) Make use of bold, underlining and italics as you see fit in your text. To see how to produce those effects go to [[Sandbox|Sandbox]] and look at the page in edit mode.
  
 
(4) Click "Save page" at the bottom of the page in edit mode to save and publish the text
 
(4) Click "Save page" at the bottom of the page in edit mode to save and publish the text
Line 25: Line 31:
  
 
----
 
----
 
 
====Uploading a photograph for your profile====
 
====Uploading a photograph for your profile====
  
Line 34: Line 39:
 
(1) Go to the Tools header in the vertical sidebar of the MarineLives wiki and click on "Upload File"
 
(1) Go to the Tools header in the vertical sidebar of the MarineLives wiki and click on "Upload File"
  
(2) Use the browse option under "Source file" to find the name of the photograph you wish to upload, and select this file
+
(2) Use the browse option under "Source file" to find the name of the photograph you wish to upload from your computer, and select this file
  
 
(3) Click the "Upload file" at the bottom of the "Upload file" window
 
(3) Click the "Upload file" at the bottom of the "Upload file" window
Line 43: Line 48:
  
 
----
 
----
 
 
===Learning editing skills===
 
===Learning editing skills===
  
This week we will learn some basic wiki editing skills, whilst also contributing to the development of the MarineLives wiki in terms of search tools and digital image uploads.
+
'''This week we will learn some basic wiki editing skills, whilst also contributing to the development of the MarineLives wiki in terms of search tools and digital image uploads.'''
  
 
----
 
----
Line 53: Line 57:
 
[[File:HCA 1363 Deponents Index Screen Grab.PNG|1000px|thumb|left|Screen capture of HCA 13/63 Deponents by folio index: ff.10r-19v)]]
 
[[File:HCA 1363 Deponents Index Screen Grab.PNG|1000px|thumb|left|Screen capture of HCA 13/63 Deponents by folio index: ff.10r-19v)]]
  
We have begun to create an online index of deponents (witnesses) for the volume of English Admiralty Court depositions named [[HCA 13/63|HCA 13/63]]
+
'''We have begun to create an online index of deponents (witnesses) for the volume of English Admiralty Court depositions named [[HCA 13/63|HCA 13/63]]. To practice creating text links within the MarineLives wiki, we would like each of you to add to this index.'''
 
+
To practice creating text links within the MarineLives wiki, we would like each of you to add to this index.
+
  
 
(1) Go to the index, which you will find at the top the [[HCA 13/63|HCA 13/63 summary page]], or you can right click on [[HCA 13/63 Deponents - by folio|HCA 13/63 Deponents - by folio]] to open the index in a separate window.
 
(1) Go to the index, which you will find at the top the [[HCA 13/63|HCA 13/63 summary page]], or you can right click on [[HCA 13/63 Deponents - by folio|HCA 13/63 Deponents - by folio]] to open the index in a separate window.
Line 61: Line 63:
 
(2) Click on the edit button at the top right hand corner of the page to be able to edit the whole page.
 
(2) Click on the edit button at the top right hand corner of the page to be able to edit the whole page.
  
(3) Alternatively, click the edit button to the right hand side of each section of ten folios to be able to edit just that section
+
(3) Alternatively, click the edit button to the right hand side of each section of ten folios to be able to edit just that section.
  
 
(4) Take a look at a section which has already had links added to the relevant folios. For example, ff.10r-19v. This will reveal the symbols you will need to use to create new links.
 
(4) Take a look at a section which has already had links added to the relevant folios. For example, ff.10r-19v. This will reveal the symbols you will need to use to create new links.
  
[COMPLETE THIS SECTION]
 
 
----
 
----
 
====Creating and editing new content pages====
 
====Creating and editing new content pages====
  
[[File:Create Page HCA 1363 f450r Annotate.PNG|800px|thumb|left|Screen capture of Create Page: HCA 13/63 f.450r Annotate)]]
+
[[File:Create Page HCA 1363 f450r Annotate.PNG|800px|thumb|left|Screen capture of Create Page: HCA 13/63 f.450r Annotate]]
  
 
'''The MarineLives wiki uses two types of pages: form based pages and free-form pages. This week we are going to learn how to create a form based page, how to upload a digital image of a manuscript page to that page, and how to add transcribed text to the same page.'''
 
'''The MarineLives wiki uses two types of pages: form based pages and free-form pages. This week we are going to learn how to create a form based page, how to upload a digital image of a manuscript page to that page, and how to add transcribed text to the same page.'''
 +
 +
'''We will be creating new pages for the [[HCA 13/63|HCA 13/63 volume of depositions]] - the original volume has 535 folios in total, but to date we have created electronic pages for ff.1r to ff.449v.'''
 +
 +
'''Each team member will be asked to create 3 new pages, and will be sent the relevant digital images by email, so that they can upload them to the pages they create'''
 +
 +
[[File:Metadata Example.PNG|800px|thumb|left|Metadata example: HCA 13/71 f.490r Annotate]]
 +
 +
----
 +
<u>Instructions</u>
  
 
(1) You will see in the vertical sidebar in this wiki a section called "Forms", which includes a button called "Create Page".  Click on this button and we will create a new Form-based page together.
 
(1) You will see in the vertical sidebar in this wiki a section called "Forms", which includes a button called "Create Page".  Click on this button and we will create a new Form-based page together.
Line 83: Line 93:
 
<u>Page details</u>
 
<u>Page details</u>
  
Parent volume = HCA 13/63 (chose from a dxrop down menu)
+
''Parent volume'' = HCA 13/63 (chose from a dxrop down menu)
  
Folio = 450 (type the number)
+
''Folio'' = 450 (type the number)
  
Side = Recto (chose from drop down menu)
+
''Side'' = Recto (chose from drop down menu)
  
Status = Type "Requires image" (or if image is being uploaded at same time as page is created type "Uploaded image")
+
''Status'' = Type "Requires image" (or if image is being uploaded at same time as page is created type "Uploaded image")
  
First transcriber = Type "Untranscribed"
+
''First transcriber'' = Type "Untranscribed"
  
On = Leave blank; once first cut transcription has been made select date of transcription from calendar drop down men
+
''On'' = Leave blank; once first cut transcription has been made select date of transcription from calendar drop down men
  
Editorial history = Leave blank; add summary text at editorial stage of transcription process
+
''Editorial history'' = Leave blank; add summary text at editorial stage of transcription process
  
Note: Type "IMAGE: XXXX" and replace "XXXX" with the image ID for the digital image of the manuscript page. In this case "IMG_113_02_6647.jpg"
+
''Note'' = Type "IMAGE: XXXX" and replace "XXXX" with the image ID for the digital image of the manuscript page. In this case "IMG_113_02_6647.jpg"
  
 
(4) The image can be uploaded at the time the page is created, or at a later date, after saving the page without the image
 
(4) The image can be uploaded at the time the page is created, or at a later date, after saving the page without the image
Line 107: Line 117:
 
(7) Scroll to the bottom of the page once the image thumbnail has appeared and press the "Save page" button
 
(7) Scroll to the bottom of the page once the image thumbnail has appeared and press the "Save page" button
  
(8) Once the image is rendered, you will see the page with the text metadata you have entered and a large thumnail of the manuscript image
+
(8) Once the image is rendered, you will see the page with the text metadata you have entered and a large thumbnail of the manuscript image
  
 +
----
 +
===Sandbox===
 +
 +
[[File:Wiki Sandbox.PNG|400px|thumb|left|Wiki sandbox]]
 +
 +
'''We have created a wiki [[Sandbox|sandbox]] for you to see and practice some simple wiki formats. You will need to click on the edit button at the top right hand corner of the Sandbox page to see the wiki code which produces different formats, and different image sizes and positions on a page.'''
  
 
----
 
----
  
 
==Palaeographic tips==
 
==Palaeographic tips==
 +
----
 +
===Palaeographical challenges in English Admiralty Court records===
  
[Introduce types of palaeographical challenge in English Admiralty Court records]
+
[[File:Document Types.PNG|600px|thumb|left|English Admiralty Court document types]]
  
[Introduce MarineLives resources to assiste transcribers with palaeographical challenges]
+
'''In our Week 1 Skype call we will review pages from three types of Admiralty Court document:  Acts of Court; Personal Answers; and Depositions.  In team discussion we will explore some of the specific palaeographical challenges of each type of document.'''
  
[COMPLETE THIS SECTION]
+
'''The three specific documents we will be using will be:'''
  
 +
[[HCA 3/46|HCA 3/46]] (Act books, 1654-56)
 +
 +
[[HCA 13/124|HCA 13/124]] (Personal answers, 1650-52)
 +
 +
[[HCA 13/71|HCA 13/71]] (Depositions, 1656-57)
 
----
 
----
==Introductory reading on the English Admiralty Court==
 
  
Use input from Dr Richard Blakemore and Dr Philip Hnatkovich
+
===Avoiding transcription errors===
 +
 
 +
'''We have developed an [[Avoiding Transcription Errors|alphabetical list of words which past experience tells us can cause problems]] for transcribers of English Admiralty Court documents. You may wish to browse the list prior to starting transcription, or use it as a look-up aid when transcribing.'''
 +
----
 +
===Glossaries===
 +
 
 +
'''Glossaries are a useful resource when stuck on a word or phrase. You may find the following glossaries useful.  Please feel free to add to and edit the glossaries during the course of your own transcription work and reading of English Admiralty Court material, including links to the relevant MarineLives wiki pages.'''
 +
 
 +
[[Tools: Commodities glossary|Commodities glossary]]
 +
 
 +
- a glossary of traded commodities taken from mid-C17th English High Court of Admiralty documents, second half of the C17th Chancery Court documents relating to commercial disputes, second half of the C17th Prerogative Court of Canterbury merchants' inventories, and a London coastal portbook from the 1650s.
 +
 
 +
[[Tools: Geographical glossary|Geographical glossary]]
 +
 
 +
- a glossary of geographical terms taken from mid-C17th English High Court of Admiralty documents, second half of the C17th Chancery Court documents relating to commercial disputes, and second half of the C17th Prerogative Court of Canterbury merchants' inventories.
 +
 
 +
[[Tools: Admiralty court legal glossary|Admiralty Court legal glossary]]
 +
 
 +
- a glossary of legal terms used in the English High Court of Admiralty taken from mid-C17th English High Court of Admiralty documents.
 +
 
 +
[[Tools: Marine glossary|Marine glossary]]
  
[COMPLETE THIS SECTION]
+
- a glossary of marine terms taken from mid-C17th English High Court of Admiralty documents, second half of the C17th Chancery Court documents relating to commercial disputes, and second half of the C17th Prerogative Court of Canterbury merchants' inventories.

Latest revision as of 23:32, October 18, 2017

Week One goals


In the first week of the MarineLives/Warwick Autumn 2017 & Spring 2018 transcription skills training we will:

(1) Learn basic wiki writing and editing skills by creating biographical profiles, by adding to an online index of Admiralty Court witnesses, and by creating new form-based wiki pages with accompanying images ready for transcription.

(2) Take a look at some of the palaeographical challenges presented in English Admiralty Court documents, together with a number of MarineLives resources such as check-lists and glossaries to help solve these challenges.

Wiki practice


The best way to learn wiki writing and editing skills is through practice.



Creating a short biography


This week we will practice wiki writing skills by each team member writing a short text profile and uploading a thumbnail photograph to accompany the text. The profiles should be published on the page named Biographies



Writing wiki text


(1) Go to the page named Biographies and click on the edit button in the top right hand corner of the page. You will need to be logged into the wiki with your UserName and Password to be able to get into edit mode. Remember that UserNames and Passwords are case sensitive. Please contact the team facilitator if you have any trouble with your UserName and /or Password.

(2) Type in the text of your profile. Use carriage return and a line space if you wish to separate lines in the text when published.

(3) Make use of bold, underlining and italics as you see fit in your text. To see how to produce those effects go to Sandbox and look at the page in edit mode.

(4) Click "Save page" at the bottom of the page in edit mode to save and publish the text

(5) To change the content, highlighting and layout return to edit mode, make your desired changes and save the page again.

(6) To view earlier versions of the page click "View history" in the top right hand corner of the page



Uploading a photograph for your profile


Screen capture of file upload of Colin & Bron.PNG)

To upload a photograph you will need to do the following:

(1) Go to the Tools header in the vertical sidebar of the MarineLives wiki and click on "Upload File"

(2) Use the browse option under "Source file" to find the name of the photograph you wish to upload from your computer, and select this file

(3) Click the "Upload file" at the bottom of the "Upload file" window

(4) A new window will open which will display the file you have uploaded

(5) Insert the uploaded file into your profile of yourself using the following expression: [TO BE COMPLETED: ADD THUMBNAIL IMAGE]



Learning editing skills


This week we will learn some basic wiki editing skills, whilst also contributing to the development of the MarineLives wiki in terms of search tools and digital image uploads.



Adding to the HCA 13/63 index of deponents


Screen capture of HCA 13/63 Deponents by folio index: ff.10r-19v)

We have begun to create an online index of deponents (witnesses) for the volume of English Admiralty Court depositions named HCA 13/63. To practice creating text links within the MarineLives wiki, we would like each of you to add to this index.

(1) Go to the index, which you will find at the top the HCA 13/63 summary page, or you can right click on HCA 13/63 Deponents - by folio to open the index in a separate window.

(2) Click on the edit button at the top right hand corner of the page to be able to edit the whole page.

(3) Alternatively, click the edit button to the right hand side of each section of ten folios to be able to edit just that section.

(4) Take a look at a section which has already had links added to the relevant folios. For example, ff.10r-19v. This will reveal the symbols you will need to use to create new links.



Creating and editing new content pages


Screen capture of Create Page: HCA 13/63 f.450r Annotate

The MarineLives wiki uses two types of pages: form based pages and free-form pages. This week we are going to learn how to create a form based page, how to upload a digital image of a manuscript page to that page, and how to add transcribed text to the same page.

We will be creating new pages for the HCA 13/63 volume of depositions - the original volume has 535 folios in total, but to date we have created electronic pages for ff.1r to ff.449v.

Each team member will be asked to create 3 new pages, and will be sent the relevant digital images by email, so that they can upload them to the pages they create

Metadata example: HCA 13/71 f.490r Annotate


Instructions

(1) You will see in the vertical sidebar in this wiki a section called "Forms", which includes a button called "Create Page". Click on this button and we will create a new Form-based page together.

(2) Enter into empty box on the page named "Form:Page" the name of the new page you wish to create and press the "create or edit" button. For example, enter "HCA 13/63 f.450r Annotate". If a page of that name already exists, a window will open displaying that page in edit mode. If there is no page of that name, a window will open with blank fields for "Page Details" and "Transcription details"

(3) Enter the correct data into the blank fields for the "Page details" of the page you are creating.

In the case of HCA 13/63 f.450r Annotate:

Page details

Parent volume = HCA 13/63 (chose from a dxrop down menu)

Folio = 450 (type the number)

Side = Recto (chose from drop down menu)

Status = Type "Requires image" (or if image is being uploaded at same time as page is created type "Uploaded image")

First transcriber = Type "Untranscribed"

On = Leave blank; once first cut transcription has been made select date of transcription from calendar drop down men

Editorial history = Leave blank; add summary text at editorial stage of transcription process

Note = Type "IMAGE: XXXX" and replace "XXXX" with the image ID for the digital image of the manuscript page. In this case "IMG_113_02_6647.jpg"

(4) The image can be uploaded at the time the page is created, or at a later date, after saving the page without the image

(5) To upload a manuscript image, find the correct image ID for the page you are creating, and either drag and drop the image to the "Transcription image" section of the page, or press the button "Upload new image" and browse your computer to find the correct image ID and then upload.

(6) You will see a horizontal bar growing in length across the screen as the image uploads, and when uploaded a thumbnail of the image will appear embedded in the page framework

(7) Scroll to the bottom of the page once the image thumbnail has appeared and press the "Save page" button

(8) Once the image is rendered, you will see the page with the text metadata you have entered and a large thumbnail of the manuscript image



Sandbox


Wiki sandbox

We have created a wiki sandbox for you to see and practice some simple wiki formats. You will need to click on the edit button at the top right hand corner of the Sandbox page to see the wiki code which produces different formats, and different image sizes and positions on a page.


Palaeographic tips



Palaeographical challenges in English Admiralty Court records


English Admiralty Court document types

In our Week 1 Skype call we will review pages from three types of Admiralty Court document: Acts of Court; Personal Answers; and Depositions. In team discussion we will explore some of the specific palaeographical challenges of each type of document.

The three specific documents we will be using will be:

HCA 3/46 (Act books, 1654-56)

HCA 13/124 (Personal answers, 1650-52)

HCA 13/71 (Depositions, 1656-57)


Avoiding transcription errors


We have developed an alphabetical list of words which past experience tells us can cause problems for transcribers of English Admiralty Court documents. You may wish to browse the list prior to starting transcription, or use it as a look-up aid when transcribing.



Glossaries


Glossaries are a useful resource when stuck on a word or phrase. You may find the following glossaries useful. Please feel free to add to and edit the glossaries during the course of your own transcription work and reading of English Admiralty Court material, including links to the relevant MarineLives wiki pages.

Commodities glossary

- a glossary of traded commodities taken from mid-C17th English High Court of Admiralty documents, second half of the C17th Chancery Court documents relating to commercial disputes, second half of the C17th Prerogative Court of Canterbury merchants' inventories, and a London coastal portbook from the 1650s.

Geographical glossary

- a glossary of geographical terms taken from mid-C17th English High Court of Admiralty documents, second half of the C17th Chancery Court documents relating to commercial disputes, and second half of the C17th Prerogative Court of Canterbury merchants' inventories.

Admiralty Court legal glossary

- a glossary of legal terms used in the English High Court of Admiralty taken from mid-C17th English High Court of Admiralty documents.

Marine glossary

- a glossary of marine terms taken from mid-C17th English High Court of Admiralty documents, second half of the C17th Chancery Court documents relating to commercial disputes, and second half of the C17th Prerogative Court of Canterbury merchants' inventories.