dart-lang/publish_blog

Publish Blog Article

Overview

Use this skill to add a new article to the Dart blog by extracting content from a Google Doc, formatting it, and placing it in the correct directory.

Workflow

1. Get content and images from Google Doc

• [ ] Ask the user to provide a link to the Google Doc.
• [ ] In your browser, open the Google Doc.
• [ ] Download the document as a Web Page (.html, zipped) via File > Download > Web Page (or ask the user to provide the zip if download fails).
• [ ] Extract the text content from the downloaded HTML file and convert it to Markdown.
• [ ] Extract the images from the images/ folder in the zip file.
• [ ] Create a new folder for the blog post in src/content/blog/ using a concise title.
• [ ] Save the markdown content to index.md and move the images to the images/ directory in that folder.
• [ ] Reference the images in the markdown file using <DashImage> or standard markdown image tags as appropriate.

2. Format the markdown

• [ ] Apply semantic line breaks to any lines over 80 characters, following the guidelines in semantic_breaks.md.
• [ ] Ensure there is a blank line after each heading.

3. Add the author

• [ ] Ask the user to provide the author's github handle. Search in src/data/authors/ for the handle. If the author is not found, create a new author YAML file. Add the image and any other metadata you can find from the user's github profile.
• [ ] Update the frontmatter for the blog post with the author's handle.

4. Review

• [ ] Don't create a PR until the user has looked over the article.