Template:FSHI/doc: Difference between revisions

From FamilySearch Wiki
VisualWikitext
No edit summary
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
== Purpose ==
== Purpose ==
This template will allow the creation of links to specific images in FamilySearch Historical Images ("Images").
This template will allow the creation of links to specific images in acquired via Infinity and published as FamilySearch Images/ Explore Historical Images/ Explore Images.
=== Parameters ===
=== Parameters ===
I think this template will need 4 parameters:
This template has 4 parameters:
{| class="wikitable"
{| class="wikitable"
|-
|-
! # !! URL value !! usage !! Parameter Name
! Parameter !! Value !! Display
|-
|-
| 1 || imageGroupNumbers= || DGS only || DGS
| DGS || DGS number || DGS number
|-
|-
| 2 || rmsId= || itemized in RMS ||item
| ID || rmsID || none
|-
|-
| 3 || null || display item number || nr
| Image || Image number || Image number
|-
|-
| 4 || imageIndex=  || specific image (starting with 1) || image
| Item || Item number || Item
|}
|}
=== Results Display ===
 
How the results are displayed is dependent on what parameters are provided.
=== Operation ===
{| class="wikitable"
{| class="wikitable"
|-
|-
! Condition !! DGS Parameter !! item Parameter !! nr Parameter !! image Parameter !! Display || Result
! Condition !! DGS<br>Parameter !! ID<br>Parameter !! Image<br>Parameter !! Item<br>Parameter !! Sample Code !! Display !! Result
|-
| Only DGS number is given || 8417008 ||  ||  ||  || DGS 8417008 || Link goes to list of folder content
|-
|-
| DGS & item number given || 8417008 || M9DP-VQB || 2 || || DGS 8417008 item 2 || Link goes to 2nd item in folder
| Only DGS number is given || 8417088 ||  ||  || || <nowiki>{{FSHI|DGS=8417008}}</nowiki> || {{FSHI|DGS=8417008}} || Link goes to list of folder content
|-
|-
| DGS, item number & image number || 8417008 || M9DP-VQB ||  || 6 || DGS 8417008 image #6 || Link goes to specific image in folder
| DGS, ID, and Image given || 8417088 || M9DP-VQB || 6 ||  || <nowiki>{{FSHI|DGS=8417088|ID=M9DP-VQB|Image=6}}</nowiki> || {{FSHI|DGS=8417088|ID=M9DP-VQB|Image=6}} || Link goes to specific image in folder
|-
|-
| DGS, ID, and Item given || 8417008 || M9DP-VQB || || 2 || <nowiki>{{FSHI|DGS=8417088|ID=M9DP-VQB|Item=2}}</nowiki> || {{FSHI|DGS=8417088|ID=M9DP-VQB|Item=2}} || Link goes to specific item in folder
|}
|}
'''Note:''' The template will not work correctly if the ID parameter (rmsID) is not provided along with either the Image or Item parameter.


== Operation ==
== Operation ==
Line 36: Line 37:
#If all four parameters are present it should return a string as in #3 below.
#If all four parameters are present it should return a string as in #3 below.


Sample input and output:
Sample input:
<pre>
<pre>
#1 {{FSHI|DGS=8417008}}
#1 {{FSHI|DGS=8417008}}
#2 {{FSHI|DGS=8417008 |item=M9DP-VQB |nr=2}}
#2 {{FSHI|DGS=8417008 |iD=M9DP-VQB |Item=2}}
#3 {{FSHI|DGS=8417008 |item=M9DP-VQY |image=6}}
#3 {{FSHI|DGS=8417008 |iD=M9DP-VQY |image=6}}
</pre>
</pre>
Expected output:
Expected output:
Line 53: Line 54:
| #3 || DGS 8417008 image# 6 || https://www.familysearch.org/records/images/image-details?imageGroupNumbers=8417008&page=1&rmsId=M9DP-VQY&imageIndex=6&singleView=true
| #3 || DGS 8417008 image# 6 || https://www.familysearch.org/records/images/image-details?imageGroupNumbers=8417008&page=1&rmsId=M9DP-VQY&imageIndex=6&singleView=true
|}
|}
=== Testing Data ===
1. This URL is for the first image in a folder
<pre>
https://www.familysearch.org/records/images/search-results?imageGroupNumbers=8417008&page=1
</pre>
2. These results are for each item in a folder. In the the URL string '''search-results''' is replaced with '''image-details''' and the text '''rmsId=M9DP-VQY&imageIndex=0''' is appended, where ''M9DP-VQY'' represents a unique value for that item.
<pre>
https://www.familysearch.org/records/images/image-details?imageGroupNumbers=8417008&page=1&rmsId=M9DP-VQY&imageIndex=0
https://www.familysearch.org/records/images/image-details?imageGroupNumbers=8417008&page=1&rmsId=M9DP-VQB&imageIndex=0
https://www.familysearch.org/records/images/image-details?imageGroupNumbers=8417008&page=1&rmsId=M9DP-V79&imageIndex=0
https://www.familysearch.org/records/images/image-details?imageGroupNumbers=8417008&page=1&rmsId=M9DP-V7M&imageIndex=0
https://www.familysearch.org/records/images/image-details?imageGroupNumbers=8417008&page=1&rmsId=M9DP-VQR&imageIndex=0
https://www.familysearch.org/records/images/image-details?imageGroupNumbers=8417008&page=1&rmsId=M9DP-VQT&imageIndex=0
https://www.familysearch.org/records/images/image-details?imageGroupNumbers=8417008&page=1&rmsId=M9DP-VQ1&imageIndex=0
</pre>
3. These are for specific images in a folder. This is the same URL string as that for an item, but the numeric value at the end of the string is replaced by the specific image number and the string '''&singleView=true'''.
<pre>
https://www.familysearch.org/records/images/search-results?imageGroupNumbers=8417007&page=1
https://www.familysearch.org/records/images/image-details?imageGroupNumbers=8417007&page=1&rmsId=TH-909-80444-120928-39&imageIndex=6&singleView=true
https://www.familysearch.org/records/images/image-details?imageGroupNumbers=8417007&page=1&rmsId=TH-909-80444-120928-39&imageIndex=21&singleView=true
</pre>
More samples using the same DGS showing 1) the URL for the DGS, 2) the first item on the DGS, and 3) a specific image on the DGS.
<pre>
1. https://www.familysearch.org/records/images/search-results?imageGroupNumbers=102152121
2. https://www.familysearch.org/records/images/image-details?imageGroupNumbers=102152121&rmsId=TH-909-60368-30634-8&imageIndex=0
3. https://www.familysearch.org/records/images/image-details?imageGroupNumbers=102152121&rmsId=TH-909-60368-30634-8&imageIndex=2&singleView=true
</pre>


See also [https://www.familysearch.org/en/wiki/FamilySearch_Wiki:Manual_of_Style-Formatting#FamilySearch_Explore_Images_-_Links_to_Digital_Images Explore Images - Links to Digital Images].
See also [https://www.familysearch.org/en/wiki/FamilySearch_Wiki:Manual_of_Style-Formatting#FamilySearch_Explore_Images_-_Links_to_Digital_Images Explore Images - Links to Digital Images].


<noinclude>[[Category:Template documentation]]</noinclude>
<noinclude>[[Category:Template documentation]]</noinclude>

Latest revision as of 15:11, 9 May 2024

Purpose[edit source]

This template will allow the creation of links to specific images in acquired via Infinity and published as FamilySearch Images/ Explore Historical Images/ Explore Images.

Parameters[edit source]

This template has 4 parameters:

Parameter Value Display
DGS DGS number DGS number
ID rmsID none
Image Image number Image number
Item Item number Item

Operation[edit source]

Condition DGS
Parameter		 ID
Parameter		 Image
Parameter		 Item
Parameter		 Sample Code Display Result
Only DGS number is given 8417088 {{FSHI|DGS=8417008}} DGS 8417008 Link goes to list of folder content
DGS, ID, and Image given 8417088 M9DP-VQB 6 {{FSHI|DGS=8417088|ID=M9DP-VQB|Image=6}} DGS 8417088 Image# 6 Link goes to specific image in folder
DGS, ID, and Item given 8417008 M9DP-VQB 2 {{FSHI|DGS=8417088|ID=M9DP-VQB|Item=2}} DGS 8417088 Item 2 Link goes to specific item in folder

Note: The template will not work correctly if the ID parameter (rmsID) is not provided along with either the Image or Item parameter.

Operation[edit source]

The template should go through the parameters and check them against what is required to return the correct URL.

  1. If the DGS number is the only one given it should return a string as found in #1 below.
  2. If the item and nr parameters are also present it should return a string as in #2 below.
  3. If all four parameters are present it should return a string as in #3 below.

Sample input: 

#1 {{FSHI|DGS=8417008}}
#2 {{FSHI|DGS=8417008 |iD=M9DP-VQB |Item=2}}
#3 {{FSHI|DGS=8417008 |iD=M9DP-VQY |image=6}}

Expected output:

Example Display Concatenated URL
#1 DGS 8417008 https://www.familysearch.org/records/images/search-results?imageGroupNumbers=8417008&page=1
#2 DGS 8417008 item 2 https://www.familysearch.org/records/images/image-details?imageGroupNumbers=8417008&page=1&rmsId=M9DP-VQB&imageIndex=0
#3 DGS 8417008 image# 6 https://www.familysearch.org/records/images/image-details?imageGroupNumbers=8417008&page=1&rmsId=M9DP-VQY&imageIndex=6&singleView=true

See also Explore Images - Links to Digital Images.

Dates listed are estimated. Use Explore Historical Images to browse the newest collections available on FamilySearch. More information

DGS stands for Digital Genealogical Society also known as an Image Group Number. Each set of digital images is assigned a DGS number for identification purposes.

Retrieved from "https://integration-ru.familysearch.org/en/wiki/index.php?title=Template:FSHI/doc&oldid=5721662"