Skip to main content

Getting Started

Your First Pattern

Here's a simple ring and chain pattern in TatML:

tatml
pattern "My First Pattern" {
    thread: size20, white
    shuttles: 1
    
    ring1: R(6, p, 6, p, 6)
    chain1: C(8, join(ring1.picot1), 8, p, 8)
    ring2: R(4, join(chain1.picot1), 4, p, 4)
}

This creates:

  1. A ring with 18 stitches and 2 picots
  2. A chain that joins to the first picot of ring1
  3. Another ring that joins to the chain's picot

Running TatML

To process this pattern:

# Parse and validate
python3 tatml_parser.py my_pattern.tatml

# Generate text instructions
python3 tatml_formatter.py my_pattern.tatml

# Create diagram
python3 tatml_diagram.py my_pattern.tatml