MarineLives - User contributions [en-gb]

User:GavinRobinson

2025-05-09T08:26:14Z

GavinRobinson: updated for current circumstances

'''Dr Gavin Robinson''' is a professional research assistant and manuscript transcriber. Formerly an independent historian. No longer doing unpaid work.

Data from his old research on the British Civil Wars is freely available at [https://github.com/drgavinr Github].

User:ColinGreenstreet/Issue log

2018-05-21T11:25:01Z

GavinRobinson: /* Item 3. Red links */

'''Issue Log and Open Questions'''

==Issue Log==
----
===Item 1.Duplicate sections inserted every time Form is saved===

'''The [[Form:SemBioLongInfoBoxThreeWithBanner]] seems to insert an extra section every time a page created using the Template and associated Form is saved'''

- Is there a glitch or have I coded the Form incorrectly?
- The form should create three sections, which are optional for filling out. The sections are (1) Biographical synthesis (2) Evidence from High Court of Admiralty (2) Comment on sources
- NB: The extra inserted section on saving is ONLY the Comment on sources section, and the extra insertion only happens if that section contains no text after the Form creating the Semantic biography has been saved for the first time
----

===Item 2. Form filled out in popout mode won't save though logged in===

I have filled out a form in popup mode [[Form:SemBioLongInfoBoxThreeWithBanner]] to create a new semantic biography, which I accessed via the Create/Edit button I have put on the front page of the wiki.

The button contains popup instructions:

<pre>
{{#forminput:form=SemBioLongInfoBoxThreeWithBanner|size=50|default value=|placeholder=Type name of an Admiralty Court deponent|button text=Create or edit a MarineLives biography|popup}}
</pre>

When I try to save the form it won't save, although all the mandatory fields were filled out.

I have re-keyed in the data to the same form accessed through http://www.marinelives.org/wiki/Special:Forms

and I have been able to save this form and data perfectly well.

The saved page is here: http://www.marinelives.org/wiki/Edward_Odling

'''Am I doing something wrong, or is there a problem in saving data from a popup Form?'''

----

===Item 3. Uploading an image file from a Form===

I am trying to add capability to my [[Form:SemBioLongInfoBoxThreeWithBanner]] and [[Template:SemBioLongInfoBoxThree]] similar to the upload image capability [[Tools: Tech Talk|Rowan Beenje]], the designer of the MarineLives SMW built into the [[Form:Page]] we use to create standard High Court of Admiralty deposition pages, which contain both transcriptions and a single image. The image in our standard pages has the Property:Transcription image

The relevant MediaWiki manual page seems to be: https://www.mediawiki.org/wiki/Extension:Semantic_Forms/Input_types#Uploading_files

I have created a new Property called "Has signoff image" which is intended to be used for thumbnail size images of signatures or markes taken from the bottom of depositions using the Microsoft snipping tool to create an image.

I want to make these thumbnail images uploadable through the [[Form:SemBioLongInfoBoxThreeWithBanner]] and to make them displayable in the InfoBox which this Form produces.

I have given the Property "Has signoff image" the data type "Has type:Page", though perhaps it should be "Has type:Text". There isn't an option "Has type:Image"

The code I have added to the Template:SemBioLongInfoBoxThree

<pre>
! Has signoff image
| [[Has signoff image::{{{Has signoff image|}}}]]
|-
</pre>
The Template is now called out as:

<pre>
{{SemBioLongInfoBoxThree
|Person=
|Title=
|First name=
|Middle name(s)=
|Last name=
|Occupation=
|Training=
|Had apprentice(s)=
|Citizen=
|Literacy=
|Has signoff text=
|Has signoff image=
|Language skills=
|Birth street=
|Birth parish=
|Birth town=
|Birth county=
|Birth province=
|Birth country=
|Res street=
|Res parish=
|Res town=
|Res county=
|Res province=
|Res country=
|Birth year=
|Marriage year=
|Death year=
|Probate date=
|Deposition date(s)=
|Act book start page(s)=
|Deposition start page(s)=
|Personal Answer start page(s)=
|Chancery start page(s)=
|Letter start page(s)=
|Miscellaneous start page(s)=
}}
</pre>

The code I have added to the Form:SemBioLongInfoBoxThreeWithBanner is:

<pre>
! Has signoff image
| {{{field|Has signoff image|size=100|default filename=|uploadable|image preview}}}
|-
</pre>

This should specify an upload box (and does), and should also display a thumbnail image (I believe) in the Form, when the image is successfully uploaded.

The Data type of "Has signoff image" is Text (because I can't see an "Image" data type)

The relevant bit of the Form now looks like:

[[File:Has Signoff Image 01082016.PNG|500px|thumb|left|Extract from [[Form:SemBioLongInfoBoxThreeWithBanner]] showing Upload file button and text box]]

When I click on Upload file I get the following box:

[[File:Choose File 01082016.PNG|500px|thumb|left|Upload box accessed from Form]]

I select a file and add the following data, with the name of the file set to default

[[File:Chose Image Selected 01082016.PNG|500px|thumb|left|File selected with upload file button]]

I click on Upload File and the URL goes to: http://www.marinelives.org/wiki/Special:UploadWindow, but otherwise the screen is blank and appears to be frozen.

When I go back to the main Template in edit mode the file appears not to have loaded.

For the text in the Form against the Field "Has signoff image" I have typed "Henry Betts signoff image, HCA 13/72 f.30v Annotate", which I assume will display at the footer of the thumnail once I can get the image to display properly?

However, when I try again from the Form to upload the same image I get the following screen

[[File:Image Uploaded Henry Betts 01082016.PNG|500px|thumb|left|Image uploaded but doesn't display as thumbnail in Form nor in final page]]

But, I am not getting a thumbnail preview of the image in the Form under the "Has signoff image field" which is what the SMW instruction say I should (See: https://www.mediawiki.org/wiki/Extension:Semantic_Forms/Input_types#Uploading_files).

So I have gone ahead and saved the form.

The image does not appear in the Henry Betts biography, but and in [http://www.marinelives.org/wiki/Special:Browse/Henry_Betts Browse page screen] for Henry Betts I get "Has signoff image Henry Betts signoff image, HCA 13/72 f.30v Annotate +"

What am I doing wrong?
----

===Item 4.===

ADD DATA

----
===Item 5.===

ADD DATA

----

===Item 6.===

ADD DATA

----

===Item 7.===

ADD DATA

----
===Item 8.===

ADD DATA

----
===Item 9.===

ADD DATA

----
===Item 10.===

ADD DATA

----

==Open Questions==
----
===Item 1. Use of Templates and Forms===

'''Is my use of Templates and Forms correct?'''

- In the case of the SemOccupation Form and Template and I have added a second Template to both the first Form and Template. The second Template is [[Template:CreateBio]] and codes for a float box with a purple header bar on the left hand side below the output of the Inline Query, which is the main component of the [[Template:SemOccupation]]. I added the second Template to the [[Form:SemOccupation]].
- Is it correct to call the Template:CreateBio a Sub Template, or is that something else?
- The reason for including the second Template is for efficiency of revising the float box content, since the float box will be used on circa 100 Semantic Occupations
- Would it have been better to leave the second Template out of the first Template and simply have the second Template selected through the Form:SemOccupation?
-- I have actually included the following code in the [[Form:SemOccupation]], but I don't think it is correct, and I think it duplicates me pasting the [[Template:CreateBio]] into [[Template:SemOccupation]]?

<pre>
{{{for template|CreateBio}}}
{| class="formtable"
|)
{{{end template}}}
</pre>

[[Template:SemBioLongInfoBoxThree]] defines category: Form3withbanner semantic biography
[[Form:SemBioLongInfoBoxThreeWithBanner]]

[[Template:SemParish]] defines category: Semantic parish
[[Form:SemParish]]

----

===Item 2. How deal with some structural issues to do with Property naming and definition in a particular Template and Form?===

'''How handle Mariner occupations?'''
- Sometimes stated in upfront deposition summary that deponent is a Mariner, but sometimes stated in text
- Many mariners are just described as Mariners, but some have additional roles stated in upfront deposition summary, e.g. Master, Boatswain, Carpenter's Mate
- I have created a second Property called "Mariner occupation"
- How make filling out "Mariner occupation" conditional on ticking a box, or filling out, "Mariner" OR "Sailor"?

[[Template:SemOccupation]] defines category: Semantic occupation
[[Form:SemOccupation]]

----

===Item 3. Red links===

'''How direct red links of certain types to certain types of Form to create new pages?'''

- I am keen to stop volunteers having the option of creating a new page without a Form
- I am keen to direct volunteers to using the right Form to create a new Semantic biography (or, just possibly, another type of page)

e.g. links which are Property type "Is apprentice of", "Spouse of"?

e.g. Both red links in free text in a semantic biography page and red links in the semantic biography InfoBox?

'''I have tried inserting the following code into [[:Template:XXX]]:'''

<pre>
! Is apprentice of
| [[Is apprentice of::{{#formredlink:target={{{Is apprentice of|}}}|form=SemBioLongInfoBoxThreeWithBanner|new window}}]]
|-
</pre>

I have then entered the name David Keate into the Form for Richard Keate in the entry box for "Is apprentice of".

David Keate displays correctly as a red link, however, I get a warning triangle by the name Keate in the Richard Keate page, which when I hover over it says "David Keate" cannot be used as a page name in this wiki. Nevertheless, when I click on the David Keate red link a new page correctly opens as a Form to create the page David Keate.:

[http://www.marinelives.org/wiki/Special:FormEdit/SemBioLongInfoBoxThreeWithBanner/David_Keate Create SemBioLongInfoBoxThreeWithBanner: David Keate]

'''What am I doing wrong?'''

I was struggling with this too and I found this page while looking for examples. I've now found an answer that works but it seems like an awkward fudge and I'm surprised there isn't an easier way of doing it. The parser function #formredlink automatically creates a vanilla wikilink so you don't have to add square brackets, but there's no obvious way of making this link into a semantic property so you have to use the #set parser function to set the property separately. The way to do it in your example would be:

<pre>
! Is apprentice of
| {{#formredlink:target={{{Is apprentice of|}}}|form=SemBioLongInfoBoxThreeWithBanner|new window}}
{{#set:Is apprentice of={{{Is apprentice of|}}} }}
|-
</pre>

--[[User:GavinRobinson|GavinRobinson]] ([[User talk:GavinRobinson|talk]]) 11:23, May 21, 2018 (UTC)

----

===Item 4. Edit with Form===

'''How shut off the Edit source code option so that a volunteer or a user with a certain user status can only see the Edit with Form option for pages created with a specifc Form?

- Can another group of users be specified so that they can see the source code opetion (s.g. systems ops/administrators?

----

===Item 5. Review the developing semantic structure of the wiki===

'''Role of semantic biography pages?'''

'''Role of semantic geography pages?'''

----

===Item 6. Skype contact buttons===

'''Is there a way to add a Skype contact button to a MarineLives wiki page?'''

- Either to show a Skype address, or to originate a call?

See: https://support.skype.com/en/faq/FA99/how-do-i-add-contact-me-buttons-and-skype-uri-links-to-my-website-or-app

----

===Item 7. Suppressing blanks in an InfoBox===

'''How do I code to suppress the blanks in rows in the Semantic biography InfoBox for which there are no data?'''

- I haven't decided whether it is best to show blanks or not, but want to know technically how I would do that

----

===Item 8. Collapsible/Expandible sections in an InfoBox===

'''How would I create collapsible/expandible sections in my InfoBox in the Semantic biography pages?'''

- This would be an alternative to suppressing the blanks in rows for which there is no data

----

===Item 9. ShowFactBox Magic word often does not work===

'''In a good number of pages the ShowFactBox magic word does not generate a semantic FactBox at the bottom of a page'''

- The magic word <nowiki>__SHOWFACTBOX__</nowiki> is included in the various Tenmplates I have used to create new pages
- There seems no good reason why it works on same pages and not others

e.g. It doesn't on most of the Semantic biography pages, e.g. [[Samuell Haughton]], but the semantic properties are there and can be seen in the Samuell Haughton example [http://www.marinelives.org/wiki/Special:Browse/Samuell_Haughton Special Browse for Samuell Haughton]
e.g. It does work in the Semantic parish pages, for example [[Saint Dunstans in the East]]

You can see the <nowiki>__SHOWFACTBOX__</nowiki> code at the bottom of the [[Template:SemBioLongInfoBoxThree]]

<pre>
...
! Has source comment completed
| [[Has source comment completed::{{{Has source comment completed|}}}]]
|-
|}
__NOEDITSECTION__
__SHOWFACTBOX__

[[Category:Semantic biography]]
[[Category:Form3withbanner semantic biography]]
</includeonly>
</pre>

----

===Item 10. Sub queries===

'''I am struggling to understand how to write and use a subquery'''

- I want to be able to combine queried data from our two main types of semantic page (1) Transcription pages (Category:Page) and (2) Semantic biography pages (Catgeory:Semantic biography
- The sort of queries I have in mind are:

e.g. Show me the all the start pages of depositions for people with semantic biographies of a particular type, and show me for those people the deposition start pages and when they were first transcribed! (Property:First transcribed)
e.g. Show me the all the start pages of depositions for people with semantic biographies of a particular type, and show me for those people the deposition start pages and the text of the transcription (Property:Transcription)

----

===Item 11. InfoBox row not appearing in bold===

'''One row in my InfoBox on Semantic biography pages is not appearing in bold'''

- I created a new [[Property:Has opening text]] and gave it "Has type" Text
- I added the new Property to the [[Template:Floatboxsembiolong]] defines category: Semantic biography
- I added the new Property etc. to the [[Form:SemBioLongInfoBoxThreeWithBanner]]

s far as I can see everything is correct, but when I look at the InfoBox in any Semantic biography, after refreshing the page, the row label is NOT bold

'''What am I doing wrong?'''
<span style="color:red;">RESOLVED - I deleted the new material from the Template and the Form, saved, then added it back in again and saved, and now the row is in bold!</span>
----
===Item 12. Workaround for sorting deposition by deposition page numbers===

'''Is there a workaround to get deposition page names to sort by the number correctly?'''

e.g.. HCA 13/70 f.30v Annotate coming before HCA 13/70 f.252r Annotate, not after it?
----
===Item 13. Linking two fields for later querying===

'''Is it possible to link two fields for use in queries?'''

- I want to create multiple rows for residential address.

e.g. the following properties

Res. parish 1, Res parish 2, Res parish 3

and to associate a date with each item when the person was known to be resident there

e.g. Res 1 - 1652; Res 2 1658; Res 3 Res 1662

Is it possible to make that associateion, and if so how would I do that?

What I DON't want to do is to have a Property:Res1 1652 and a separate property Res2 1658

I want to then be able to do queries like:

- Show me all the residential addresses for this type of person

- Show me the residential addresses and the dates associated with those addressesz (in separate sortable columns, but in same row)

----
===Item 14. Assigning multiple properties to the same value entered via a Form in InfoBox===

'''Is it possible to assign multiple properties to the same value in a Form?'''

- I want to assign double tag the deposition start pages in the Info Box in the Semantic biography pages as

<nowiki>[[Page::Dep start:: VALUE]]</nowiki>

<nowiki>e.g. [[Page::Dep start::HCA 13/62 f.12r Annotate]]
</nowiki>
I think this will then allow me to conduct searches of both Pages and Semantic biographies

e.g. Show me all the transcribers of transcription pages which are classified as "Dep start"?

e.g. show me all the "Transcription text" Property fields for people for whom semantic biographies exist of a particular occupation, or location?
----

===Item 15. Text divider in Info box===

'''Have I correctly coded to insert colour text divider in InfoBox on Semantic biography pages?'''

Is there a way to include an option in the Form when filled out to specify the colour of that text divider so that it can be varied between page, but using the same Template and Form?
----

===Item 16. Sections vs Sections as Properties===

'''Should the Sections in my Semantic biographies better be treated as Property fields with Has type=Text?

This is how Rowan Beentje has coded the Transcription, People, Places, Material..sections of the standard MarineLives transcription page

This would enable (say) the text of the section "Biographical synthesis" to be displayed in a search result

----

===Item 17. Modifiable Semantic parish template===

'''How would I modify the [[:Template:SemParish]] so that it can become more generic?'''

- Currently the SemParish Template contains the hardwired text:

<Pre>
<nowiki>'''This page summarises data in the MarineLives wiki regarding the parish of {{PAGENAME}}.'''

The parish of {{PAGENAME}} is located in [[Located in::London]].</nowiki></pre>

This means that I can only use it for parishes and only use it for parishes in London

To make the Template more versitile I would be able to input via the related Form the <nowiki>[[Located in::ADD PLACE]]</nowiki>

- Do I need a separate Template, say <nowiki>Template:AddLocatedIn</nowiki>, which I would incorporate into the [[:Form:SemParish]]?

This Template would look something like

<pre>
<include only>
'''This page summarises data in the MarineLives wiki regarding the parish of {{PAGENAME}}.'''

The parish of {{PAGENAME}} is located in [[Located in::ADD TOWN]].
</include only></Pre>

<span style="color:red;">MY SOLUTION - Comments would be appreciated, since the solution, though it works, may not be "best practice". Also I think I should probably create a generic Geography Template in which the creator of a new page types in whether the place is a parish, a town, a county, or a country. The problem with having a generic geography template and form is that there can only be one query for all levels of geography.</span>

'''I have come up with the following solution, creating two new templates: [[:Template:AddLocatedIn]] and [[Template:SemParishQueryOnly]] and one new form [[:Form:SemParishNonLondon]]'''

The first Template has the code:

<pre>
<includeonly>
'''This page summarises data in the MarineLives wiki regarding the parish of {{PAGENAME}}.'''

The parish of {{PAGENAME}} is located in [[Located in::{{{Located in|}}}]]. {{Invert-property|Located in|Location of}} [[Category:Semantic parish]] __SHOWFACTBOX__
</includeonly>
</pre>

I had to put the Invert-property Template, and the Category and ShowFactBox inormation on the same line, because otherwise it messes up the spacing in the final page

The second Template has the code:

<pre>
<includeonly>{{#ask: [[Category:Semantic biography]] [[Res parish::{{PAGENAME}}]]
|mainlabel=Full name
|?Title
|?Firstname
|?Lastname
|?Suffix
|?Birth year
|?Death year
|?Birth place
|?Res parish
|?Res town
|?Res county
|?Occupation
|?Training
|?Citizen
|?Has literacy
|intro=This table aggregates data from all semantic biographies in the MarineLives wiki relating to the parish of {{PAGENAME}}
|sort=Lastname
|order=ascending
|default=Currently there are no semantic biographies for the parish of {{PAGENAME}}
}}
[[Category:Semantic parish]]
</includeonly>
</pre>

I created a new Form called [[:Form:SemParishNonLondon]]

The code for this form is:

<pre>
<includeonly>
<div id="wikiPreview" style="display: none; padding-bottom: 25px; margin-bottom: 25px; border-bottom: 1px solid #AAAAAA;"></div>
{{{for template|AddLocatedIn}}}
{| class="formtable"
! Located in
|{{{field|Located in|mandatory|size=100|input type=text|placeholder=Enter name of next higher up place in which subject place is located}}}
|-
|}
{{{end template}}}
{{{for template|SemParishQueryOnly}}}
{| class="formtable"
|}
{{{end template}}}

'''Free text:'''

{{{standard input|free text|rows=10}}}

{{{standard input|summary}}}

{{{standard input|minor edit}}} {{{standard input|watch}}}

{{{standard input|save}}} {{{standard input|preview}}} {{{standard input|changes}}} {{{standard input|cancel}}}
</includeonly>
</pre>
----
===Item 18. Multiple-instance templates===

'''Is this how I would allow a user to add rows to the inputs into the [[:Form:SemBioLongInfoBoxThreeWithBanner]]?'''

- For example, if I want to allow a user to add a second residential parish?

See [https://www.mediawiki.org/wiki/Extension:Semantic_Forms/Defining_forms#Multiple-instance_templatesMultiple-instance templates]
----
===Item 19. Defining a Property for Keywords===

'''Could we define a <nowiki>[[Property:Keywords]]</nowiki> and constrain the Keywords that can be input to a pre-created glossary?'''
----

==Suggested Systems Improvements==
----

===Item 1. Adding Semantic Drill Down and Semantic Maps Extensions===

Extensions

I have been reading up on various SMW extensions, and looking at examples of their implementation on other SMWs.

The two extensions which would have the biggest impact on improving the user experience of the MarineLives wiki would be

(1) Semantic Drill Down [https://www.mediawiki.org/wiki/Extension:Semantic_Drilldown]

(2) Semantic Maps [https://www.mediawiki.org/wiki/Extension:Semantic_Maps] (which I believe also requires the MediaWiki Maps extension as well: https://www.mediawiki.org/wiki/Extension:Maps

Drill Down will be a very powerful way of using filters to navigate through the 3000 + semantic biographies which I am suggesting we plan to have on the wiki by March 2017 and the 10,000 transcription pages (with related images) we already have.

An example of Drilldown applied to European Public Sector projects can be seen here: http://www.epsa-projects.eu/index.php?title=Special:BrowseData/Projects. The EPSA drill down analyses 825 projects with 7 filters (1) Award year (2) Award category (3) Award type (4) Sector (5)Type of activity (6) Level of Government(7) Country.

We could do something similar to drill down through 3000+ semantic biographies filtered by:

(1) Occupation (2) Geography (3) Age.

We could also drill down through the volume type and number and page hierachies, using filters such as Record type (Depositions, Personal Answers, Act Books, Miscellaneous, Letters, Prerogative Court of Canterbury Will), Volume number, Year and month of record creation...)

Semantic Maps would be a powerful way to find and display data, and could be used as a way of displaying drill down data. I believe the current versions are Maps 3.5 and Semantic Maps 3.3 [https://www.entropywins.wtf/blog/tag/semantic-maps/]. A lot of our data have strong geographical patterns, so mapping is an obvious functionality.

I have begun to assemble basic geographical coordinate information which I would like to be able to include in (1) Queries (2) Display of query results as soon as possible

See: [[:Category:Semantic parish]] , which includes a table showing London parish geo-coordinates

[https://www.semantic-mediawiki.org/wiki/Semantic_Result_Formats Semantic Results Formats Extension] is also worth looking at

- See: https://www.semantic-mediawiki.org/wiki/Help:Filtered_format

----

===Item 2.===

ADD DATA

----
===Item 3.===

ADD DATA

----
===Item 4.===

ADD DATA
----

__NOINDEX__

User talk:GavinRobinson/Test page with form

2016-07-18T16:36:49Z

GavinRobinson: edit with form working

'Edit with form' isn't appearing for this page. Have I set it up wrong or is it waiting for something to go through the job queue? The default form parser function is in [[Template:Get person subobjects]].--[[User:GavinRobinson|GavinRobinson]] ([[User talk:GavinRobinson|talk]]) 19:08, July 17, 2016 (UTC)

: Edit with form is working now. I've also updated the form and template so that the transcribed text is a template parameter, like the real edit form. That should give a better idea of how the form-based approach would work.--[[User:GavinRobinson|GavinRobinson]] ([[User talk:GavinRobinson|talk]]) 16:36, July 18, 2016 (UTC)

Form:Persname

2016-07-18T16:34:15Z

GavinRobinson: adding transcript parameter

<noinclude>
This is the "Persname" form.
To create a page with this form, enter the page name below;
if a page with that name already exists, you will be sent to a form to edit that page.

{{#forminput:form=Persname}}

</noinclude><includeonly>
<div id="wikiPreview" style="display: none; padding-bottom: 25px; margin-bottom: 25px; border-bottom: 1px solid #AAAAAA;"></div>

{{{for template|Get person subobjects}}}

'''Transcript:'''
{{{field|transcript|input type = textarea}}}

{{{end template}}}

{{{for template|Persname in form|multiple|add button text=Add another person}}}
'''Name as transcribed:''' {{{field|transcribed_name}}}

'''Role:''' {{{field|person_role|default=Mentioned}}}

'''Identified as person:''' {{{field|person_key|property=Identified as person}}}

'''Could be person:''' {{{field|possible_person_keys|list|delimiter=;|property=Could be person}}}

{{{end template}}}

{{{standard input|summary}}}

{{{standard input|minor edit}}} {{{standard input|watch}}}

{{{standard input|save}}} {{{standard input|preview}}} {{{standard input|changes}}} {{{standard input|cancel}}}
</includeonly>

User:GavinRobinson/Test page with form

2016-07-18T16:28:07Z

GavinRobinson: moved transcript into template parameter

{{Persname in form
|transcribed_name=George Willingham
|person_role=Mentioned
|person_key=User:GavinRobinson/George Willingham (d. 1651), merchant
}}
{{Persname in form
|transcribed_name=David Avys
|person_role=Mentioned
|person_key=User:GavinRobinson/David Avys
}}
{{Persname in form
|transcribed_name=Daniell Sowton
|person_role=Mentioned
}}
{{Persname in form
|transcribed_name=William Pease
|person_role=Mentioned
|possible_person_keys=William Pease senior;William Pease junior
}}
{{Get person subobjects| transcript = This page is partly copied from horse lists in [[SP 28/131/3]] and partly made up. It demonstrates the use of [[Template:persname in form]] for adding metadata about people using Semantic Forms.

George Willingham of Londonstone painter stainer entred one gray horse, his rider David Avys armed with a Carbine, a case of pistolls a buffe coate and a sword

Daniell Sowton of Mountacue close in Southwarke entred one blacke roane horse, his rider armed with a Carbine a case of pistolls a buffe coate and a sword

William Pease sadler enrolled one bay horse with a starr in his forehead, his rider armed with a case of pistolls, a carbine a buffecoate and sword}}

Template:Get person subobjects

2016-07-18T16:26:40Z

GavinRobinson: adding parameter for transcript to be more like real transcript forms

<includeonly>==Transcript==

{{{transcript|}}}

==People==

{{#ask: [[-Has subobject::{{FULLPAGENAME}}]]
|?Name transcribed as
|?Identified as person
|?Could be person
|mainlabel=-
}}{{#default_form:Persname}}</includeonly><noinclude>This template is used in [[Form:persname]] to display metadata about people. It has no parameters.</noinclude>

User:GavinRobinson/Named entity subobjects

2016-07-18T16:25:34Z

GavinRobinson: /* Templates, Forms and Transcripts */ link to query template

This is a demo of possible ways of using semantic tags for named entities mentioned in transcribed documents. The current version concentrates on people but if it works it could easily be extended to other types of named entity such as ships or places. You can discuss it on the talk page of this page or on talk pages of more specific pages linked to below. Everyone should feel free to edit the test pages.

==General Principles==

* Template everything. Hiding the implementation makes things easier for editors because they only have to learn templates. It's also easy to change the implementation in the future without editing every page.
* Getting the best out of Semantic MediaWiki means not having to search as much. Most users should be able to find most of what they want by clicking through a trail of wikilinks, although the trail will usually have to start with a simple search, and there will always be a need for some users to construct their own queries.
* Historical data is often uncertain. Semantic markup needs to represent uncertainty.
* TEI can help us to think more clearly about the structure and semantics of documents even if we're not using it for markup.

==Subobjects and Properties==

This approach uses subobjects to group together the following properties:

* [[Property:Name transcribed as]] text property containing the name string as transcribed in the text. This allows searching on strings marked up as names even if the person they refer to hasn't been identified.
* [[Property:Identified as person]] page property linking to a page for the person if they can be positively identified.
* [[Property:Could be person]] page property similar to above but for people whose identity isn't as certain. Allows multiple values if it could be more than one person.
* [[Property:Performs role in document]] the person's role in the document, eg deponent. Currently a text property but could be changed to a page property in future as that would allow documenting what each role means.
* [[Property:Mentioned in page]] always defaults to the page name of the page that contains the subobject. Used to hide subobjects in query results and avoid the need for an extra level of query to find the parent page.

==Templates, Forms and Transcripts==

The subobjects can be used in two different ways:

* inline markup: [[Template:persname]] can be embedded directly in transcribed text. If the person is positively identified, it creates a wikilink to their page. For example, see [[User:GavinRobinson/Test page inline]].
* semantic forms: [[Template:persname in form]] is a repeatable template that can be added to a form. It allows entering metadata about people separately from the transcribed text. For example, see [[User:GavinRobinson/Test page with form]], which uses [[Form:persname]] (which also transcludes [[Template:Get person subobjects]]).

There's plenty of room to explore and debate which approach is better. Inline is likely to be easier for readers but harder for editors, and could be inconvenient for text miners. The semantic forms approach is likely to be easier for editors but harder for readers, and fits better with current practice at Marine Lives.

==Person Pages==

These are examples of pages for people that can contain a biography, queries for other pages that mention them, and links to external sources:

* [[User:GavinRobinson/George Willingham (d. 1651), merchant]]
* [[User:GavinRobinson/David Avys]]

In future, pages like this could contain structured semantic data about people. They could contain semantic links to each other, which might be something else to think about when deciding on semantic markup of names.

==Example Query==

This inline query should return every existing person subobject that has at least a transcribed name:

{{#ask:
[[Name transcribed as::+]]
|?Mentioned in page
|?Name transcribed as
|?Identified as person
|?Could be person
|?Performs role in document
|mainlabel=-
}}

Property talk:Name transcribed as

2016-07-18T16:23:28Z

GavinRobinson: wiki getting type wrong

The wiki seems to be treating this as a page type property even though its type has always been set as text. That's making some queries and subobjects misbehave. [[Property:Performs role in document]] seemed to have a similar problem yesterday but has since gone right by itself.--[[User:GavinRobinson|GavinRobinson]] ([[User talk:GavinRobinson|talk]]) 16:23, July 18, 2016 (UTC)

Template:Persname

2016-07-18T16:14:15Z

GavinRobinson:

{{#if:{{{person_key|{{{2|}}}}}}
|{{#tag:ref|Identified as [[{{{person_key|{{{2|}}}}}}]].}}{{#subobject:
|Name transcribed as={{{transcribed_name|{{{1|}}}}}}
|Identified as person={{{person_key|{{{2}}}}}}
|Performs role in document={{{person_role|{{{4|Mentioned}}}}}}
|Mentioned in page={{FULLPAGENAME}}
}}
|{{#if:{{{possible_person_keys|{{{3|}}}}}}
|{{{transcribed_name|{{{1|}}}}}}{{#tag:ref|Could be {{#arraymap:{{{possible_person_keys|{{{3|}}}}}}|;|@@@|[[@@@]]}}.}}{{#subobject:
|Name transcribed as={{{transcribed_name|{{{1|}}}}}}
|Could be person={{{possible_person_keys|{{{3}}}}}}|+sep=;
|Performs role in document={{{person_role|{{{4|Mentioned}}}}}}
|Mentioned in page={{FULLPAGENAME}}
}}
|{{{transcribed_name|{{{1|}}}}}}{{#subobject:
|Name transcribed as={{{transcribed_name|{{{1|}}}}}}
|Performs role in document={{{person_role|{{{4|Mentioned}}}}}}
|Mentioned in page={{FULLPAGENAME}}
}}
}}}}<noinclude>This template can be embedded directly in transcribed text to mark up person names. It's named after and roughly analagous to the TEI element persName.

==Parameters==

Parameter names can be omitted if the values are entered in this order:

# '''transcribed_name''' ''required'' the person's name as transcribed from the original document. Linked to [[Property:Name transcribed as]].
# '''person_key''' ''optional'' the name of a page for the person if they can be identified. Linked to [[Property:Identified as person]].
# '''possible_person_key''' ''optional'' Names of one or more pages separated by ; for possible people if they can't be positively identified. Linked to [[Property:Could be person]].
# '''person_role''' ''optional'' A person's role in the document, such as deponent. If no value is entered, it defaults to 'Mentioned'. Linked to [[Property:Performs role in document]].

Only one of '''person_key''' and '''possible_person_key''' should be used. If you use one of them, leave the other blank.

==Example Usage==

===Unidentified person===

To mark up a string as a person's name without making any claims about who it is or what their role in the document is:

<nowiki>{{persname|John Smith}}</nowiki>

===Unidentified person with role===

To mark up a string as a deponent's name without making any claims about who it is:

<nowiki>{{persname|John Smith|||deponent}}</nowiki>

or

<nowiki>{{persname|John Smith| person_role = deponent}}</nowiki>

===Identified person===

To mark up a string as a deponent's name and link to the page for an identified person:

<nowiki>{{persname|John Smith|John Smith, merchant captain||deponent}}</nowiki>

===Multiple possibilities===

To mark up a string as a deponent's name and link to the pages for more than one person:

<nowiki>{{persname|John Smith||John Smith, merchant captain;John Smith, army officer|deponent}}</nowiki>
</noinclude>

Template:Persname

2016-07-18T16:12:47Z

GavinRobinson: moved 'identified as' wikilink to footnote to fix linebreak problem

{{#if:{{{person_key|{{{2|}}}}}}
|{{#tag:ref|Identified as [[{{{person_key|{{{2|}}}}}}|{{{transcribed_name|{{{1|}}}}}}]].}}{{#subobject:
|Name transcribed as={{{transcribed_name|{{{1|}}}}}}
|Identified as person={{{person_key|{{{2}}}}}}
|Performs role in document={{{person_role|{{{4|Mentioned}}}}}}
|Mentioned in page={{FULLPAGENAME}}
}}
|{{#if:{{{possible_person_keys|{{{3|}}}}}}
|{{{transcribed_name|{{{1|}}}}}}{{#tag:ref|Could be {{#arraymap:{{{possible_person_keys|{{{3|}}}}}}|;|@@@|[[@@@]]}}.}}{{#subobject:
|Name transcribed as={{{transcribed_name|{{{1|}}}}}}
|Could be person={{{possible_person_keys|{{{3}}}}}}|+sep=;
|Performs role in document={{{person_role|{{{4|Mentioned}}}}}}
|Mentioned in page={{FULLPAGENAME}}
}}
|{{{transcribed_name|{{{1|}}}}}}{{#subobject:
|Name transcribed as={{{transcribed_name|{{{1|}}}}}}
|Performs role in document={{{person_role|{{{4|Mentioned}}}}}}
|Mentioned in page={{FULLPAGENAME}}
}}
}}}}<noinclude>This template can be embedded directly in transcribed text to mark up person names. It's named after and roughly analagous to the TEI element persName.

==Parameters==

Parameter names can be omitted if the values are entered in this order:

# '''transcribed_name''' ''required'' the person's name as transcribed from the original document. Linked to [[Property:Name transcribed as]].
# '''person_key''' ''optional'' the name of a page for the person if they can be identified. Linked to [[Property:Identified as person]].
# '''possible_person_key''' ''optional'' Names of one or more pages separated by ; for possible people if they can't be positively identified. Linked to [[Property:Could be person]].
# '''person_role''' ''optional'' A person's role in the document, such as deponent. If no value is entered, it defaults to 'Mentioned'. Linked to [[Property:Performs role in document]].

Only one of '''person_key''' and '''possible_person_key''' should be used. If you use one of them, leave the other blank.

==Example Usage==

===Unidentified person===

To mark up a string as a person's name without making any claims about who it is or what their role in the document is:

<nowiki>{{persname|John Smith}}</nowiki>

===Unidentified person with role===

To mark up a string as a deponent's name without making any claims about who it is:

<nowiki>{{persname|John Smith|||deponent}}</nowiki>

or

<nowiki>{{persname|John Smith| person_role = deponent}}</nowiki>

===Identified person===

To mark up a string as a deponent's name and link to the page for an identified person:

<nowiki>{{persname|John Smith|John Smith, merchant captain||deponent}}</nowiki>

===Multiple possibilities===

To mark up a string as a deponent's name and link to the pages for more than one person:

<nowiki>{{persname|John Smith||John Smith, merchant captain;John Smith, army officer|deponent}}</nowiki>
</noinclude>

User:GavinRobinson/Test page inline

2016-07-18T16:10:54Z

GavinRobinson: added line breaks

This page is partly copied from Nehemiah Wharton's letters and partly made up. It demonstrates the use of [[Template:persname]] for inline semantic markup of person names.

To his much Honored Frend M[aste]r {{persname|George
Willingham|User:GavinRobinson/George Willingham (d. 1651), merchant}} at the Golden Anchor in S[ain]t Swethins Lane Marchant

this day I againe meet with {{persname|Davy your
horseman|User:GavinRobinson/David Avys}} and both horse and man are in good case
Saturday I met with your auntient maide servant {{persname|Lydea}} with her father and her brethren who all wept for joy
when they saw mee an officer in this Deseigne for the day
wee marched into Coventry the Rebels had command to pillage Anstey
the habitation of her father and Bromagam
the place of her and her husbands dwellinge both which
are but 3 miles from Coventry she hath bin maried 3 yeares

Alsoe the {{persname|earle of denbye||William Fielding, 1st Earl of Denbigh;Basil Fielding, 2nd Earl of Denbigh}} [?XXXXXXXX]

User talk:GavinRobinson/Test page with form

2016-07-17T19:10:33Z

GavinRobinson: 'edit with form' not appearing

Template:Get person subobjects

2016-07-17T15:57:46Z

GavinRobinson:

<includeonly>==People==

{{#ask: [[-Has subobject::{{FULLPAGENAME}}]]
|?Name transcribed as
|?Identified as person
|?Could be person
|mainlabel=-
}}{{#default_form:Persname}}</includeonly><noinclude>This template is used in [[Form:persname]] to display metadata about people. It has no parameters.</noinclude>

Template:Get person subobjects

2016-07-17T15:51:36Z

GavinRobinson: added default form parser function

<includeonly>==People==

{{#ask: [[-Has subobject::{{FULLPAGENAME}}]]
|?Name transcribed as
|?Identified as person
|?Could be person
|mainlabel=-
}}{{#default_form:persname}}</includeonly><noinclude>This template is used in [[Form:persname]] to display metadata about people. It has no parameters.</noinclude>

Form talk:Persname

2016-07-17T15:48:47Z

GavinRobinson: improvements

This probably still needs some improvements. It might be helpful for the role field to display a default value. I'm not sure if the inputs for identified and possible people are working as well as they could.--[[User:GavinRobinson|GavinRobinson]] ([[User talk:GavinRobinson|talk]]) 14:17, July 17, 2016 (UTC)

:Default value for role and properties for autocompleting person keys now set, which makes it a bit easier to use.--[[User:GavinRobinson|GavinRobinson]] ([[User talk:GavinRobinson|talk]]) 15:48, July 17, 2016 (UTC)

Form:Persname

2016-07-17T15:45:49Z

GavinRobinson: trying some improvements

<noinclude>
This is the "Persname" form.
To create a page with this form, enter the page name below;
if a page with that name already exists, you will be sent to a form to edit that page.

{{#forminput:form=Persname}}

</noinclude><includeonly>
<div id="wikiPreview" style="display: none; padding-bottom: 25px; margin-bottom: 25px; border-bottom: 1px solid #AAAAAA;"></div>
==Transcript==
{{{section|Transcript|level=2}}}

{{{for template|Persname in form|multiple|add button text=Add another person}}}
'''Name as transcribed:''' {{{field|transcribed_name}}}

'''Role:''' {{{field|person_role|default=Mentioned}}}

'''Identified as person:''' {{{field|person_key|property=Identified as person}}}

'''Could be person:''' {{{field|possible_person_keys|list|delimiter=;|property=Could be person}}}

{{{end template}}}

{{{for template|Get person subobjects}}}
{| class="formtable"
|}
{{{end template}}}

{{{standard input|summary}}}

{{{standard input|minor edit}}} {{{standard input|watch}}}

{{{standard input|save}}} {{{standard input|preview}}} {{{standard input|changes}}} {{{standard input|cancel}}}
</includeonly>

Template talk:Get person subobjects

2016-07-17T15:34:48Z

GavinRobinson: Created page with "It's not really best practice for a page to query itself but this was the quickest way to do it for demo purposes.--~~~~"

It's not really best practice for a page to query itself but this was the quickest way to do it for demo purposes.--[[User:GavinRobinson|GavinRobinson]] ([[User talk:GavinRobinson|talk]]) 15:34, July 17, 2016 (UTC)

Form talk:Persname

2016-07-17T14:17:55Z

GavinRobinson: possible improvements

User talk:GavinRobinson/Named entity subobjects

2016-07-17T14:14:35Z

GavinRobinson: Created page with "Some things don't look quite right in the query results but we'll see if it sorts itself out later.--~~~~"

Some things don't look quite right in the query results but we'll see if it sorts itself out later.--[[User:GavinRobinson|GavinRobinson]] ([[User talk:GavinRobinson|talk]]) 14:14, July 17, 2016 (UTC)

Template talk:Persname

2016-07-17T14:13:04Z

GavinRobinson: possible limitations

I know the source code looks horrible and is hard to read but that's just the way it is with Mediawiki template and parser function syntax. The way I've done the wikilinks might cause problems further down the line with using default forms to create redlinked pages but I haven't investigated that properly yet.--[[User:GavinRobinson|GavinRobinson]] ([[User talk:GavinRobinson|talk]]) 14:12, July 17, 2016 (UTC)

User:GavinRobinson/Test page with form

2016-07-17T14:09:05Z

GavinRobinson: Created page with "==Transcript== This page is partly copied from horse lists in SP 28/131/3 and partly made up. It demonstrates the use of Template:persname in form for adding metadata..."

==Transcript==
This page is partly copied from horse lists in [[SP 28/131/3]] and partly made up. It demonstrates the use of [[Template:persname in form]] for adding metadata about people using Semantic Forms.

==Transcript==

George Willingham of Londonstone painter stainer entred one gray horse, his rider David Avys armed with a Carbine, a case of pistolls a buffe coate and a sword

Daniell Sowton of Mountacue close in Southwarke entred one blacke roane horse, his rider armed with a Carbine a case of pistolls a buffe coate and a sword

William Pease sadler enrolled one bay horse with a starr in his forehead, his rider armed with a case of pistolls, a carbine a buffecoate and sword

{{Persname in form
|transcribed_name=George Willingham
|person_role=Mentioned
|person_key=User:GavinRobinson/George Willingham (d. 1651), merchant
}}
{{Persname in form
|transcribed_name=David Avys
|person_role=Mentioned
|person_key=User:GavinRobinson/David Avys
}}
{{Persname in form
|transcribed_name=Daniell Sowton
|person_role=Mentioned
}}
{{Persname in form
|transcribed_name=William Pease
|person_role=Mentioned
|possible_person_keys=William Pease senior;William Pease junior
}}
{{Get person subobjects}}

Form:Persname

2016-07-17T14:05:03Z

GavinRobinson: manual edits

<noinclude>
This is the "Persname" form.
To create a page with this form, enter the page name below;
if a page with that name already exists, you will be sent to a form to edit that page.

{{#forminput:form=Persname}}

</noinclude><includeonly>
<div id="wikiPreview" style="display: none; padding-bottom: 25px; margin-bottom: 25px; border-bottom: 1px solid #AAAAAA;"></div>
==Transcript==
{{{section|Transcript|level=2}}}

{{{for template|Persname in form|multiple|add button text=Add another person}}}
'''Name as transcribed:''' {{{field|transcribed_name}}}

'''Role:''' {{{field|person_role}}}

'''Identified as person:''' {{{field|person_key}}}

'''Could be person:''' {{{field|possible_person_keys|list|delimiter=;}}}

{{{end template}}}

{{{for template|Get person subobjects}}}
{| class="formtable"
|}
{{{end template}}}

{{{standard input|summary}}}

{{{standard input|minor edit}}} {{{standard input|watch}}}

{{{standard input|save}}} {{{standard input|preview}}} {{{standard input|changes}}} {{{standard input|cancel}}}
</includeonly>

Form:Persname

2016-07-17T14:01:19Z

GavinRobinson: demo form for adding metadata about people - still needs some manual edits

<noinclude>
This is the "Persname" form.
To create a page with this form, enter the page name below;
if a page with that name already exists, you will be sent to a form to edit that page.

{{#forminput:form=Persname}}

</noinclude><includeonly>
<div id="wikiPreview" style="display: none; padding-bottom: 25px; margin-bottom: 25px; border-bottom: 1px solid #AAAAAA;"></div>
==Transcript==
{{{section|Transcript|level=2}}}

{{{for template|Persname in form|multiple}}}
'''Name as transcribed:''' {{{field|transcribed_name}}}

'''Identified as person:''' {{{field|person_key}}}

'''Role:''' {{{field|person_role}}}

'''Could be person:''' {{{field|possible_person_keys}}}

{{{end template}}}

{{{for template|Get person subobjects}}}
{| class="formtable"
|}
{{{end template}}}

'''Free text:'''

{{{standard input|free text|rows=10}}}

{{{standard input|summary}}}

{{{standard input|minor edit}}} {{{standard input|watch}}}

{{{standard input|save}}} {{{standard input|preview}}} {{{standard input|changes}}} {{{standard input|cancel}}}
</includeonly>

Template:Persname in form

2016-07-17T13:57:46Z

GavinRobinson: to create person subobjects via form

<includeonly>{{#subobject:
|Name transcribed as={{{transcribed_name|}}}
|Identified as person={{{person_key|}}}
|Performs role in document={{{person_role|Mentioned}}}
|Could be person={{{possible_person_keys|}}}|+sep=;
|Mentioned in page={{FULLPAGENAME}}
}}</includeonly><noinclude>Repeatable template that creates a subobject for a person mentioned in a transcript. Designed to be used in [[Form:persname]].</noinclude>

Template:Get person subobjects

2016-07-17T13:53:53Z

GavinRobinson: to display subobject data

<includeonly>==People==

{{#ask: [[-Has subobject::{{FULLPAGENAME}}]]
|?Name transcribed as
|?Identified as person
|?Could be person
|mainlabel=-
}}</includeonly><noinclude>This template is used in [[Form:persname]] to display metadata about people. It has no parameters.</noinclude>

User:GavinRobinson/David Avys

2016-07-17T13:39:30Z

GavinRobinson: another example person page

David Avys was a parliamentarian cavalry trooper and former servant of [[User:GavinRobinson/George Willingham (d. 1651), merchant|George Willingham]].

==Pages that mention this person==

This query could and should be templated in future.

{{#ask:
[[Identified as person::{{FULLPAGENAME}}]]
|?Mentioned in page
|?Name transcribed as
|?Performs role in document
|mainlabel=-
}}

==External sources==

* [http://www.sixdegreesoffrancisbacon.com/?id=10054832 Six Degrees of Francis Bacon]

User:GavinRobinson/George Willingham (d. 1651), merchant

2016-07-17T13:36:46Z

GavinRobinson: example of a person page

George Willingham was a freeman of the London Painterstainers' Company but traded as a merchant. He lived at the Golden Anchor in St Swithin's Lane, near London Stone. In 1642 he received several letters from his former servant, Nehemiah Wharton, who was serving as a sergeant in the parliamentarian army.

==Pages that mention this person==

This query could and should be templated in future.

{{#ask:
[[Identified as person::{{FULLPAGENAME}}]]
|?Mentioned in page
|?Name transcribed as
|?Performs role in document
|mainlabel=-
}}

==External sources==

* [http://www.sixdegreesoffrancisbacon.com/?id=10054830 Six Degrees of Francis Bacon]
* [http://discovery.nationalarchives.gov.uk/details/r/D3384622 PCC will]

User:GavinRobinson/Test page inline

2016-07-17T13:32:32Z

GavinRobinson: demo of inline markup in transcript

This page is partly copied from Nehemiah Wharton's letters and partly made up. It demonstrates the use of [[Template:persname]] for inline semantic markup of person names.

To his much Honored Frend M[aste]r {{persname|George Willingham|User:GavinRobinson/George Willingham (d. 1651), merchant}} at the Golden Anchor in S[ain]t Swethins Lane Marchant

this day I againe meet with {{persname|Davy your horseman|User:GavinRobinson/David Avys}} and both horse and man are in good case Saturday I met with your auntient maide servant {{persname|Lydea}} with her father and her brethren who all wept for joy when they saw mee an officer in this Deseigne for the day wee marched into Coventry the Rebels had command to pillage Anstey the habitation of her father and Bromagam the place of her and her husbands dwellinge both which are but 3 miles from Coventry she hath bin maried 3 yeares

Alsoe the {{persname|earle of denbye||William Fielding, 1st Earl of Denbigh;Basil Fielding, 2nd Earl of Denbigh}} [?XXXXXXXX]

Template:Persname

2016-07-17T13:29:29Z

GavinRobinson: typo

{{#if:{{{person_key|{{{2|}}}}}}
|[[{{{person_key|{{{2|}}}}}}|{{{transcribed_name|{{{1|}}}}}}]]{{#subobject:
|Name transcribed as={{{transcribed_name|{{{1|}}}}}}
|Identified as person={{{person_key|{{{2}}}}}}
|Performs role in document={{{person_role|{{{4|Mentioned}}}}}}
|Mentioned in page={{FULLPAGENAME}}
}}
|{{#if:{{{possible_person_keys|{{{3|}}}}}}
|{{{transcribed_name|{{{1|}}}}}}{{#tag:ref|Could be {{#arraymap:{{{possible_person_keys|{{{3|}}}}}}|;|@@@|[[@@@]]}}.}}{{#subobject:
|Name transcribed as={{{transcribed_name|{{{1|}}}}}}
|Could be person={{{possible_person_keys|{{{3}}}}}}|+sep=;
|Performs role in document={{{person_role|{{{4|Mentioned}}}}}}
|Mentioned in page={{FULLPAGENAME}}
}}
|{{{transcribed_name|{{{1|}}}}}}{{#subobject:
|Name transcribed as={{{transcribed_name|{{{1|}}}}}}
|Performs role in document={{{person_role|{{{4|Mentioned}}}}}}
|Mentioned in page={{FULLPAGENAME}}
}}
}}}}<noinclude>This template can be embedded directly in transcribed text to mark up person names. It's named after and roughly analagous to the TEI element persName.

==Parameters==

Parameter names can be omitted if the values are entered in this order:

# '''transcribed_name''' ''required'' the person's name as transcribed from the original document. Linked to [[Property:Name transcribed as]].
# '''person_key''' ''optional'' the name of a page for the person if they can be identified. Linked to [[Property:Identified as person]].
# '''possible_person_key''' ''optional'' Names of one or more pages separated by ; for possible people if they can't be positively identified. Linked to [[Property:Could be person]].
# '''person_role''' ''optional'' A person's role in the document, such as deponent. If no value is entered, it defaults to 'Mentioned'. Linked to [[Property:Performs role in document]].

Only one of '''person_key''' and '''possible_person_key''' should be used. If you use one of them, leave the other blank.

==Example Usage==

===Unidentified person===

To mark up a string as a person's name without making any claims about who it is or what their role in the document is:

<nowiki>{{persname|John Smith}}</nowiki>

===Unidentified person with role===

To mark up a string as a deponent's name without making any claims about who it is:

<nowiki>{{persname|John Smith|||deponent}}</nowiki>

or

<nowiki>{{persname|John Smith| person_role = deponent}}</nowiki>

===Identified person===

To mark up a string as a deponent's name and link to the page for an identified person:

<nowiki>{{persname|John Smith|John Smith, merchant captain||deponent}}</nowiki>

===Multiple possibilities===

To mark up a string as a deponent's name and link to the pages for more than one person:

<nowiki>{{persname|John Smith||John Smith, merchant captain;John Smith, army officer|deponent}}</nowiki>
</noinclude>

Template:Persname

2016-07-17T13:28:58Z

GavinRobinson: template for inline markup of person names

{{#if:{{{person_key|{{{2|}}}}}}
|[[{{{person_key|{{{2|}}}}}}|{{{transcribed_name|{{{1|}}}}}}]]{{#subobject:
|Name transcribed as={{{transcribed_name|{{{1|}}}}}}
|Identified as person={{{person_key|{{{2}}}}}}
|Performs role in document={{{person_role|{{{4|Mentioned}}}}}}
|Mentioned in page={{FULLPAGENAME}}
}}
|{{#if:{{{possible_person_keys|{{{3|}}}}}}
|{{{transcribed_name|{{{1|}}}}}}{{#tag:ref|Could be {{#arraymap:{{{possible_person_keys|{{{3|}}}}}}|;|@@@|[[@@@]]}}.}}{{#subobject:
|Name transcribed as={{{transcribed_name|{{{1|}}}}}}
|Could be person={{{possible_person_keys|{{{3}}}}}}|+sep=;
|Performs role in document={{{person_role|{{{4|Mentioned}}}}}}
|Mentioned in page={{FULLPAGENAME}}
}}
|{{{transcribed_name|{{{1|}}}}}}{{#subobject:
|Name transcribed as={{{transcribed_name|{{{1|}}}}}}
|Performs role in document={{{person_role|{{{4|Mentioned}}}}}}
|Mentioned in page={{FULLPAGENAME}}
}}
}}}}<noinclude>This template can be embedded directly in transcribed text to markup up person names. It's named after and roughly analagous to the TEI element persName.

==Parameters==

Parameter names can be omitted if the values are entered in this order:

# '''transcribed_name''' ''required'' the person's name as transcribed from the original document. Linked to [[Property:Name transcribed as]].
# '''person_key''' ''optional'' the name of a page for the person if they can be identified. Linked to [[Property:Identified as person]].
# '''possible_person_key''' ''optional'' Names of one or more pages separated by ; for possible people if they can't be positively identified. Linked to [[Property:Could be person]].
# '''person_role''' ''optional'' A person's role in the document, such as deponent. If no value is entered, it defaults to 'Mentioned'. Linked to [[Property:Performs role in document]].

Only one of '''person_key''' and '''possible_person_key''' should be used. If you use one of them, leave the other blank.

==Example Usage==

===Unidentified person===

To mark up a string as a person's name without making any claims about who it is or what their role in the document is:

<nowiki>{{persname|John Smith}}</nowiki>

===Unidentified person with role===

To mark up a string as a deponent's name without making any claims about who it is:

<nowiki>{{persname|John Smith|||deponent}}</nowiki>

or

<nowiki>{{persname|John Smith| person_role = deponent}}</nowiki>

===Identified person===

To mark up a string as a deponent's name and link to the page for an identified person:

<nowiki>{{persname|John Smith|John Smith, merchant captain||deponent}}</nowiki>

===Multiple possibilities===

To mark up a string as a deponent's name and link to the pages for more than one person:

<nowiki>{{persname|John Smith||John Smith, merchant captain;John Smith, army officer|deponent}}</nowiki>
</noinclude>

Property:Mentioned in page

2016-07-17T13:26:29Z

GavinRobinson: documentation

This is a property of type [[Has type::Page]]. The name of a page that a person is mentioned in. Used to hide subobjects in query results and avoid the need for an extra level of query to find the parent page.

Property:Mentioned in page

2016-07-17T13:25:36Z

GavinRobinson: Created a property of type Has type::Page

This is a property of type [[Has type::Page]].

Property:Performs role in document

2016-07-17T13:25:13Z

GavinRobinson: documentation

This is a property of type [[Has type::Text]]. The role that someone performs in a transcribed document, such as deponent.

Property:Performs role in document

2016-07-17T13:24:37Z

GavinRobinson: Created a property of type Has type::Text

This is a property of type [[Has type::Text]].

Property:Could be person

2016-07-17T13:24:08Z

GavinRobinson: documentation

This is a property of type [[Has type::Page]]. It links to pages for people mentioned in transcripts if they can't be positively identified but there are one or more possibilities.

Property:Could be person

2016-07-17T13:23:13Z

GavinRobinson: Created a property of type Has type::Page

This is a property of type [[Has type::Page]].

Property:Identified as person

2016-07-17T13:22:48Z

GavinRobinson: documentation

This is a property of type [[Has type::Page]]. Links to a page for a person mentioned in a transcript if they can be positively identified.

Property:Identified as person

2016-07-17T13:22:01Z

GavinRobinson: Created a property of type Has type::Page

This is a property of type [[Has type::Page]].

Property:Name transcribed as

2016-07-17T13:21:26Z

GavinRobinson: documentation

This is a property of type [[Has type::Text]]. Contains a person name string as transcribed in the text. This allows searching on strings marked up as names even if the person they refer to hasn't been identified.

Property:Name transcribed as

2016-07-17T13:20:32Z

GavinRobinson: Created a property of type Has type::Text

This is a property of type [[Has type::Text]].

User:GavinRobinson/Named entity subobjects

2016-07-17T13:18:34Z

GavinRobinson: overview of demo

This is a demo of possible ways of using semantic tags for named entities mentioned in transcribed documents. The current version concentrates on people but if it works it could easily be extended to other types of named entity such as ships or places. You can discuss it on the talk page of this page or on talk pages of more specific pages linked to below. Everyone should feel free to edit the test pages.

==General Principles==

* Template everything. Hiding the implementation makes things easier for editors because they only have to learn templates. It's also easy to change the implementation in the future without editing every page.
* Getting the best out of Semantic MediaWiki means not having to search as much. Most users should be able to find most of what they want by clicking through a trail of wikilinks, although the trail will usually have to start with a simple search, and there will always be a need for some users to construct their own queries.
* Historical data is often uncertain. Semantic markup needs to represent uncertainty.
* TEI can help us to think more clearly about the structure and semantics of documents even if we're not using it for markup.

==Subobjects and Properties==

This approach uses subobjects to group together the following properties:

* [[Property:Name transcribed as]] text property containing the name string as transcribed in the text. This allows searching on strings marked up as names even if the person they refer to hasn't been identified.
* [[Property:Identified as person]] page property linking to a page for the person if they can be positively identified.
* [[Property:Could be person]] page property similar to above but for people whose identity isn't as certain. Allows multiple values if it could be more than one person.
* [[Property:Performs role in document]] the person's role in the document, eg deponent. Currently a text property but could be changed to a page property in future as that would allow documenting what each role means.
* [[Property:Mentioned in page]] always defaults to the page name of the page that contains the subobject. Used to hide subobjects in query results and avoid the need for an extra level of query to find the parent page.

==Templates, Forms and Transcripts==

The subobjects can be used in two different ways:

* inline markup: [[Template:persname]] can be embedded directly in transcribed text. If the person is positively identified, it creates a wikilink to their page. For example, see [[User:GavinRobinson/Test page inline]].
* semantic forms: [[Template:persname in form]] is a repeatable template that can be added to a form. It allows entering metadata about people separately from the transcribed text. For example, see [[User:GavinRobinson/Test page with form]], which uses [[Form:persname]].

There's plenty of room to explore and debate which approach is better. Inline is likely to be easier for readers but harder for editors, and could be inconvenient for text miners. The semantic forms approach is likely to be easier for editors but harder for readers, and fits better with current practice at Marine Lives.

==Person Pages==

These are examples of pages for people that can contain a biography, queries for other pages that mention them, and links to external sources:

* [[User:GavinRobinson/George Willingham (d. 1651), merchant]]
* [[User:GavinRobinson/David Avys]]

In future, pages like this could contain structured semantic data about people. They could contain semantic links to each other, which might be something else to think about when deciding on semantic markup of names.

==Example Query==

This inline query should return every existing person subobject that has at least a transcribed name:

{{#ask:
[[Name transcribed as::+]]
|?Mentioned in page
|?Name transcribed as
|?Identified as person
|?Could be person
|?Performs role in document
|mainlabel=-
}}

User:GavinRobinson

2016-07-17T13:15:37Z

GavinRobinson: red links for demo pages

'''Dr Gavin Robinson''' is a professional palaeographer and director of [http://www.differenthand.ltd.uk Different Hand Ltd]. He gained his PhD from Reading University in 2001, and has since published on horse supply, cavalry tactics and allegiance in the English Civil War.<ref>'Horse Supply and the Development of the New Model Army', ''War in History'', 15 (2008), 121-41; 'Equine Battering Rams? A Reassessment of Cavalry Charges in the English Civil War' ''Journal of Military History'' 75/3 (2011), 719-31; ''Horses, People and Parliament in the English Civil War: Extracting Resources and Constructing Allegiance'' (Ashgate, 2012).</ref> He was a community moderator at Your Archives, and used to blog at [http://www.investigationsofadog.co.uk/ Investigations of a Dog].

==Test pages==

* [[/Named entity subobjects]]
* [[/Test page inline]]
* [[/Test page with form]]
* [[/George Willingham (d. 1651), merchant]]
* [[/David Avys]]

SP 28/131/4 f.10r Annotate

2015-07-19T17:17:00Z

GavinRobinson: created manually to even out folio images

{{PageMetaData
|Parent volume=SP 28/131/4
|Folio=10
|Side=Recto
|Status=Transcribed; requires image
|First transcriber=Gavin Robinson
|First transcribed=2015/07/19
}}
{{PageHelp}}
{{PageTranscription
|Transcription image={{#transcription-image: }}
|Transcription=2. die Novembris 1642. by the Comissaries [CENTRE HEADING]

Thomas Crosse of Deddome in Essex Listed one white Nagg with sadle and bridle

5-10-00

George Cole of the same Clothier, Listed one Croppeard browne bay Nagg blinde of one Eye with sadle and bridle

5-00-00

John Ricks of the same Clothier Listed one browne bay Mare with bridle and sadle

5-00-00

Nathaniell Backler of the same Clothier listed one bay Mare with a blaze with bridle and sadle

6-00-00

Thomas Heckford of the same Clothier listed one gray Guelding with sadle and bridle

7-00-00

Edward fforman of The same Tanner, Listed one browne Nagg with a sadle and bridle

4-10-00

Edmond Sherman of the same Clothier listed one blacke Guelding with sadle and bridle

8-00-00

Richard Sherman of the same Clothier Listed one bay Guelding with sadle and bridle

7-00-00

John Price of the same Haberdasher Listed one bay bald Nagg with two white feete

5-00-00

Alexander Somer Draper listed one black Mare bare

3-00-00

Mathew Bridges gent listed one gray Mare with wall Eyes one white Nagg and one black Nagg with a starr

16-00-00

Joseph Vaughan Goldsmith Listed one grissell bay Nagg with a bald face and three white feete, sadle and bridle

4-10-00

John Charles Brewer Listed one gray horse, and one black Nagg, with one sadle and bridle

8-00-00

John Wood Clothier, listed one black Nagg with sadle and bridle

4-00-00

John Hale of Towlesunt Darsie Clerke listed one browne spaid Mare bare

3-00-00

William Stacye yeoman listed one Iron gray Guelding

5-00-00

Robert ffoscett Haberdasher listed one white Mare

3-10-00

George Tharpe listed one white fleabitten guelding and one bay Mare

7-00-00

William Blacke of the old Jury Barber Chirurgion listed one blacke Guelding with sadle and bridle

4-10-00

Nathaniell Warde of Sackwell in Essex Clerke, listed one bay guelding with a starr with sadle and bridle

5-00-00

Thomas Massie Girdler listed one bay guelding sadle and bridle

5-00-00

Daniell Sherman of Deddome Clothier, Listed one sorrell Guelding with sadle and bridle

5-00-00
}}

SP 28/131/5

2015-07-19T11:49:04Z

GavinRobinson: volume info

{{Volume
|Start date=October 11, 1642
|End date=July 4, 1643
|Volume information=Account book listing cavalry horses and arms subscribed for the London Militia under the system known as the Propositions. This is a fair copy compiled by the commissaries John Smith and Thomas Richardson, and submitted to the Committee for Taking Accounts of the Whole Kingdom on 26 April 1644. The horses were probably all listed directly with Smith and Richardson in London.

At best the entries give:

* commander of the troop that received the horse (usually given in the left margin)
* subscriber's name, address and occupation or status
* a description of the horse
* the rider's name
* a list of arms and equipment
* the value of the horse and arms

Many entries omit some of these details.

[[SP 28/131/5 f.18r Annotate|Folio 18r]] gives the total number of horses listed in the book as 459, and gives the totals issued to each troop.
}}
Indexes of this volume: {{#ask:
[[indexes volume::{{PAGENAME}}]]
}}

SP 28/131/3

2015-07-19T11:46:56Z

GavinRobinson: note on original index

{{Volume
|Start date=June 21, 1642
|End date=June 10, 1643
|Volume information=Account book listing cavalry horses and arms subscribed for the parliamentary army under the system known as the Propositions. This is a fair copy compiled by the commissaries John Smith and Thomas Richardson from several original account books that no longer survive. Folios [[SP 28/131/3 f.43r Annotate|43r]], [[SP 28/131/3 f.49r Annotate|49r]], [[SP 28/131/3 f.91v Annotate|91v]] and [[SP 28/131/3 f.132r Annotate|132r]] note where some of the original books began and ended. This copy was submitted to the Committee for Taking Accounts of the Whole Kingdom on 26 April 1644.

Many of the horses were probably listed directly with Smith and Richardson in London, but the book also includes some lists compiled by local commissaries outside London:

* Thomas Westall and Thomas Sanders in Buckinghamshire, August 1642, starts on [[SP 28/131/3 f.49v Annotate|f.49v]]
* William Singleton and Thomas Pury in Gloucester, September 1642, starts on [[SP 28/131/3 f.99r Annotate|f.99r]]
* John Luchocke, George Blunt and Anthony Leycester in Oxfordshire, October 1642, starts on [[SP 28/131/3 f.121r Annotate|f.121r]]

Geographical patterns in the lists, such as large clusters in Essex in August and September 1642, could suggest that other local lists have been silently merged with the main account.

At best the entries give:

* subscriber's name, address and occupation or status
* a description of the horse
* the rider's name
* a list of arms and equipment
* the value of the horse and arms

Many entries omit some of these details. Some horses came without arms, and many came without riders.

The account does not include any record of which units received the horses. [[SP 28/131/3 f.132r Annotate|Folio 132r]] gives the total number of horses listed in this book as 3,757.

The manuscript includes an original index of people which has not been included in these transcripts.
}}

SP 28/131/4

2015-07-19T11:46:11Z

GavinRobinson: volume info

{{Volume
|Start date=October 5, 1642
|End date=July 6, 1643
|Volume information=Account book listing dragoon and draught horses and equipment subscribed for the Earl of Essex's parliamentary army under the system known as the Propositions. This is a fair copy compiled by the commissaries John Smith and Thomas Richardson from several original accounts that no longer survive. This copy was submitted to the Committee for Taking Accounts of the Whole Kingdom on 26 April 1644.

A contemporary note on [[SP 28/131/4 f.1r Annotate|f.1r]] states that most of the horses were listed in the counties by deputy lieutenants and then sent up to London along with the lists. Many of these original lists have been silently merged into the main account and can only be deduced from clusters of place names, but some are clearly separated and the local commissaries identified:

* Mayor of Colchester, Essex, 1 November 1642, starts [[SP 28/131/4 f.8r Annotate|f.8r]]
* Mayor and Aldermen of Boston, Lincolnshire, 7 November 1642, starts [[SP 28/131/4 f.20v Annotate|f.20v]]
* Suffolk, November 1642, starts [[SP 28/131/4 f.35r Annotate|f.35r]]
* Daniel Marvell and John Gray in Watford, Hertfordshire, November 1642, starts [[SP 28/131/4 f.43r Annotate|f.43r]]

Most of these horses came with no riders and very little equipment. At best the entries give:

* subscriber's name, address and occupation or status
* a description of the horse
* a list of equipment
* the value of the horse and equipment

Many entries omit some of these details. Sometimes wagons are carts are listed with horses, or separately.

[[SP 28/131/4 f.53r Annotate|Folio 53r]] gives the total number of horses listed in the book as 2,488.

The manuscript includes an original index of people which has not been included in these transcripts.
}}

SP 28/131/3

2015-07-19T11:42:54Z

GavinRobinson: volume info

Talk:SP 28/131/5

2015-07-17T19:02:57Z

GavinRobinson: fixed problem by refreshing pages

I've manually added a query to the source of this page just to test it. In future it could be added to [[Template:Volume]] so that every volume automatically gets a list of any indexes that cover that volume.--[[User:GavinRobinson|GavinRobinson]] ([[User talk:GavinRobinson|talk]]) 16:11, July 17, 2015 (UTC)

That's interesting, let's discuss that with [[User:RowanBeentje|RowanBeentje]].--[[User:ColinGreenstreet|ColinGreenstreet]] 16:58, July 17, 2015 (UTC)

: An odd thing is that some of the indexes that point here are showing up in the query results but some aren't. It could just be that some things haven't gone through the job queue yet.--[[User:GavinRobinson|GavinRobinson]] ([[User talk:GavinRobinson|talk]]) 17:40, July 17, 2015 (UTC)

:: I've fixed it by refreshing the index pages then refreshing the volume page. I think they're all there now.--[[User:GavinRobinson|GavinRobinson]] ([[User talk:GavinRobinson|talk]]) 19:02, July 17, 2015 (UTC)

Talk:SP 28/131/5

2015-07-17T17:40:45Z

GavinRobinson: some indexes not in query results yet

Talk:SP 28/131/5

2015-07-17T16:12:43Z

GavinRobinson: about semantic query for indexes