{{ define "title" }}{{ .Site.Title }}{{ end }}

{{ define "main" }}

  <body data-bs-spy="scroll" data-bs-target="#navbar-navigation">
  <div class="container-fluid">
    <div class="row">
      <!-- only show menu on large devices -->
      <div class="col-lg-2 d-none d-lg-block">
        <div class="sticky-top">
          <nav id="navbar-navigation" class="navbar navbar-light bg-light flex-column align-items-start p-3">
            {{ $isealLogo := resources.Get "images/iseal-logo.png" | resources.Fingerprint }}
            <img id="iseal-logo" src="{{ $isealLogo.Permalink }}" width="150px">
            <a class="navbar-brand" href="#">Navigation</a>
            <nav class="nav nav-pills flex-column">
              <a class="nav-link" href="#clusters-and-modules">Clusters and Modules</a>
              <a class="nav-link" href="#metadata-elements">Metadata Elements</a>
              <nav class="nav nav-pills flex-column">
                <a class="nav-link ms-3 my-1" href="#cluster-global">Global</a>
                <a class="nav-link ms-3 my-1" href="#cluster-certification">Certification</a>
                <a class="nav-link ms-3 my-1" href="#cluster-impact">Impact</a>
              </nav>
              <a class="nav-link" href="#download">Download</a>
              <a class="nav-link" href="#schema-extensions">Schema Extensions</a>
              <a class="nav-link" href="#credits">Credits</a>
              <a class="nav-link" href="#feedback">Feedback</a>
            </nav>
          </nav>
        </div>
      </div>
      <!-- main content is 10 columns on large devices, 12 on all others -->
      <main class="col-lg-10">
        <h1 id="iseal-heading">ISEAL Core Metadata Set Specification</h1>
        <p class="lead">This page provides a reference specification for the ISEAL Core Metadata set (ISEAL Core).</p>
        <p>ISEAL Core is a set of structured terms and vocabularies that can be used as metadata to describe, share, and reuse different digital resources across the ISEAL Community and broader set of stakeholders. The resources described using the ISEAL Core are those that sustainability systems typically collect, curate, manage, use, publish and archive. They may be datasets, published research, certificates, videos, images, maps, or other organizational documentation.</p>
        <h2 id="clusters-and-modules">Clusters and Modules</h2>
        <p>Metadata elements in ISEAL Core are organized around three <em>clusters</em> and ten <em>modules</em>.</p>
        <div class="m-3">
          <table class="table table-striped table-sm text-center">
            <thead class="table-light">
              <tr>
                <th>Global</th>
                <th>Certification</th>
                <th>Impact</th>
              </tr>
            </thead>
            <tbody>
              <tr>
                <td><a href="#module-Coverage">Coverage</a></td>
                <td><a href="#module-Assurance">Assurance</a></td>
                <td><a href="#module-Evaluation">Evaluation</a></td>
              </tr>
              <tr>
                <td><a href="#module-Form">Form</a></td>
                <td><a href="#module-Certificate">Certificate</a></td>
                <td></td>
              </tr>
              <tr>
                <td><a href="#module-Provenance">Provenance</a></td>
                <td><a href="#module-Certificate Holder, Owner or Certified organization">Certificate Holder, Owner or Certified organization</a></td>
                <td></td>
              </tr>
              <tr>
                <td><a href="#module-Scope">Scope</a></td>
                <td><a href="#module-Certified Resource or Site">Certified Resource or Site</a></td>
                <td></td>
              </tr>
              <tr>
                <td><a href="#module-Status">Status</a></td>
                <td></td>
                <td></td>
              </tr>
            </tbody>
          </table>
        </div>
        <h2 id="metadata-elements">Metadata Elements</h2>
        <p>ISEAL Core uses elements from the following standard metadata schemas:</p>
        <ul>
          <li><a href="https://www.dublincore.org/specifications/dublin-core/dcmi-terms/#section-3">Dublin Core Elements</a> with the <code>dc</code> namespace prefix. These were <a href="http://www.dlib.org/dlib/July95/07weibel.html">originally designated in 1995</a> and are considered deprecated and superseded by Dublin Core Terms. Due to legacy code in the DSpace software we must still use some of these.</li>
          <li><a href="https://www.dublincore.org/specifications/dublin-core/dcmi-terms/#section-2">Dublin Core Terms</a> with the <code>dcterms</code> namespace prefix. These contain the original Dublin Core Terms and add others. As of 2008 these supercede the original Dublin Core Elements.</li>
        </ul>
        <p>General guidelines for metadata using ISEAL Core:</p>
        <ul>
          <li><strong>Encoding</strong>: metadata should be encoded in UTF-8 to ensure correct representation of international characters.</li>
          <li><strong>Applicability</strong>: metadata should describe what the item is, <em>not what it isn't</em>. If a metadata element is not applicable you should not use it. Do not enter "N/A"!</li>
        </ul>

        {{/* Assign the current page context to a variable so we don't lose */}}
        {{/* it in the range below.                                         */}}
        {{ $context := . }}

        <h3 id="cluster-global">Global Cluster</h3>

        {{ $cluster := "Global" }}
        {{ .Scratch.Set "cluster" $cluster }}
        {{ $modules := slice "Coverage" "Form" "Provenance" "Scope" "Status" }}
        {{ range $modules }}
          {{ $module := . }}
          {{ $.Scratch.Set "module" $module }}

          {{/* Call the partial template to render the module's elements. */}}
          {{/* Note that we need to use the $cluster and the $module as   */}}
          {{/* keys to the partial's cache so the cache is unique (so we  */}}
          {{/* don't get FSC elements in the ISEAL layout).               */}}
          {{ partialCached "module-elements.html" $context $cluster $module }}
        {{ end }}

        <h3 id="cluster-certification">Certification Cluster</h3>

        {{ $cluster := "Certification" }}
        {{ .Scratch.Set "cluster" $cluster }}
        {{ $modules := slice "Assurance" "Certificate" "Certificate Holder, Owner or Certified organization" "Certified Resource or Site" }}
        {{ range $modules }}
          {{ $module := . }}
          {{ $.Scratch.Set "module" $module }}
          {{ partialCached "module-elements.html" $context $cluster $module }}
        {{ end }}

        <h3 id="cluster-impact">Impact Cluster</h3>

        {{ $cluster := "Impact" }}
        {{ .Scratch.Set "cluster" $cluster }}
        {{ $modules := slice "Evaluation" }}
        {{ range $modules }}
          {{ $module := . }}
          {{ $.Scratch.Set "module" $module }}
          {{ partialCached "module-elements.html" $context $cluster $module }}
        {{ end }}

        <h2 id="download">Download</h2>
        <p>The ISEAL Core schema is available for download in two formats:</p>
        <div class="row mb-2 justify-content-center">
          <div class="col-sm-12 col-lg-4">
            {{ $fileCodeIcon := resources.Get "icons/file-earmark-code.svg" | resources.Fingerprint }}
            <h3><img class="icon me-1" src="{{ $fileCodeIcon.Permalink }}" alt="File icon with earmark"/>Turtle</h3>
            <p>Terse RDF Triple Language (TTL). Use this format when you need to validate metadata against ISEAL Core programmatically.</p>
            <a href="https://raw.githubusercontent.com/iseal-community/iseal-core/main/data/rdf/iseal-core.ttl" class="btn btn-primary">Download</a>
          </div>
          <div class="col-sm-12 col-lg-4">
            {{ $fileSpreadsheetIcon := resources.Get "icons/file-earmark-spreadsheet.svg" | resources.Fingerprint }}
            <h3><img class="icon me-1" src="{{ $fileSpreadsheetIcon.Permalink }}" alt="File icon with earmark"/>CSV</h3>
            <p>Comma-separated Values (CSV). Use this format when you just need a quick and easy offline reference.</p>
            <a href="https://raw.githubusercontent.com/iseal-community/iseal-core/main/data/iseal-core.csv" class="btn btn-primary">Download</a>
          </div>
        </div>

        <h2 id="schema-extensions">Schema Extensions</h2>
        <ul>
          <li><a href="{{ .Site.BaseURL }}/fsc">Forest Stewardship Council</a></li>
        </ul>
        <h2 id="credits">Credits</h2>
        <p>The ISEAL Core Metadata Set and FSC extension were compiled by Peter Ballantyne drawing on reviews of information systems and conversations with individuals in several organizations, notably FSC and ISEAL. The metadata were reviewed, improved and published on GitHub by Alan Orth and Marie-Angelique Laporte. Elizabeth Kennedy oversaw the data implementations and Julie Smith provided overall project management. For more information about the development of these resources please see <a href="https://www.isealalliance.org/isealcoremetadata">https://www.isealalliance.org/isealcoremetadata</a>.</p>
        <h2 id="feedback">Feedback</h2>
        <p>If you have questions/comments please contact Elizabeth Kennedy (elizabeth@isealalliance.org).</p>
      </main>
    </div><!-- end .row -->
  </div><!-- end .container-fluid -->

{{ end }}

{{- /* vim: set ts=2 sw=2 et: */}}
