Skip to content

Conversation

@mattstratton
Copy link
Owner

@mattstratton mattstratton commented May 27, 2025

Summary

This PR adds a migration utility script (docs/utils/guest-yml-to-md.sh) to convert guest YAML data files to TOML-frontmatter Markdown files for Hugo. The script:

  • Sets Title from full_name (with fallback), and generates a date field.
  • Migrates all scalar and array fields (except bio, name, and full_name) to TOML frontmatter.
  • Skips object fields with a warning.
  • Outputs the bio field as the Markdown content.
  • Is documented in docs/migration-guide.md with yq install and usage instructions.

Testing Steps

  • Place guest YAML files in data/guests/.
  • Run sh docs/utils/guest-yml-to-md.sh.
  • Verify TOML frontmatter and content in content/guest/.

Context

  • Ensures migration is robust and future-proof for new fields.
  • Keeps TOML frontmatter consistent with existing guest files.

🤖 This was generated by a bot. If you have questions, please contact the maintainers.

…ate migration guide - Script supports all scalar and array fields, skips objects with warning - Title set from full_name, date auto-generated - Updated migration-guide.md with yq instructions and usage details
@mattstratton mattstratton merged commit f729cfb into v2 May 27, 2025
3 of 4 checks passed
@mattstratton mattstratton deleted the feature/guest-yml-to-md-script branch May 27, 2025 14:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants