Difference between revisions of "Tools: Semantic Queries"

From MarineLives
Jump to: navigation, search
(Queryable fields on a Form based Page)
(Queryable fields on a Form based Page)
 
(18 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
__TOC__
 +
----
 
==Queryable fields on a Form based Page==
 
==Queryable fields on a Form based Page==
  
[[File:Form Page.PNG|600px|thumb|left|Creating a new form based page]]
+
[[File:Form Page.PNG|600px|thumb|right|[[Form:Page|Creating a new form based page]]]]
  
 
The great majority of MarineLives wiki pages are structured as form based Pages, which are grouped into Volumes.
 
The great majority of MarineLives wiki pages are structured as form based Pages, which are grouped into Volumes.
Line 11: Line 13:
 
All these pre-defined fields are queryable using Special:Ask semantic queries.
 
All these pre-defined fields are queryable using Special:Ask semantic queries.
  
The pre-defined fields are as follows:
+
<u>The pre-defined fields are as follows:</u>
  
 
'''Parent volume'''
 
'''Parent volume'''
Line 33: Line 35:
 
'''Suggested links'''
 
'''Suggested links'''
  
[[File:Floatboxes HCA1371f440r 27062016.PNG|400px|thumb|left|Pre-defined fields in metadata and contents floating boxes can be interrogated using Special:Ask semantic queries]]
+
[[File:Floatboxes HCA1371f440r 27062016.PNG|400px|thumb|right|Pre-defined fields in metadata and contents floating boxes can be interrogated using Special:Ask semantic queries. Example from [[HCA 13/71 f.400r Annotate|HCA 13/71 f.400r]]]]
  
[[File:Box HCA1371f400r 27062016.PNG|400px|thumb|right|Creating a new form based page]]
+
<u>The pre-defined fields are used as follows:</u>
  
The predefined fields can be found in the floating metadata box on each form based page
+
'''Parent volume''' (Groups pages with assigned folio numbers and sides into volumes. A MarineLives wiki usually matches an archival volume; occasionally MarineLives editors have created "artificial" volumes to loose documents in a logical manner
 +
'''Folio''' (Follows the folio markings on the physical document where present; where no folio markings exist, MarineLives editors have created sequential artifical folio markings to allow navigation through a volume)
 +
'''Side''' (Side can be recto or verso. MarineLives wiki functionality automatically creates navigational links on wiki pages allowing users to move to "next page" amd to "previous page")
 +
'''Status''' (Status is used to record the uploading of images and when first transcribed)
 +
'''First transcriber''' (Full name of the first transcriber of a specific page)
 +
'''First transcribed''' (Date of first transcription of a specific page; uses U.S. date format: YEAR/MONTH/DAY)
 +
'''Editorial history''' (Brief notes with names of editors and dates of major edits)
 +
'''Note''' (Currently used to record the MarineLives image number)
 +
'''Transcription image''' (Used to record the MarineLives image number)
 +
'''Transcription''' (Field on page which contains the transcription)
 +
'''Language''' (Specifies the language of the transcription; this field can be filled in as "Dutch", "English", "French", "Latin", "Spanish", or "Swedish"; the vast majority of our transcriptions are in English of original English language documents; we are increasingly adding foreign language documents in Dutch, German, Latin, and Spanish)
 +
'''English translation''' (This field contains the English translation of a non-English original document; to date few transcriptions of non-English original documents have been translated into English)
 +
'''People''' (This field contains annotations of the transcription on the same page concerning people named on the page)
 +
'''Places''' (This field contains annotations of the transcription on the same page concerning places named on the page)
 +
'''Ships''' (This field contains annotations of the transcription on the same page concerning ships named on the page)
 +
'''Materials''' (This field contains annotations of the transcription on the same page concerning materials named on the page)
 +
'''Primary sources''' (This field list primary sources of relevance to the transcription on the same page)
 +
'''Secondary sources''' (This field list secondary sources of relevance to the transcription on the same page)
 +
'''Suggested links''' (This field list suggested links of relevance to the transcription on the same page)
  
In the case of the page [[HCA 13/71 f.400r Annotate|HCA 13/71 f.400r annotate]] ten of the potential nineteen predefined fields contain data and are therefore cisible in the metadata and contents floating boxes in the top right hand corner of the page
+
[[File:Box HCA1371f400r 27062016.PNG|200px|thumb|right|Floating metadata and contents boxes in the top right hand corner of every form based page. Example from [[HCA 13/71 f.400r Annotate|HCA 13/71 f.400r]]]]
  
 +
The predefined fields can be found in the floating metadata and contents boxes in the top right hand corner of each form based page
  
----
+
In the case of the page [[HCA 13/71 f.400r Annotate|HCA 13/71 f.400r annotate]] ten of the potential nineteen predefined fields contain data and are therefore visible in the metadata and contents floating boxes in the top right hand corner of the page.
  
==Spacial:Ask Semantic Query input strings==
+
No data has been entered for Language, English translation, People, Places, Ships, Materials, Primary Sources, Secondary Sources, and Suggested Links
 
+
The following semantic query input strings are useful when working with the MarineLives wiki
+
  
 
----
 
----
===Administrative queries===
 
  
<u>Listing all pages in Form:Page format which have Untranscribed in the First transcriber box</u>
+
==Using Special:Ask Semantic Query to find non-English documents==
  
[[File:Untranscribed Query String 27062016.PNG|600px|thumb|left|Query string to display all untrancribed form based pages]]
+
[[File:Semantic Search Languages 28062016.PNG|900px|thumb|left|Using Special:Ask semantic query to identify non-English language documents in MarineLives wiki]]
  
 
----
 
----
  
<u>Listing all volumes in Form:Volume format, with Start date and End dates (where dates have been entered)</u>
+
==Special:Ask Administrative and Wild Card queries==
  
[[File:All Volumes Start End Dates 27062016.PNG|600px|thumb|left|Query string to display all volumes with start and end dates]]
+
The following semantic query input strings are useful when working with the MarineLives wiki
  
 +
[[File:Semantic Admin Queries 28062016.PNG|700px|thumb|left|Useful administrative semantic queries and wild card]]
  
 
----
 
----
 
==Semantic Query Outputs==
 
----
 
===Example===
 
 
 
----
 
===Semantic query to display all pages transcribed in calendar year 2014===
 
 
====Using the MarineLives Special Ask Query page====
 
 
Go to [http://www.marinelives.org/wiki/Special:Ask MarineLives Special Ask page]
 
 
Input into MarineLives Special Ask Query page the Query string: [[Category:Pages]] [[First transcribed::>14/01/01]] [[First transcribed::<14/12/31]]
 
 
Click on "Find results"
 
 
Output will be displayed in a results table
 
 
----
 
 
====Embedding a Special Ask Query in a MarineLives wiki page====
 
 
The same Query string used in the Special Ask Query page can be embedded in a MarineLives wiki page with the addition of some further code.
 
 
The following code, when embedded in a MarineLives wiki page, will display the same results table as produced in the above example
 
 
[[File:Semantic Query Display Pages 2014.PNG|600px|thumb|left|Semantic query to display all pages transcribed in calendar year 2014]]
 
 
{{#ask:[[Category:Pages]][[First transcribed::>14/01/01]][[First transcribed::<14/12/31]]
 
| format=ul
 
| ?First transcribed
 
}}
 

Latest revision as of 16:12, June 28, 2016




Queryable fields on a Form based Page


The great majority of MarineLives wiki pages are structured as form based Pages, which are grouped into Volumes.

Wiki users with editorial privileges can create new pages and new volumes using the appropriate buttons in the vertical sidebar.

Form based pages contain a number of standard fields as defined by the form.

All these pre-defined fields are queryable using Special:Ask semantic queries.

The pre-defined fields are as follows:

Parent volume
Folio
Side
Status
First transcriber
First transcribed
Editorial history
Note
Transcription image
Transcription
Language
English translation
People
Places
Ships
Materials
Primary sources
Secondary sources
Suggested links

Pre-defined fields in metadata and contents floating boxes can be interrogated using Special:Ask semantic queries. Example from HCA 13/71 f.400r

The pre-defined fields are used as follows:

Parent volume (Groups pages with assigned folio numbers and sides into volumes. A MarineLives wiki usually matches an archival volume; occasionally MarineLives editors have created "artificial" volumes to loose documents in a logical manner
Folio (Follows the folio markings on the physical document where present; where no folio markings exist, MarineLives editors have created sequential artifical folio markings to allow navigation through a volume)
Side (Side can be recto or verso. MarineLives wiki functionality automatically creates navigational links on wiki pages allowing users to move to "next page" amd to "previous page")
Status (Status is used to record the uploading of images and when first transcribed)
First transcriber (Full name of the first transcriber of a specific page)
First transcribed (Date of first transcription of a specific page; uses U.S. date format: YEAR/MONTH/DAY)
Editorial history (Brief notes with names of editors and dates of major edits)
Note (Currently used to record the MarineLives image number)
Transcription image (Used to record the MarineLives image number)
Transcription (Field on page which contains the transcription)
Language (Specifies the language of the transcription; this field can be filled in as "Dutch", "English", "French", "Latin", "Spanish", or "Swedish"; the vast majority of our transcriptions are in English of original English language documents; we are increasingly adding foreign language documents in Dutch, German, Latin, and Spanish)
English translation (This field contains the English translation of a non-English original document; to date few transcriptions of non-English original documents have been translated into English)
People (This field contains annotations of the transcription on the same page concerning people named on the page)
Places (This field contains annotations of the transcription on the same page concerning places named on the page)
Ships (This field contains annotations of the transcription on the same page concerning ships named on the page)
Materials (This field contains annotations of the transcription on the same page concerning materials named on the page)
Primary sources (This field list primary sources of relevance to the transcription on the same page)
Secondary sources (This field list secondary sources of relevance to the transcription on the same page)
Suggested links (This field list suggested links of relevance to the transcription on the same page)

Floating metadata and contents boxes in the top right hand corner of every form based page. Example from HCA 13/71 f.400r

The predefined fields can be found in the floating metadata and contents boxes in the top right hand corner of each form based page

In the case of the page HCA 13/71 f.400r annotate ten of the potential nineteen predefined fields contain data and are therefore visible in the metadata and contents floating boxes in the top right hand corner of the page.

No data has been entered for Language, English translation, People, Places, Ships, Materials, Primary Sources, Secondary Sources, and Suggested Links


Using Special:Ask Semantic Query to find non-English documents


Using Special:Ask semantic query to identify non-English language documents in MarineLives wiki

Special:Ask Administrative and Wild Card queries


The following semantic query input strings are useful when working with the MarineLives wiki

Useful administrative semantic queries and wild card