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

File	Location	Purpose
Post	docs/programs/_posts/YYYY-MM-DD-slug.md	Main post file
Source	docs/_includes/src/slug.txt	Applesoft source code
Screenshot	docs/media/slug.png or .gif or .jpg	Full-size image
Thumbnail	docs/media/slug-tn.png	Thumbnail (smaller version)

Post Template

---
layout: post
title: Program Title
date: YYYY-MM-DD
description: Brief description of the program
tags: program one-liner 1mhz-ok
author: Lee Fastenau
screenshot: /media/slug.png
thumbnail: /media/slug-tn.png
source: /src/slug.txt
discussion:
    -
        name: Discussion Link Name
        url: https://example.com/link
---

Description of the program and any usage instructions.

Tag Options

Tag	Description
program	Required for all programs
one-liner	Program fits on one line
two-liner	Program fits on two lines
1mhz-ok	Runs well on 1MHz Apple II
1mhz-slow	Runs slow on 1MHz (triggers warp mode in emulator)
notable	Featured/award-winning program
monochrome	Best viewed in monochrome mode

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

---
layout: post
title: Post Title
date: YYYY-MM-DD HH:MM:SS -0700
tags: updates
author: Lee Fastenau
---

Blog post content here.

Use `<!--more-->` to create an excerpt break.

Common Blog Tags

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

Including Images

Use the img include:

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

Including Code Snippets

Use the applesoft include:

{% capture source_code -%}
0YOUR CODE HERE
{%- 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