Fix build failure from circular symlink in theme submodule

[Copilot]

Jekyll build fails with "Too many levels of symbolic links" when traversing themes/arcana/exampleSite/themes/hugo-arcana → ../../, a circular symlink in the hugo-arcana theme submodule.

Changes

• Added ignoreFiles directive to hugo.toml to exclude theme exampleSite directories from processing

# Ignore the exampleSite directory in themes to avoid circular symlink issues
ignoreFiles = ['themes/[^/]+/exampleSite/']

The exampleSite directory is only used for theme development and is not needed for production builds.

Original prompt

---

This section details on the original issue you should resolve

<issue_title>build error</issue_title>
<issue_description>build
Logging at level: debug GitHub Pages: github-pages v232 GitHub Pages: jekyll v3.10.0 Theme: jekyll-theme-primer Theme source: /usr/local/bundle/gems/jekyll-theme-primer-0.6.0 Requiring: jekyll-github-metadata Requiring: jekyll-seo-tag Requiring: jekyll-coffeescript Requiring: jekyll-commonmark-ghpages Requiring: jekyll-gist Requiring: jekyll-github-metadata Requiring: jekyll-paginate Requiring: jekyll-relative-links Requiring: jekyll-optional-front-matter Requiring: jekyll-readme-index Requiring: jekyll-default-layout Requiring: jekyll-titles-from-headings GitHub Metadata: Initializing... Source: /github/workspace/. Destination: /github/workspace/./_site Incremental build: disabled. Enable with --incremental Generating... github-pages 232 | Error: Too many levels of symbolic links @ rb_sysopen - /github/workspace/themes/arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana/exampleSite/themes/hugo-arcana</issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes build error #32

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

[github-actions]

🔍 Preview Build Complete

The site has been built successfully for this PR!

How to preview:

1. Download the preview artifact from the workflow run
2. Extract the zip file
3. Open index.html in your browser to preview the site

Alternative preview methods:

• Use a local HTTP server: python -m http.server 8000 or npx serve
• Or use VS Code's Live Server extension

Note: The preview uses the GitHub Pages URL (https://eclipse-volttron.github.io/) as the base URL. Links will work correctly when viewing locally.

Build Details:

• PR: Fix build failure from circular symlink in theme submodule #33
• Commit: 419cb54
• Artifact: pr-preview-33

[craig8]

@copilot this was during a workflow build

[Copilot]

@copilot this was during a workflow build

Thanks for clarifying. The fix I implemented addresses the workflow build issue:

1. The ignoreFiles configuration in hugo.toml prevents Hugo from processing the theme's exampleSite directory (which contains the circular symlink)
2. This ensures the circular symlink never makes it into the public/ artifact that gets uploaded to GitHub Pages
3. The existing .nojekyll file in static/ prevents Jekyll from processing the deployed site

The Jekyll error occurred because the circular symlink was present in the workspace during the build. With this fix, Hugo will skip that directory entirely, preventing the error. The workflow will build successfully and only upload the clean ./public directory without any problematic symlinks.

Commit: 1d24140

[github-actions]

🔍 Preview Build Complete

The site has been built successfully for this PR!

How to preview:

1. Download the preview artifact from the workflow run
2. Extract the zip file
3. Open index.html in your browser to preview the site

Alternative preview methods:

• Use a local HTTP server: python -m http.server 8000 or npx serve
• Or use VS Code's Live Server extension

Note: The preview uses the GitHub Pages URL (https://eclipse-volttron.github.io/) as the base URL. Links will work correctly when viewing locally.

Build Details:

• PR: Fix build failure from circular symlink in theme submodule #33
• Commit: 1d24140
• Artifact: pr-preview-33