YAFA-site Link Checker Report: Fixing Broken Links

by Rajiv Sharma 51 views

Hey guys,

We've got a link checker report for the scillidan/YAFA-site, and it looks like we have some broken links to fix! This is super important for keeping our site user-friendly and making sure everyone can access the resources they need. Let's dive into the details and see what needs fixing.

Overview

First up, a quick summary of the link check:

Status Count
🔍 Total 423
✅ Successful 342
⏳ Timeouts 2
🔀 Redirected 0
👻 Excluded 0
❓ Unknown 0
🚫 Errors 78

We have a total of 423 links checked, with 342 working perfectly. However, we've got 78 errors, which we need to address. There were also a couple of timeouts, which might be temporary, but we'll keep an eye on them.

Detailed Error Analysis

Now, let's break down the errors by file. This will help us pinpoint exactly where the broken links are and fix them efficiently.

Errors in docs/archive/deploy-sites-to-vps_archive.md

In the deploy-sites-to-vps_archive.md file, we have the following issue:

This looks like a classic 404 error, meaning the link is broken or the page has been moved. We need to update this link or remove it if the resource is no longer available. Ensuring our deployment documentation is accurate is crucial for our users, so let's prioritize fixing this.

Errors in docs/archive/play-lyrics-with-mpv_archive.md

This file has a bunch of errors, so let's break it down:

  • File Not Found Errors:

    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/archive/baby-seal.jpg> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/archive/cover.png> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/archive/covers.jpg> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/archive/disable-subtile.jpg> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/archive/lets-play-birds.jpg> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/archive/orca.jpg> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/archive/pinyin.jpg> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/archive/play-folder.jpg> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/archive/show-srt.jpg> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/archive/sinus.jpg> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/archive/toggle-cover.jpg> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/archive/uosc.jpg> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/archive/video-cover.gif> | Cannot find file

    These errors indicate that the image files are missing from the specified paths. We need to either restore these files or update the links in the document. Image links are vital for a good user experience, so let’s get these sorted.

  • Rejected Status Codes (403 Forbidden):

    A 403 Forbidden error means we don't have permission to access these resources. This could be due to the site blocking our requests or the pages being moved. We should review these links and either find alternatives or remove them. Ensuring our links are accessible is key to providing reliable information.

Errors in docs/blog/deploy-static-web-to-rocky-linux.md

Here’s what we found in this file:

  • File Not Found Errors:

    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/deploy_cps.png> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/rocky-linux-apache.png> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/winsshterm.png> | Cannot find file

    Just like before, these image files are missing. We need to locate them or update the links. Visual aids are super helpful in deployment guides, so let's fix this.

  • Rejected Status Codes:

    These errors indicate various issues, from a Bad Request (400) to a Not Found (404) and a Forbidden (403). We need to investigate each one to determine the best course of action, whether it's updating the link or finding a replacement. Reliable documentation is essential for our users deploying static websites.

Errors in docs/blog/e-dictionaries-plugin.md

This file also has several errors:

  • File Not Found Errors:

    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/epubviewer_01.png> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/epubviewer_02.png> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/etymonline.png> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/hong-lou-meng_cover.jpg> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/hong-lou-meng_shuoming.jpg> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/immersivetranslate.png> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/odh.png> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/saladict_the-malay-archipelago.png> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/yomichan_android.jpg> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/yomichan_epub_02.png> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/yomichan_pdf_01.png> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/yomichan_pdf_02.png> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/zdic.png> | Cannot find file

    These missing image files need our attention. Images are crucial for illustrating how e-dictionaries work, so let's get these fixed.

  • Rejected Status Codes:

    These 404 and 403 errors mean we have broken links to external resources. We should review these links, find alternatives, or remove them. Providing accurate and up-to-date information is vital for our users.

Errors in docs/blog/goldendict-expand.md

Let's see what's up with this file:

  • File Not Found Errors:

    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/cambridge-dictionary.png> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/deep-translator.png> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/dictd.png> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/libretrans.png> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/pylanguagetool.png> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/scripts.png> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/sentences.png> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/tencenttrans_22.png> | Cannot find file

    Again, we have missing image files. Visuals are super important for explaining Goldendict expansions, so we need to address these.

  • Timeouts:

    Timeouts could be temporary issues, but we should monitor these links. If they persist, we might need to find alternative resources. Ensuring our resources are accessible is key.

  • Rejected Status Code:

    A 403 error means we don't have permission to access this resource. We should review this link and either find an alternative or remove it. Providing accurate links to resources is crucial for our users.

Errors in docs/blog/goldendict.md

Let's check this file:

  • File Not Found Errors:

    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/dark-theme.png> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/full-text-search.png> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/spellcheck.png> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/wiki.png> | Cannot find file

    More missing image files! We need to restore these or update the links. Illustrations are essential for demonstrating Goldendict features, so let's get this sorted.

  • Rejected Status Code:

    Another 403 error. We should review this link and either find an alternative or remove it. Reliable links to pronunciation resources are important for our users.

Errors in docs/blog/make-la.isla.minima.2014.chs.esp.ass.md

Here's what we found in this file:

  • File Not Found Errors:

    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/alass.png> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/autosub.png> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/goldendict.png> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/La.isla.minima.2014.mkv_snapshot_00.03.26.png> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/La.isla.minima.2014.mkv_snapshot_00.03.51.png> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/La.isla.minima.2014.mkv_snapshot_00.16.09.png> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/La.isla.minima.2014.mkv_snapshot_01.07.58.png> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/La.isla.minima.2014.mt.jpg> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/saladict.png> | Cannot find file

    Lots of missing images here. Screenshots and visual aids are super helpful for tutorials, so let's fix these.

  • Rejected Status Codes and Network Errors:

    These errors range from Bad Request (400) and Forbidden (403) to Not Found (404) and a network error. We need to investigate each one and find suitable replacements or remove the links. Ensuring the tutorial is well-supported with accurate links is essential.

Errors in docs/blog/play-lyrics-with-mpv.md

Finally, let's look at this file:

  • File Not Found Errors:

    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/mpv-lrc.gif> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/mpv-lrc.jpg> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/mpvacious.png> | Cannot find file
    • [ERROR] <file:///home/runner/work/YAFA-site/YAFA-site/docs/blog/uosc_mpv-cheatsheet.png> | Cannot find file

    We have missing image files again. Visuals are super important for guides, so let's fix these.

  • Cached Rejected Status Codes:

    These cached 403 errors suggest we had issues accessing these resources before. We should review these links and either find alternatives or remove them. Reliable links are crucial for our users.

Next Steps

Okay, guys, that's a lot of broken links! Here’s what we need to do:

  1. Locate Missing Files: We need to find the missing image files and restore them to the correct directories. If they’re no longer needed, we should remove the broken image links from the documents.
  2. Review Rejected Status Codes: For the 403 Forbidden and 404 Not Found errors, we need to check if the resources have moved or if there are alternative links we can use. If not, we should remove the broken links.
  3. Monitor Timeouts: We’ll keep an eye on the timeout errors to see if they resolve themselves. If they persist, we’ll need to find alternative resources.

By addressing these issues, we can ensure our site remains a valuable resource for everyone. Let's get to work and make these fixes!

Full Github Actions output