ArchivesPortalEuropeFoundation / EAG2012

Maintenance of EAG2012, the Encoded Archival Guide for describing institutions with archival holdings
5 stars 1 forks source link

[Major revision] Add <socialMedia> to <description> #144

Open kerstarno opened 1 year ago

kerstarno commented 1 year ago

Provide a general summary of the issue in the Title above. Delete the part of the issue template that does not apply depending on whether you describe a change to an existing element / attribute or the addition of a new one.

Creator of issue

State your name, organisation and ways to reach you. Name: Kerstin Arnold Organisation: Archives Portal Europe Foundation, Working Group on Standards Email: standards@archivesportaleurope.net GitHub username (if applicable): @kerstarno

New element / attribute

Give the name of the new element / attribute. Include the tag name and the full name. Name: <socialMedia>

Context and availability

List all parent elements to which the element / attribute should be added. For elements, give an indication of their availability within each parent element ("1..1" for required but not repeatable, "1 (or another number)..n" for required and repeatable, "0..1" for optional but not repeatable", "0..n" for optional and repeatable). For attributes, indicate their availability with "1" for required or "0" for optional within each parent element. Parent element(s): optional and repeatable (0..n) sub-element of <description>; <socialMedia> can only appear after <places>, <access>, <timetable>, <functions>, <legalStatuses>, and <mandates>

Content model (elements)

List all sub-elements and attributes of the new element. For sub-elements, give an indication of their availability ("1..1" for required but not repeatable, "1 (or another number)..n" for required and repeatable, "0..1" for optional but not repeatable", "0..n" for optional and repeatable). For attributes, indicate their availability with "1" for required or "0" for optional. Sub-element(s): n/a; [text] Attributes (with default values, if applicable): optional attributes @audience with values "external", "internal" (0), @id (0), @languageOfElement (0), @scriptOfElement (0), @target (0); @conventionDeclarationReference (0), @maintenanceEventReference (0), @sourceReference (0); @href (0), @linkRole (0), @linkTitle (0); @localType (0), @localTypeDeclarationReference; option to include attributes from any other namespace

Example of XML code

Provide a sample encoding in XML of the new / changed element (with potential attributes). Write your text after the "Example:" below. Example:

<description>
  [...]
  <socialMedia href="https://twitter.com/franceArchives" linkTitle="Follow us on Twitter" localType="Twitter">Follow us on Twitter</socialMedia>
</description>
or
<description>
  [...]
  <socialMedia href="https://www.facebook.com/cardiffuni" linkTitle="Find us on Facebook" localType="Facebook"/>
</description>