Skip to content

Fix GitHub Pages project-site routing for docs navigation#1

Closed
Bowenislandsong with Copilot wants to merge 2 commits into
mainfrom
copilot/fix-project-page-issue
Closed

Fix GitHub Pages project-site routing for docs navigation#1
Bowenislandsong with Copilot wants to merge 2 commits into
mainfrom
copilot/fix-project-page-issue

Conversation

Copilot AI commented May 21, 2026

Copy link
Copy Markdown
Contributor

The project page was resolving docs links incorrectly when published as a GitHub project site (/<repo>/...). URL generation did not consistently account for the repository subpath, causing broken navigation/assets in rendered docs pages.

  • Scope

    • Align docs-site URL generation with GitHub Pages project-site hosting (/AgenticLocal).
    • Preserve compatibility across top-level and nested markdown-rendered pages using the shared layout.
  • Changes

    • Jekyll base path configuration
      • Added baseurl: /AgenticLocal in docs/_config.yml.
    • Layout URL strategy
      • Kept stylesheet and nav links in docs/_layouts/default.html generated via relative_url so links resolve under the configured base path.
  • Representative update

    # docs/_config.yml
    title: AgenticLocal
    description: Local-first agent runtime with tools, policy, memory, and event streams.
    baseurl: /AgenticLocal
    markdown: kramdown
    <!-- docs/_layouts/default.html -->
    <link rel="stylesheet" href="{{ '/site.css' | relative_url }}">
    <a href="{{ '/use-cases.html' | relative_url }}">Use Cases</a>

Copilot AI and others added 2 commits May 21, 2026 23:54
Agent-Logs-Url: https://github.com/Bowen-AI/AgenticLocal/sessions/4ffac6d5-9f89-4006-b8a8-701c733db8e0

Co-authored-by: Bowenislandsong <29466283+Bowenislandsong@users.noreply.github.com>
Agent-Logs-Url: https://github.com/Bowen-AI/AgenticLocal/sessions/4ffac6d5-9f89-4006-b8a8-701c733db8e0

Co-authored-by: Bowenislandsong <29466283+Bowenislandsong@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants