Creating New Content

This skill guides you through creating new program posts or blog posts for the Apple II Programs Jekyll site.

Content Types

Program Post: Showcases an Apple II Applesoft BASIC program with source code, screenshot, and description.

Blog Post: General updates, announcements, or articles about the site or Apple II topics.

Quick Start

Ask the user:

1. Type: Program or blog post?
2. Title: What should it be called?
3. Date: Use today's date or a specific date?

For programs, also ask: 4. Program type: One-liner or two-liner? 5. Performance: Runs OK at 1MHz or slow? 6. Source code: Provide the Applesoft BASIC code

Creating a Program Post

Required Files

Post Template

markdown
1---
2layout: post
3title: Program Title
4date: YYYY-MM-DD
5description: Brief description of the program
6tags: program one-liner 1mhz-ok
7author: Lee Fastenau
8screenshot: /media/slug.png
9thumbnail: /media/slug-tn.png
10source: /src/slug.txt
11discussion:
12    -
13        name: Discussion Link Name
14        url: https://example.com/link
15---
16
17Description of the program and any usage instructions.

Tag Options

Source File Format

Create docs/_includes/src/slug.txt with the raw Applesoft code. Each logical line should be on its own line:

0HGR2:FORN=1TO100:HCOLOR=RND(1)*7+1:HPLOTX,Y:NEXT

For two-liners, use two lines:

0FIRST LINE OF CODE HERE
1SECOND LINE OF CODE HERE

Creating a Blog Post

Post Template

markdown
1---
2layout: post
3title: Post Title
4date: YYYY-MM-DD HH:MM:SS -0700
5tags: updates
6author: Lee Fastenau
7---
8
9Blog post content here.
10
11Use `<!--more-->` to create an excerpt break.

Common Blog Tags

• updates - Site updates and announcements
• emulation - Emulator-related content

Including Images

Use the img include:

liquid
1{% include img.html src="/assets/images/post/image-name.png" caption="Image caption" alt="Alt text description" %}

Including Code Snippets

Use the applesoft include:

liquid
1{% capture source_code -%}
20YOUR CODE HERE
3{%- endcapture %}{% include applesoft.md src=source_code %}

Naming Conventions

• Slug: Lowercase, hyphen-separated (e.g., my-program-name)
• Date format: YYYY-MM-DD or YYYY-MM-DD HH:MM:SS -0700 for specific times
• Filename: YYYY-MM-DD-slug.md

Media Guidelines

• Screenshots: Use PNG for static, GIF for animated, JPG for photos
• Thumbnails: Should be -tn.png suffix, smaller version of screenshot
• Place all media in docs/media/

Checklist

Program Post

• Create post file: docs/programs/_posts/YYYY-MM-DD-slug.md
• Create source file: docs/_includes/src/slug.txt
• Add screenshot: docs/media/slug.png|gif|jpg
• Add thumbnail: docs/media/slug-tn.png
• Frontmatter includes: layout, title, date, description, tags, author, screenshot, thumbnail, source
• Tags include program plus line count and performance tags

Blog Post

• Create post file: docs/_posts/YYYY-MM-DD-slug.md
• Frontmatter includes: layout, title, date, tags, author
• Add images to docs/assets/images/post/ if needed