iseal-core/site/layouts/_default/home.html

163 lines
8.2 KiB
HTML
Raw Normal View History

{{ 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">
<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>
2021-12-21 17:14:54 +01:00
<a class="nav-link" href="#schema-extensions">Schema Extensions</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>ISEAL Core Metadata Set Specification</h1>
<p class="lead">This page provides a reference specification for the ISEAL Core Metadata set (ISEAL Core).</p>
2021-12-01 10:59:42 +01:00
<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>Coverage</td>
<td>Certificate</td>
<td>Impact</td>
</tr>
<tr>
<td>Form</td>
<td>Certificate Holder, Owner or Certified organization</td>
<td></td>
</tr>
<tr>
<td>Provenance</td>
<td>Certified Resource or Site</td>
<td></td>
</tr>
<tr>
<td>Scope</td>
<td>Certifying Body</td>
<td></td>
</tr>
<tr>
<td>Status</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>
<h3 id="cluster-global">Global Cluster</h3>
<p>
{{/* Note: we need to use two ranges for each cluster because it is */}}
{{/* not possible to re-use Hugo's paginate object unless you use */}}
{{/* the same exact arguments each time. */}}
<!-- TODO: note that not all terms have field names so this list is not exclusive! -->
{{ range where (where site.RegularPages "Type" "terms") "Params.cluster" "==" "Global" }}
{{- if .Params.field -}}
<a class="btn btn-sm btn-outline-primary m-1" href="#{{ .Params.slug }}">{{ .Params.field }}</a>
{{- end -}}
{{ end }}
</p>
{{ range where (where site.RegularPages "Type" "terms") "Params.cluster" "==" "Global" }}
<div class="col">
{{ .Render "term" }}
</div>
{{ end }}
<h3 id="cluster-certification">Certification Cluster</h3>
<p>
{{ range where (where site.RegularPages "Type" "terms") "Params.cluster" "==" "Certification" }}
{{- if .Params.field -}}
<a class="btn btn-sm btn-outline-primary m-1" href="#{{ .Params.slug }}">{{ .Params.field }}</a>
{{- end -}}
{{ end }}
</p>
{{ range where (where site.RegularPages "Type" "terms") "Params.cluster" "==" "Certification" }}
<div class="col">
{{ .Render "term" }}
</div>
{{ end }}
<h3 id="cluster-impact">Impact Cluster</h3>
<p>
{{ range where (where site.RegularPages "Type" "terms") "Params.cluster" "==" "Impact" }}
{{- if .Params.field -}}
<a class="btn btn-sm btn-outline-primary m-1" href="#{{ .Params.slug }}">{{ .Params.field }}</a>
{{- end -}}
{{ end }}
</p>
{{ range where (where site.RegularPages "Type" "terms") "Params.cluster" "==" "Impact" }}
<div class="col">
{{ .Render "term" }}
</div>
{{ 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>
2022-01-07 13:26:50 +01:00
<a href="https://raw.githubusercontent.com/iseal-community/iseal-core/main/data/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>
2022-01-07 13:26:50 +01:00
<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="feedback">Feedback</h2>
<p>If you have questions/comments please contact ____.</p>
</main>
</div><!-- end .row -->
</div><!-- end .container-fluid -->
{{ end }}
{{- /* vim: set ts=2 sw=2 et: */}}