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:
- Type: Program or blog post?
- Title: What should it be called?
- 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
markdown1--- 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
| 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
markdown1--- 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 announcementsemulation- Emulator-related content
Including Images
Use the img include:
liquid1{% include img.html src="/assets/images/post/image-name.png" caption="Image caption" alt="Alt text description" %}
Including Code Snippets
Use the applesoft include:
liquid1{% 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-DDorYYYY-MM-DD HH:MM:SS -0700for 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.pngsuffix, 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
programplus 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
