Skip to content

Fix MkDocs build failures: broken image links and .pages nav entry #248

@miguelalbano

Description

@miguelalbano

The MkDocs site build (mkdocs build --strict) fails with two errors that cause the GitHub Actions deploy workflow to fail:

  1. Broken image references in HKJK ground.md

docs/Aerodromes/Kenya/Jomo Kenyatta (HKJK)/ground.md references two images that don't exist in the repository:

apron06.png
apron24.png

These cause --strict mode to fail with "file not found" warnings promoted to errors.

Fix: Remove the broken image links (branch: claude/fix-hkjk-broken-image-links-34h7N). If the images are available, they should be added to the directory instead.
2. Invalid nav entry in Contributing/eAIP/.pages

docs/Contributing/eAIP/.pages references Useful_links.md but the actual file is named Useful Links.md (with a space, no underscore). The awesome-pages plugin fails to resolve this entry.

Fix: Change Useful_links.md to Useful Links in the .pages nav (branch: claude/fix-pages-nav-entry-34h7N).

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions