Path Resolution

Demonstrating file path resolution using relative and absolute paths for images and included Markdown files in a documentation system

September 22, 2025

Samantha Monty

Chair for Human-Computer Interaction, University of Würzburg

Path Resolution Documentation

Document Path: test/decks

This document explains how file paths are resolved, including examples of relative and absolute paths for images and included Markdown files.

Image Path Examples

The following table demonstrates how to include images using relative and absolute paths.

Relative Path Image	Absolute Path Image
Relative Image	/test/decks/include/06-metal.png

Source code

# Path Resolution Documentation

**Document Path**: [:meta](documentPath)

This document explains how file paths are resolved, including examples of relative and absolute paths for images and included Markdown files.

# Image Path Examples

The following table demonstrates how to include images using relative and absolute paths.

| Relative Path Image | Absolute Path Image |
|---------------------|---------------------|
| ![Relative Image](include/06-metal.png) | !
[/test/decks/include/06-metal.png](/test/decks/include/06-metal.png) |

Path Definitions in Metadata

YAML Metadata

The paths are defined in the YAML metadata as follows:

paths:
  existing-file-relative: include/06-metal.png
  existing-file-absolute: /test/decks/include/06-metal.png
  non-existing-file-relative: this/path/does/not.exist
  non-existing-file-absolute: /test/decks/this/path/does/not.exist

Resolved Path Values

The resolved values for the defined paths are:

Existing File (Relative): include/06-metal.png
Existing File (Absolute): include/06-metal.png
Non-existing File (Relative): this/path/does/not.exist
Non-existing File (Absolute): /test/decks/this/path/does/not.exist

Source code

# Resolved Path Values

The resolved values for the defined paths are:

- **Existing File (Relative)**: [:meta](paths.existing-file-relative)
- **Existing File (Absolute)**: [:meta](paths.existing-file-absolute)
- **Non-existing File (Relative)**: [:meta](paths.non-existing-file-relative)
- **Non-existing File (Absolute)**: [:meta](paths.non-existing-file-absolute)

Included Markdown File

This section includes a Markdown file to show how plain image paths are handled in external files:

Included

include/../data/07-moveable-camera-480x270-1000-zero.png

data/07-moveable-camera-480x270-1000-zero.png

Meta Data Values (Included)

Resolved Values

existing-file-relative: include/06-metal.png
existing-file-absolute: include/06-metal.png
non-existing-file-relave: this/path/does/not.exist
non-existing-file-absolute: /test/decks/this/path/does/not.exist

Source code

# Included Markdown File {.xx-small}

This section includes a Markdown file to show how plain image paths are handled in external files:

[:include](include/path-resolution-include.md)