Ian/add citation to page (#29)

* add citation file

* move CITATION.cff location, add citation rendering script

Author: ianalexmac

layouts/index.html

@@ -131,9 +131,12 @@ <h2>Result</h2>
     </div>
 
 
+    
     <hr>
     <h2>Methodology</h2>
     <p>Users interested in reading more about the methodology of this tool can <a href="https://github.com/acep-uaf/energy-cost-burden-site/wiki/Methodology">visit our documentation</a></p>
+    <h2>Citation</h2>
+    <div id="citation"></div>
     <hr>
     <h2>Contact</h2>
     <p>If you have questions regarding this tool, please reach out via email to <a href="mailto:ACEP.info@alaska.edu">ACEP.info@alaska.edu</a>.</p>
@@ -146,10 +149,10 @@ <h2>Funding</h2>
   </div>
   <div id="map"></div>
 
-  <!-- <script src="https://unpkg.com/leaflet/dist/leaflet.js"></script> -->
   <script src="https://cdn.jsdelivr.net/npm/leaflet@1.9/dist/leaflet.min.js"></script>  
   <script src="https://cdn.jsdelivr.net/npm/papaparse@5.5/papaparse.min.js"></script>
   <script src="https://cdn.jsdelivr.net/npm/jszip@3.10/dist/jszip.min.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/js-yaml@4.1/dist/js-yaml.min.js"></script>
   <script src="{{ "js/script.js" | absURL }}"></script>
 </body>
 </html>

static/data/CITATION.cff

@@ -0,0 +1,32 @@
+cff-version: 1.2.0
+title: FNSB Energy Burden Estimator
+message: >-
+  If you use this software, please cite it using the
+  metadata from this file.
+type: software
+authors:
+  - given-names: J.
+    family-names: Kaczmarski
+    affiliation: University of Alaska Fairbanks
+    orcid: 'https://orcid.org/0000-0003-4612-1150'
+  - given-names: I.
+    family-names: MacDougall
+    affiliation: Alaska Center for Energy and Power
+repository-code: 'https://github.com/acep-uaf/energy-cost-burden-site'
+url: 'https://fnsb-energy-burden.acep.uaf.edu'
+abstract: >-
+  A tool for estimating the average annual household energy
+  costs as a share of total household income in the
+  Fairbanks North Star Borough (FNSB) census boundary based
+  on energy prices and census data. This tool is an
+  extension of the 2024 Borough commissioned report: Energy
+  Burden Analysis of the Fairbanks North Star Borough
+  https://doi.org/10.5281/zenodo.12575185.
+keywords:
+  - Energy Burden
+  - Economics
+  - Geospatial
+  - Alaska
+license: MIT
+version: V1.0.0
+date-released: '2025-10-16'

static/js/script.js

@@ -578,5 +578,35 @@ document.addEventListener("DOMContentLoaded", async () => {
              d > 2  ? '#FED976' :
                       '#FFEDA0';
     }
+
+
+  const citationDiv = document.getElementById('citation');
+  const citationUrl = "data/CITATION.cff";
+
+  try {
+    const response = await fetch(citationUrl);
+    if (!response.ok) throw new Error(`HTTP error! Status: ${response.status}`);
+    const cffText = await response.text();
+    const data = jsyaml.load(cffText);
+
+    const authors = data.authors
+      .map(a => `${a['family-names']}, ${a['given-names'].charAt(0)}.`)
+      .join(' & ');
+    const title = data.title || 'Untitled';
+    const version = data.version ? ` (v${data.version})` : '';
+    const year = data['date-released']
+      ? new Date(data['date-released']).getFullYear()
+      : 'n.d.';
+    const publisher = data.publisher || 'Alaska Center for Energy and Power';
+    const url = data.url || '#';
+
+    citationDiv.innerHTML = `${authors} (${year}). <i>${title}</i>${version}. ${publisher}. <a href="${url}">${url}</a>`;
+  } catch (error) {
+    console.error('Citation load error:', error);
+    citationDiv.textContent = 'Citation unavailable.';
+  }
+
+
+
   });
-  
+