Skip to content

fix(content): convert leftover WPBakery shortcodes to clean markdown#37

Merged
HeyItsGilbert merged 1 commit into
mainfrom
fix/legacy-wpbakery-shortcodes
Jun 23, 2026
Merged

fix(content): convert leftover WPBakery shortcodes to clean markdown#37
HeyItsGilbert merged 1 commit into
mainfrom
fix/legacy-wpbakery-shortcodes

Conversation

@HeyItsGilbert

Copy link
Copy Markdown
Member

What

20 migrated posts (12 podcast, 8 articles) still contained raw WPBakery / Visual Composer shortcodes ([vc_row][vc_column][vc_column_text]…) left over from the WordPress migration. Because the site builds with markup.goldmark.renderer.unsafe: false, the brackets weren''t interpreted — they showed up as literal text on the published pages.

How

Rather than blindly stripping every [vc_*] (which would delete real content), structural wrappers are unwrapped and content-bearing shortcodes are converted:

Shortcode Becomes
vc_row / vc_column / vc_column_text / vc_empty_space / *_inner removed (unwrapped)
vc_video link=… Hugo {{< youtube ID >}} embed under a Watch: label
vc_custom_heading / vc_cta / vc_toggle / vc_tta_section markdown headings + body
vc_btn and linked headings markdown links (URL-decoded)
vc_single_image (WP media IDs, no source files in repo) dropped

The badly-broken 2021-05-05-automation-summit.md team roster (destructured into orphaned names) was rewritten as a clean markdown list, and dead "Contact form not found" placeholders were removed.

The migration script (scripts/migrate-posts.cjs) is intentionally untouched — its source tree no longer exists, so these were one-time in-place fixes.

Verification

  • grep for [vc_ / [/vc_ across content/0 matches
  • hugo --gc builds cleanly (2367 pages, no template/markdown errors)
  • Swept entire rendered public/no stray shortcodes anywhere
  • Spot-checked rendered pages: episode 336 shows the YouTube iframe; automation-summit shows all 5 team Twitter links and no contact-form error; then-now renders the Twitch heading link and "Join us on Twitch" button
  • Podcast podcast_url front matter untouched, so audio players are unaffected

🤖 Generated with Claude Code

20 migrated posts (12 podcast, 8 articles) still contained raw
`[vc_row][vc_column]...` WPBakery/Visual Composer shortcodes that rendered
as literal text (the site builds with goldmark unsafe:false).

Unwrap structural shortcodes and convert the content-bearing ones instead
of dropping them:
- vc_video    -> Hugo {{< youtube ID >}} embed under a "Watch:" label
- vc_custom_heading / vc_cta / vc_toggle / vc_tta_section -> markdown headings + body
- vc_btn and linked headings -> markdown links (URL-decoded)
- vc_single_image (unrecoverable WP media IDs) -> dropped

Also rewrite the badly-broken automation-summit team roster as a clean
markdown list and remove dead "Contact form not found" placeholders.

Verified: zero vc_ shortcodes remain in content/ and in the rendered site;
hugo build is clean.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Q2NJsYE8nUKKHD25jXiHV1
@netlify

netlify Bot commented Jun 23, 2026

Copy link
Copy Markdown

Deploy Preview for powershellorg ready!

Name Link
🔨 Latest commit e977b77
🔍 Latest deploy log https://app.netlify.com/projects/powershellorg/deploys/6a39dbd69a907b00085aac1b
😎 Deploy Preview https://deploy-preview-37--powershellorg.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@HeyItsGilbert HeyItsGilbert enabled auto-merge (rebase) June 23, 2026 01:07
@HeyItsGilbert HeyItsGilbert disabled auto-merge June 23, 2026 01:14
@HeyItsGilbert HeyItsGilbert merged commit da51c9f into main Jun 23, 2026
5 checks passed
@HeyItsGilbert HeyItsGilbert deleted the fix/legacy-wpbakery-shortcodes branch June 23, 2026 01:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant