Help with htmlproofer Errors: Missing References and Invalid Internal Links

[rafisics]

Checklist

• I have read and accepted the contributing guidelines.

How did you create the site?

Built from jekyll-theme-chirpy

Description

I'm currently using the following workflow on this site:

name: "Build and Deploy"
on:
  push:
    branches:
      - main
      - master
    paths-ignore:
      - .gitignore
      - README.md
      - LICENSE

  # Allows you to run this workflow manually from the Actions tab
  workflow_dispatch:

permissions:
  contents: read
  pages: write
  id-token: write

# Allow one concurrent deployment
concurrency:
  group: "pages"
  cancel-in-progress: true

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          fetch-depth: 0
          # submodules: true
          # If using the 'assets' git submodule from Chirpy Starter, uncomment above
          # (See: https://github.com/cotes2020/chirpy-starter/tree/main/assets)

      - name: Setup Pages
        id: pages
        uses: actions/configure-pages@v4

      - name: Setup Ruby
        uses: ruby/setup-ruby@v1
        with:
          ruby-version: 3.3
          bundler-cache: true

      - name: Build site
        run: bundle exec jekyll b -d "_site${{ steps.pages.outputs.base_path }}"
        env:
          JEKYLL_ENV: "production"

      - name: Test site
        run: |
          bundle exec htmlproofer _site \
            \-\-disable-external \
            \-\-ignore-urls "/^http:\/\/127.0.0.1/,/^http:\/\/0.0.0.0/,/^http:\/\/localhost/"

      - name: Upload site artifact
        uses: actions/upload-pages-artifact@v3
        with:
          path: "_site${{ steps.pages.outputs.base_path }}"

  deploy:
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    runs-on: ubuntu-latest
    needs: build
    steps:
      - name: Deploy to GitHub Pages
        id: deployment
        uses: actions/deploy-pages@v4

Here htmlproofer is used to check my Jekyll site after building it, and I'm encountering several errors that I'm struggling to understand and resolve. Here are the two main types of issues I’m facing:

1. Missing href references in <a> tags

I'm seeing the following errors in my site files:

'a' tag is missing a reference

This is happening across multiple pages in my _site directory, such as:

• 404.html
• about/index.html
• blogging/tutorial/customize-the-favicon/index.html
• and others.

It seems that htmlproofer is flagging <a> tags that are missing href attributes. I’ve checked my templates and content files, but I can’t seem to figure out why these links are missing references. Does anyone have suggestions for how to fix this?

2. Invalid internal links

I’m also getting warnings about internal links that point to non-existent pages:

internally linking to /chirpy-test/blogging, which does not exist

For example:

• blogging/tutorial/write-a-new-post/index.html is linking to ../text-and-typography/
• Several tags and categories pages are linking to paths like /chirpy-test/getting-started/ that don’t exist.

Could someone guide me on how to fix these broken internal links or why they might be incorrectly pointing to these paths?

Operations you have already tried

I’ve tried the following solutions:

• Double-checking my _config.yml for any misconfigurations.
• Ensuring all necessary files exist in the correct locations.
• Rebuilding the site to make sure the changes are reflected.

But I’m still facing these errors.

Anything else?

No response

[rafisics]

I am getting these errors:

  bundle exec htmlproofer _site \
    \-\-disable-external \
    \-\-ignore-urls "/^http:\/\/127.0.0.1/,/^http:\/\/0.0.0.0/,/^http:\/\/localhost/"
  shell: /usr/bin/bash -e {0}
  env:
    GITHUB_PAGES: true
Running 3 checks (Images, Links, Scripts) in ["_site"] on *.html files ...


Checking 134 internal links
Checking internal link hashes in 7 files
Ran on 24 files!


For the Links check, the following failures were found:

* At _site/chirpy-test/404.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/404.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/about/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/about/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/blogging/demo/text-and-typography/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/blogging/demo/text-and-typography/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/blogging/tutorial/customize-the-favicon/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/blogging/tutorial/customize-the-favicon/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/blogging/tutorial/getting-started/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/blogging/tutorial/getting-started/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/blogging/tutorial/write-a-new-post/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/blogging/tutorial/write-a-new-post/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/categories/blogging/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/categories/blogging/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/categories/demo/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/categories/demo/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/categories/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/categories/tutorial/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/categories/tutorial/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/cv/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/cv/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/demo/pwa-testing/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/demo/pwa-testing/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/posts/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/resources/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/resources/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/tags/favicon/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/tags/favicon/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/tags/getting-started/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/tags/getting-started/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/tags/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/tags/pwa/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/tags/pwa/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/tags/testing/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/tags/testing/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/tags/typography/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/tags/typography/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/tags/writing/index.html:1:

  'a' tag is missing a reference

* At _site/chirpy-test/tags/writing/index.html:1:

  'a' tag is missing a reference

For the Links > Internal check, the following failures were found:

* At _site/chirpy-test/blogging/tutorial/write-a-new-post/index.html:109:

  internally linking to ../text-and-typography/, which does not exist

* At _site/chirpy-test/categories/blogging/index.html:1:

  internally linking to /chirpy-test/blogging, which does not exist

* At _site/chirpy-test/categories/demo/index.html:1:

  internally linking to /chirpy-test/demo, which does not exist

* At _site/chirpy-test/categories/tutorial/index.html:1:

  internally linking to /chirpy-test/tutorial, which does not exist

* At _site/chirpy-test/tags/favicon/index.html:1:

  internally linking to /chirpy-test/favicon, which does not exist

* At _site/chirpy-test/tags/getting-started/index.html:1:

  internally linking to /chirpy-test/getting-started, which does not exist

* At _site/chirpy-test/tags/pwa/index.html:1:

  internally linking to /chirpy-test/pwa, which does not exist

* At _site/chirpy-test/tags/testing/index.html:1:

  internally linking to /chirpy-test/testing, which does not exist

* At _site/chirpy-test/tags/typography/index.html:1:

  internally linking to /chirpy-test/typography, which does not exist

* At _site/chirpy-test/tags/writing/index.html:1:

  internally linking to /chirpy-test/writing, which does not exist


HTML-Proofer found 50 failures!
Error: Process completed with exit code 1.

[LuizMeier]

hey were you able to solve this? I'm having a very similar issue with the htmlproofer links

I solved that when I solved the localization problem with Polyglot. Please read my previous messages.

[walmic02]

I solved that when I solved the localization problem with Polyglot. Please read my previous messages.
Hi, yeah i saw that but I just wanted to see if there was anything else you had to do in order to solve it. I think my problem has a different source since I'm only using one language. Thanks for the reply

[LuizMeier]

I solved that when I solved the localization problem with Polyglot. Please read my previous messages.
Hi, yeah i saw that but I just wanted to see if there was anything else you had to do in order to solve it. I think my problem has a different source since I'm only using one language. Thanks for the reply

Please paste here what is the error you're having to check if it is the same. I'm not a proper developer, but we can try to help :).

[walmic02]

I solved that when I solved the localization problem with Polyglot. Please read my previous messages.
Hi, yeah i saw that but I just wanted to see if there was anything else you had to do in order to solve it. I think my problem has a different source since I'm only using one language. Thanks for the reply

Please paste here what is the error you're having to check if it is the same. I'm not a proper developer, but we can try to help :).

Thanks man, i really appreciate that! I actually opened a new discussion here if you wanna take a look. I'm not sure if i explained it the best but I appreciate you checking it out.

[LuizMeier]

I solved that when I solved the localization problem with Polyglot. Please read my previous messages.
Hi, yeah i saw that but I just wanted to see if there was anything else you had to do in order to solve it. I think my problem has a different source since I'm only using one language. Thanks for the reply

Please paste here what is the error you're having to check if it is the same. I'm not a proper developer, but we can try to help :).

Thanks man, i really appreciate that! I actually opened a new discussion here if you wanna take a look. I'm not sure if i explained it the best but I appreciate you checking it out.

Hey, bro, I've given a look on your thread there and the errors apparently are not the same. What I can tell you is that to solve mine I just asked for github copilot to help me with the code.