beautifulhugo博客标签链接失效问题求助（基于RStudio/blogdown）

Hey there! Let's work through this broken link problem you're facing with your blog built using blogdown, RStudio, and the beautifulhugo theme. It sounds like the core issue is that some links are being generated incorrectly—either as absolute paths pointing to a non-local domain, or using hardcoded URLs that don't match your local preview environment.

Root Cause #

Most likely, the theme's template files are using hardcoded absolute links (like /tags/your-tag) instead of Hugo's built-in link functions that adjust based on your baseURL setting. When you're previewing locally with serve_site(), Hugo runs on localhost:1313, so those hardcoded links might be trying to go to a non-existent external domain, hence the "no network connection" error.

One-Time Fix Approach #

Since you already fixed the "View All" button by adjusting its link logic, you can apply the same pattern to all other broken links across the theme. Here's how to do it systematically:

1. Locate the relevant template files

   • Homepage tag links: Check layouts/partials/header.html or layouts/index.html (wherever your top navigation tags are rendered)
   • Single post tag links: Look in layouts/_default/single.html (where tags are displayed below your posts)
   • Tag page links: Verify layouts/tags/list.html or layouts/tags/single.html

2. Replace hardcoded links with Hugo's link functions
   Instead of writing links like <a href="/tags/{{ .Name }}">{{ .Name }}</a>, use Hugo's relURL function to generate relative paths that work both locally and in production:

   <a href="{{ relURL (print "/tags/" .Name) }}">{{ .Name }}</a>
   

   Alternatively, if you want to ensure absolute URLs that respect your baseURL, use absURL instead:

   <a href="{{ absURL (print "/tags/" .Name) }}">{{ .Name }}</a>
   

   For the "View All" links you already fixed, you probably used a similar adjustment—this same logic applies to all tag-related links.

3. Adjust your config.toml for local preview
   Make sure your baseURL is set correctly for local development. In config.toml, set:

   baseURL = "/"
   

   When you're ready to deploy to GitHub Pages or another host, update this to your actual domain (like https://yourusername.github.io/your-blog/). This ensures Hugo generates links that match your environment.

4. Test thoroughly
   After making these changes, restart serve_site() in RStudio and test:

   • Homepage tag clicks
   • Single post tag links
   • "View All" buttons on tag pages
     All should now navigate correctly without network errors.

Why This Works #

Hugo's relURL and absURL functions dynamically generate links based on your baseURL configuration. This eliminates the problem of hardcoded paths that don't align with your local preview or production environment.

内容的提问来源于stack exchange，提问作者oioioi