Skip to main content

Tutorial 1: Your First Ring

Let's start with the simplest possible pattern - a single ring.

Step 1: Create the Pattern File

Create a new file called first_ring.tatml:

pattern "My First Ring" {
    thread: size20, white
    shuttles: 1
    
    ring1: R(6, p, 6, p, 6)
}

Step 2: Understanding the Syntax

Let's break this down:

  • pattern "My First Ring" - declares the pattern with a name
  • thread: size20, white - specifies thread size and color
  • shuttles: 1 - indicates this is a single-shuttle pattern
  • ring1: R(6, p, 6, p, 6) - creates a ring with:
    • 6 double stitches
    • 1 picot
    • 6 double stitches  
    • 1 picot
    • 6 double stitches

Step 3: Validate Your Pattern

Run the validator to check for errors:

python3 tatml_validator.py first_ring.tatml

You should see: ✓ No validation issues found

Step 4: Generate Instructions

Pattern: My First Ring
======================

Materials:
  Thread: size20, white
  Shuttles: 1

Instructions:
1. Ring: 6 ds, picot, 6 ds, picot, 6 ds, close
   (18 stitches, 2 picots)

Back to top