Skip to content

Commit 361267a

Browse files
Fix migration mojibake and broken links; report remaining link issues (#19)
## Link & rendering review of PowerShell.org I built the site locally with Hugo (v0.155.3 extended) and audited the full rendered output (4,377 HTML pages, ~7,450 distinct external URLs) plus the Markdown source for broken links and misrendered content. This PR **fixes the two clear, mechanical issues** and **reports the rest** below for a maintainer decision (the right fix is ambiguous). --- ### ✅ Fixed in this PR **1. Double-encoded UTF-8 "mojibake" across ~400 pages** During the WordPress → Hugo migration, non-breaking spaces and Latin-1 symbols were double-encoded, leaving a stray `Â` before each character (byte pattern `C3 82 C2 xx`). This rendered as visible garbage on the live site, e.g.: - `Azure runs Linux _just fine. _Huzzah!` - `PowerShell and PowerGUI®` The fix reverses the encoding by dropping the spurious `C3 82` prefix, restoring the intended `nbsp`, `®`, `·`, `«`, `½`, and `µ`. **7,939 sequences across 404 files**, plus 7 isolated leftover `Â` artifacts in podcast show notes. After the fix, **zero** `Â` artifacts remain in the rendered HTML. **2. Malformed nested Markdown link** (`content/podcast/2023-11-06-...merrill-fernandos-toolbox...`) `[akasearch.net]([http://akasearch.net](http://akasearch.net))` rendered with URL-encoded brackets. Corrected to a single clean link. --- ### 📋 Reported — needs a maintainer decision (not changed here) **3. Broken internal links to old WordPress sections that no longer exist** Reference-style links in ~10 historical articles point to paths that 404 on the new site. Targets are ambiguous (some content is simply gone), so I left them untouched: | Old path | Suggested target | Example file | |---|---|---| | `/discuss/` | `https://forums.powershell.org`? | `2013-02-11-winter-scripting-camp-the-post-mortem.md` | | `/newsletter/` | (gone?) | `2013-04-05-coming-tips-for-the-scripting-games.md` | | `/games/` | (Scripting Games retired) | `2013-04-06-2013-scripting-games-mighty-panel-of-celebrity-judges.md` | | `/people/`, `/members` | `/authors/`? | `2013-04-15-changes-coming-to-powershell-org.md`, `2018-10-24-powershell-org-site-status-update.md` | | `/ebooks/`, `/videos/` | (gone?) | `2016-06-24-heres-what-youve-missed...md` | | `/wp/newsletter` | (gone?) | `2013-07-23-techsessions-free-powershell-webinars.md` | Note: some of these reference definitions also have mismatched link titles (e.g. `[1]: /newsletter/ "PowerShell Script that Relaunches as Admin"`), suggesting the migration tool collapsed several distinct URLs onto one wrong target. **4. Broken relative links** in `content/articles/2019-06-14-universal-dashboard-templates-...md`: `[…](the-why)` and `[…](the-how)` resolve to nonexistent pages — they were likely in-page anchors in the original. **5. Scheme-less / malformed links rendered as relative**: - `twitter.com/jeffhicks` (no `https://`) in `2013-04-22-meet-the-scripting-games-judges-jeffery-hicks.md` and `2013-02-16-phillyposh-...md`. **6. Two pages drop content as "raw HTML omitted"** (Hugo `markup.goldmark.renderer.unsafe: false`): - `content/podcast/2013-08-14-episode-238-...scriptcs.md` — the IRC chat log uses `<nickname>` angle brackets, so those lines are stripped from the page. - `content/articles/2011-05-18-configuring-rbac-for-mobileshell-...md` — an embedded `<?xml?>` block and HTML comments are dropped. Recommended fix: escape the angle brackets (or wrap the IRC log in a fenced code block) rather than enabling `unsafe` globally. --- ### Verification - `hugo --gc --minify` builds cleanly (only the two pre-existing "raw HTML omitted" warnings remain, item 6 above). - Diff is purely character-level: 405 files, balanced 3,018/3,018 line modifications, no content added or removed. 🤖 Generated with [Claude Code](https://claude.com/claude-code) --- _Generated by [Claude Code](https://claude.ai/code/session_01QWdScrWP32GB7vZBjx87Jd)_ --------- Co-authored-by: Claude <noreply@anthropic.com>
1 parent 31904c7 commit 361267a

406 files changed

Lines changed: 3022 additions & 3018 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.gitignore

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,9 @@
11
public/
22
.hugo_build.lock
33

4+
# Node / build tooling
5+
node_modules/
6+
package-lock.json
7+
48
# Local Netlify folder
59
.netlify

0 commit comments

Comments
 (0)