Editing Online sources

==Types of Online Resources==
To facilitate research and discovery, we aim to systematically include the following online resources in STCV:

* Photographs of pages in surveyed copies that are relevant to the STCV description
* Links to digitised copies (full-text) of editions described in STCV
* Links to related records in other bibliographical databases (STCN, USTC, ISTC, V17, etc.

=== Digitised Pages from Surveyed Copies ===

The cataloguers of STCV take photographs of pages from surveyed copies that are relevant to the bibliographical description. These may include:

*Typographical title page
*Engraved title page
*Printer's device
*Colophon
*Approbation, privilege, ...
*Pages where the fingerprint positions were taken from

The images are added to the database and can be retrieved via links in the individual records. 

The link labels refer to the specific copy from which the image was taken by including the library acronym and the call number.

=== Links to Digital Copies (Full-Text Repositories) ===
{{SeeAlso|[[#Settings for Links to Digital Copies|Settings for Links to Digital Copies]]}}
When participating libraries digitise copies surveyed by STCV, links to the full-text representations are included in the records. Digitised copies from other libraries are included when they are reliably found to be of the same edition. However, the data in '''STCV records cannot be changed or completed based on the consultation of a digitised copy alone''', even if this copy appears to be more complete than the surveyed physical copies! The cataloguer can point out important differences between surveyed and digitised copies in a general note.

The link labels start with 'electronically available' (by using the language independent code <EB>), the library acronym and call number specific to the digitised copy. We do not mention the repository in the label.
<blockquote>'''Example'''<br>[http://lib.ugent.be/europeana/900000015131 Electronically available: UGENT-CB G.000555]</blockquote> 

In the STCV online catalogue, it is possible to limit searches to editions for which digital copies are available. A list of all digitised editions can be generated using this search query: http://anet.be/opac/stcv/stcvopac/n/(dr:url).

=== Links to Online References (Bibliographical Databases)===
{{SeeAlso|[[Online Resources#Settings for Links to Bibliographical Databases|Settings for Links to Bibliographical Databases]]}}
Editions described in STCV are sometimes also included in other authoritative bibliographical databases, like [http://stcn.nl STCN], [http://ustc.ac.uk USTC] or [http://www.bl.uk/catalogues/istc/ ISTC]. Originally, references to these records were included as a reference annotation, mentioning the database acronym and record number. 

As of October 2015, deep links to these external records are also added, allowing for immediate access. The link labels mention the database acronym and the record number, in the same manner as the bibliographical annotations did. Existing records were updated retroactively to include direct links instead of bibliographical annotations.

<blockquote>
'''Example'''<br>[http://picarta.pica.nl/DB=3.11/XMLPRS=Y/PPN?PPN=840142358 STCN 840142358]
</blockquote>

==Including Links to Online Media==
=== Using URL Types ===
{{SeeAlso|[[List of URL Types]]}}

In the Brocade system, links to online content can be entered using 'URL Types'. Such presets can be configured for each database or repository that offers permalinks or allows deep links to be created based on unique IDs. If an online resource is referenced more than a few times in STCV, an URL type should be created for these links. This has to be requested from the Anet help desk by a Flanders Heritage Libraries staff member.

==== Advantages ====
There are distinct advantages to using URL types over free text links:

* If the main structure of the deep links into a database or repository changes while the unique IDs of the items referenced remains the same, all links of a type can be updated simply by changing the configuration URL type. No manual intervention is required at the record level.
* Using URL templates removes the burden from the individual cataloguer to figure out how to create deep links to content in databases and repositories that are frequently referenced. In some cases, this is far from obvious.
* It is often possible to create deep links to content in various manners. Using URL types, all links to a particular database follow the same structure.
* Is is possible to search for links of a certain URL type.

====Elements====
A URL type consists of these main elements:

{| class="wikitable" cellpadding="10"
|+URL Type Elements
|-
!Element
!Description
!Example
|-
!Code
|An abbreviation which is unique within the system, used when referencing this type in STCV records
|<code>dp_mpm</code>
|-
!Name
|The (internal) name of the URL type, generally the database or repository to which URLs of this type refer
|<code>Digital Plaform Museum Plantin-Moretus</code>
|-
!Template
|The fixed structure of the permalink or deep link, substituting the unique identifier for the resource with the code <code><value></code>
|<code><nowiki>http://anet.ua.ac.be/digital/mpm/opacmpm/mpm/<value></nowiki><code>
|-
!OPAC Label
|The default text for the link when it is displayed in the online catalogue. In STCV, this is normally overridden by a more specific description of the resource
|<code>Electronically available via the digital platform of Museum Plantin Moretus</code>
|}

===Settings for Links to Digital Copies===

{{SeeAlso|[[List of Library Acronyms]]}}
{{SeeAlso|[[List of URL Types#URL Types for Full-Text Repositories (Digital Copies)|URL Types for Full-Text Repositories (Digital Copies)]]}}
{| class="wikitable" cellpadding="10"
|+Settings for Links to Digital Copies
|-
!Field
!Value
|-
|Type
|E-info
|-
|Contents
|<code>[REPOSITORYUID]</code> (unique identifier in the repository, when a URL type exists for the repository)<br/>''or''<br/>full URL starting with <code>http(s)://</code> (when no URL type exists)
|-
|Heading/Origin
|<code><EB>: [[List of Library Acronyms|[LIBRARYACRONYM]]] [CALLNUMBER]</code> (for libraries with copies in STCV)<br/>''or''<br/><code><EB>: [LIBRARYNAME] [CALLNUMBER]</code> (for other libraries)
|-
|Size
|Always leave blank
|-
|Digest
|Always leave blank
|-
|Language
|Always: <code>Universele taal</code> (Universal language)
|-
|MIME type
|Always: <code>html</code>
|-
|Inline?
|Always leave unchecked
|-
|Access codes
|Always: <code>anet</code>
|-
|Location
|<code>[[List of URL Types#URL Types for Full-Text Repositories (Digital Copies)|[URLTYPE]]]</code> (when a URL type exists)<br/>''or''<br/><code>url</code> (when no URL type is used and a full URL was entered in the Contents field)
|}

'''Example'''
[[File:STCV Screen Print Input Link Digital Copy.png|border|Example of a properly configured link to a digital copy.]]

===Settings for Links to Bibliographical Databases===
{{SeeAlso|[[List of URL Types#URL Types for Bibliographical Databases (Online References)|URL Types for Bibliographical Databases (Online References)]]}}
{| class="wikitable" cellpadding="10"
|+Settings for Links to Bibliographical Databases
|-
!Field
!Value
|-
|Type
|Link
|-
|Contents
|<code>[DATABASEUID]</code> (unique identifier in the database)
|-
|Heading/Origin
|<code>[[List of URL Types#URL Types for Bibliographical Databases (Online References)|[DATABASEACRONYM]]] [DATABASEUID]</code>
|-
|Size
|Always leave blank
|-
|Digest
|Always leave blank
|-
|Language
|Always: <code>Universele taal</code> (Universal language)
|-
|MIME type
|Always: <code>html</code>
|-
|Inline?
|Always leave unchecked
|-
|Access codes
|Always: <code>anet</code>
|-
|Location
|<code>[[List of URL Types#URL Types for Bibliographical Databases (Online References)|[URLTYPE]]]</code> (when a URL type exists)<br/>or<br/><code>url</code> (when no URL type is used and a full URL was entered in the Contents field)
|}

'''Example'''
[[File:STCV_Screen_Print_Input_Link_Bibliographical_Database.png|border|Example of a properly configured bibliographical reference link.]]}}
[[Category:Brocade]]
[[Category:Data]]
[[Category:Opac]]