### Configure Logo in Front Matter (TOML)

Source: https://github.com/dsu-digital-sound-design/dad-498-audio-forensics/blob/master/content/test-slides/_index.md

This TOML snippet shows the basic configuration for adding a logo to a presentation slide. It specifies the source file for the logo.

```toml
+++
title = "Logo presentation example"
outputs = ["Reveal"]
[logo]
src = "github-logo.png"
+++
```

--------------------------------

### Add Custom CSS for Logo Styling (HTML Partial)

Source: https://github.com/dsu-digital-sound-design/dad-498-audio-forensics/blob/master/content/test-slides/_index.md

This example shows how to add custom CSS to override default logo styling for a specific presentation or globally. It involves placing a CSS file within the Hugo project's layout structure.

```html
layouts/partials/{section}/reveal-hugo/body.html
```

--------------------------------

### Set Default Logo in Site Configuration (TOML)

Source: https://github.com/dsu-digital-sound-design/dad-498-audio-forensics/blob/master/content/test-slides/_index.md

This TOML snippet demonstrates how to set a default logo for all presentations by configuring it in the site's main configuration file. This allows for a consistent branding across the site.

```toml
[params.logo]
src = "/img/logo.png"
```

--------------------------------

### Hugo CLI Commands for Building and Serving

Source: https://context7.com/dsu-digital-sound-design/dad-498-audio-forensics/llms.txt

Provides essential Hugo Command Line Interface (CLI) commands for managing the website. This includes installing Hugo on macOS, cloning a repository with submodules, serving the site locally with live reload, and building the site for production.

```bash
# Install Hugo (macOS)
brew install hugo

# Clone repository with submodules
git clone --recurse-submodules <repository-url>

# Serve locally with live reload
hugo server -D

# Build for production
hugo --minify
```

--------------------------------

### Customize Logo Placement and Appearance (TOML)

Source: https://github.com/dsu-digital-sound-design/dad-498-audio-forensics/blob/master/content/test-slides/_index.md

This TOML snippet illustrates advanced customization for logo placement and appearance on presentation slides. It includes parameters for size, position, and alternative text.

```toml
[logo]
src = "github-logo.png" # Location of the file displayed.
alt = "" # Alt text. 
width = "15%" # Size of the file.
diag = "1%" # How far from the top right should the file be.
top = "1%" # Overrides diag.
right = "1%" # Overrides diag.
```

--------------------------------

### Markdown Usage for PDF Shortcode

Source: https://context7.com/dsu-digital-sound-design/dad-498-audio-forensics/llms.txt

Demonstrates how to use the 'pdf' shortcode within markdown files to embed PDF documents. It shows basic usage with just a URL and advanced usage with options to hide the paginator and specify a starting page.

```markdown
{{< pdf url="dad-498-syllabus.pdf" >}}

<!-- With options -->
{{< pdf url="chapter4.pdf" hidePaginator="true" renderPageNum="5" >}}
```

--------------------------------

### Markdown Structure for Lab Content

Source: https://context7.com/dsu-digital-sound-design/dad-498-audio-forensics/llms.txt

Defines the front matter and structure for lab content pages. It includes metadata like 'title', 'date', and 'draft' status, followed by markdown content detailing the lab's overview, installation steps, and required materials.

```markdown
---
title: "Lab: Introduction to Adobe Audition for Forensic Audio Analysis"
date: 2024-01-15
draft: false
---

## Overview

**Duration**: ~30 minutes
**Objective**: Learn to use Adobe Audition's essential tools for forensic
audio examination: waveform view, spectrographic view, and critical
listening techniques.

## Part 1: Installing Adobe Audition

### Installation Steps

1. Go to [https://creativecloud.adobe.com/](https://creativecloud.adobe.com/)
2. Click "Sign In" and select "Company or School Account"
3. Find "Adobe Audition" and click "Install"

## Part 2: Download Lab Materials

### Required Files

- [forensic_speech_clean.wav](/media/handling-forensic-audio-lab/forensic_speech_clean.wav)
- [forensic_speech_clean.mp3](/media/handling-forensic-audio-lab/forensic_speech_clean.mp3)
- [forensic_with_artifacts.wav](/media/handling-forensic-audio-lab/forensic_with_artifacts.wav)

## Part 3: Waveform Analysis

**Zoom Controls**:
- Horizontal zoom: Use `=` to zoom in, `-` to zoom out
- Vertical zoom: Mouse wheel
- Fit to window: Press `\` (backslash)

**What to Look For**:
- **Clicks**: Sharp vertical spikes
- **Dropouts**: Sudden drop to silence
- **Discontinuities**: Abrupt waveform changes
```

--------------------------------

### Initialize PDF Rendering with PDF.js

Source: https://github.com/dsu-digital-sound-design/dad-498-audio-forensics/blob/master/layouts/shortcodes/pdf.html

This JavaScript code initializes the PDF rendering process using the PDF.js library. It sets up the worker source, retrieves PDF document URL and rendering options from the DOM, and prepares the canvas and paginator elements for display. It handles initial page rendering and asynchronous loading of the PDF document.

```javascript
window.onload = function () {
  // If absolute URL from the remote server is provided, configure the CORS // header on that server.
  var url = "{{.Site.BaseURL}}" + '{{ .Get "url" }}';
  var hidePaginator = "{{ .Get " hidePaginator " }}" === "true";
  var hideLoader = "{{ .Get " hideLoader " }}" === "true";
  var selectedPageNum = parseInt("{{ .Get " renderPageNum " }}") || 1;

  // Loaded via <script> tag, create shortcut to access PDF.js exports.
  var pdfjsLib = window['pdfjs-dist/build/pdf'];

  // The workerSrc property shall be specified.
  pdfjsLib.GlobalWorkerOptions.workerSrc = "{{.Site.BaseURL}}" + '/js/pdf_js/build/pdf.worker.js';

  // Change the Scale value for lower or higher resolution.
  var pdfDoc = null, pageNum = selectedPageNum, pageRendering = false, pageNumPending = null, scale = 3, canvas = document.getElementById('the-canvas'), ctx = canvas.getContext('2d'), paginator = document.getElementById("paginator"), loadingWrapper = document.getElementById('loadingWrapper');

  // Attempt to show paginator and loader if enabled
  showPaginator();
  showLoader();

  pdfjsLib.getDocument(url).promise.then(function (pdfDoc_) {
    pdfDoc = pdfDoc_;
    var numPages = pdfDoc.numPages;
    document.getElementById('page_count').textContent = numPages;

    // If the user passed in a number that is out of range, render the last page.
    if (pageNum > numPages) {
      pageNum = numPages
    }

    // Initial/first page rendering
    renderPage(pageNum);
  });
}
```

--------------------------------

### Reveal-Hugo Slide Presentation (Markdown)

Source: https://context7.com/dsu-digital-sound-design/dad-498-audio-forensics/llms.txt

Creates interactive slide presentations using Reveal-Hugo theme in Markdown. Supports speaker notes and custom slide layouts for lectures.

```markdown
+++ 
title = "Sound and hearing"
outputs = ["Reveal"]
[reveal_hugo]
theme = "moon"
margin = 0.2
separator = "##"
+++ 

# Sound and hearing

{{% note %}}
Speaker notes go here - visible to presenter but hidden from audience.
These notes provide additional context for instructors.
{{% /note %}}

---

## Amplitude

![](amplitude.png)

{{% note %}}
The distance above or below the centerline of a waveform represents
the amplitude level of that signal. Greater displacement means more
intense pressure variation.
{{% /note %}}

---

## Frequency

![](frequency.png)

{{% note %}}
The rate at which an acoustic signal repeats is known as frequency, 
measured in cycles per second (Hz). An "A" note is 440 Hz.
{{% /note %}}

```

--------------------------------

### Navigate Between PDF Pages

Source: https://github.com/dsu-digital-sound-design/dad-498-audio-forensics/blob/master/layouts/shortcodes/pdf.html

These event listeners handle the 'click' events for the previous and next page buttons. `onPrevPage` decrements the page number and queues the rendering of the previous page, while `onNextPage` increments the page number and queues the rendering of the next page. Navigation is restricted to the available page range.

```javascript
function onPrevPage() {
  if (pageNum <= 1) {
    return;
  }
  pageNum--;
  queueRenderPage(pageNum);
}

document.getElementById('prev').addEventListener('click', onPrevPage);

function onNextPage() {
  if (pageNum >= pdfDoc.numPages) {
    return;
  }
  pageNum++;
  queueRenderPage(pageNum);
}

document.getElementById('next').addEventListener('click', onNextPage);
```

--------------------------------

### Hugo Project Directory Structure

Source: https://context7.com/dsu-digital-sound-design/dad-498-audio-forensics/llms.txt

Presents the standard directory structure for a Hugo project, outlining the purpose of key directories like 'config.toml', 'content', 'layouts', and 'static'. This structure is essential for organizing project files.

```directory
/
├── config.toml                 # Site configuration
├── archetypes/
│   └── default.md             # Default content template
├── content/
│   ├── _index.md              # Homepage
│   ├── syllabus.md            # Course syllabus
│   ├── schedule.md            # Weekly schedule
│   ├── projects.md            # Project descriptions
│   └── lectures/
│       ├── week-1/
│       │   ├── sound-and-hearing/_index.md
│       │   └── intro-to-forensic-audio/_index.md
│       ├── week-2/
│       │   └── historical-case-studies/_index.md
│       ├── week-3/
│       │   └── psychoacoustics-and-digital-audio-fundamentals/_index.md
│       └── week-4/
│           ├── handling-forensic-audio-evidence/_index.md
│           └── handling-forensic-audio-evidence-lab/lab.md
├── layouts/
│   ├── _default/
│   │   ├── index.html
│   │   ├── list.html
│   │   └── single.html
│   ├── partials/
│   │   ├── extended_footer.html
│   │   └── extended_header.html
│   └── shortcodes/
│       ├── homework.html
│       ├── pdf.html
│       ├── table.html
│       └── toc.html
├── static/
│   ├── style.css
│   └── media/
│       └── handling-forensic-audio-lab/
│           ├── forensic_speech_clean.wav
│           ├── forensic_speech_clean.mp3
│           └── forensic_with_artifacts.wav
└── themes/                     # Git submodules for terminal and reveal-hugo
```

--------------------------------

### Hugo Configuration (TOML)

Source: https://context7.com/dsu-digital-sound-design/dad-498-audio-forensics/llms.txt

Defines site-wide settings, themes, and navigation for a Hugo website. It specifies the base URL, language, themes, and parameters for the site's appearance and content.

```toml
# config.toml - Main Hugo configuration
baseurl = "/"
languageCode = "en-us"
theme = ["terminal", "reveal-hugo"]

[params]
  contentTypeName = "home"
  themeColor = "blue"
  showMenuItems = 3
  centerTheme = true
  autoCover = true

[languages.en]
  languageName = "English"
  title = "DAD 492 - Sound Forensics"
  subtitle = "Spring 2026 - Dakota State University"
  owner = "Tate Carson"

[languages.en.menu]
  [[languages.en.menu.main]]
    identifier = "syllabus"
    name = "Syllabus"
    url = "/syllabus"
  [[languages.en.menu.main]]
    identifier = "schedule"
    name = "Schedule"
    url = "/schedule"
  [[languages.en.menu.main]]
    identifier = "projects"
    name = "Projects"
    url = "/projects"

[outputFormats.Reveal]
  baseName = "index"
  mediaType = "text/html"
  isHTML = true

[markup.goldmark.renderer]
  unsafe = true

```

--------------------------------

### TOML Front Matter for Content Pages

Source: https://context7.com/dsu-digital-sound-design/dad-498-audio-forensics/llms.txt

Illustrates the standard TOML front matter used for content pages in Hugo. This metadata, including the 'title', is crucial for organizing and displaying content correctly.

```toml
---
title: "Syllabus"
---

[Download PDF](../dad-498-syllabus.pdf)

## Course Information

- **Course:** DAD 492 - Sound Forensics
- **Credits:** 3
- **Term:** Spring 2026
- **Meeting Time:** Tuesday / Thursday 1:00 pm - 2:15 pm
- **Location:** TCB 209

## Student Learning Outcomes

1. Identify and accurately use core terminology in forensic audio analysis
2. Explain how physical acoustics and psychoacoustics influence forensic evidence
3. Apply standard forensic audio tools and methods to examine recordings
4. Analyze audio evidence by integrating signal analysis and probabilistic reasoning
5. Produce professionally structured forensic audio reports
```