Hugo Migrate

Jekyll to Hugo Migration

Migrate existing Jekyll blog posts to Hugo format.

Source

The old blog source path is read from .claude/blog.local.md (jekyll_source field). If not configured, prompt the user for the path (Jekyll Now, GitHub Pages):

• Posts in _posts/ with YYYY-M-DD-slug.md format
• Images in images/
• Subdirectories for drafts and other content

Workflow

1. Scan Source

Scan the configured Jekyll source directory _posts/ for .md files. Skip subdirectories unless user requests them explicitly. Present a summary:

Found 30 posts (2014-2021)
- 27 published posts
- 3 unpublished/draft posts
Subdirectories: home-drafts (3 files), misc (1 file)

Ask: "Migrate all published posts? Include drafts?"

2. Convert Each Post

For each selected post:

Filename: Convert YYYY-M-DD-slug.md to YYYY-MM-DD-slug.md (zero-pad month/day)

Frontmatter: Convert Jekyll to Hugo format:

Jekyll	Hugo	Notes
layout: post	Remove	Hugo uses section-based layouts
title	title	Keep as-is
published: false	draft: true	Invert logic
(missing date)	date: YYYY-MM-DD	Extract from filename
(no description)	description: ""	Flag for manual addition
(no tags)	tags: []	Flag for manual addition
(no license)	license: "CC BY 4.0"	Add

Content:

• Remove <!-- more --> (Hugo uses <!--more--> without spaces)
• Convert image paths: ../images/foo.jpg to /images/foo.jpg or page bundle
• Convert Jekyll liquid tags ({% highlight %}) to Hugo shortcodes or fenced code blocks

3. Copy Images

cp -r <source>/images/ static/images/

4. Migration Report

Migrated: 27 posts
Issues:
- 5 posts missing descriptions (SEO)
- 3 posts have no tags
- 2 posts reference images not found in images/

5. Create Brainstorm Docs for Drafts

If the blog plugin is installed, offer to create brainstorm documents for unfinished drafts found during migration. These represent ideas that fit the blog plugin's brainstorm pipeline.