TatML

TatML (Tatting Markup Language) is designed to solve the precision problems in traditional tattin...

Your First Pattern Here's a simple ring and chain pattern in TatML: pattern "My First Pattern" ...

Pattern Structure Every TatML file starts with a pattern declaration: pattern "Pattern Name" { ...

Rings Basic ring syntax: ring1: R(stitches, p, stitches, p, stitches) Examples: // Simple rin...

Multi-Shuttle Patterns pattern "Two Shuttle Example" { shuttles: 2 shuttle1 { ...

Common Errors Duplicate Elements Element ring1 already defined Each element needs a unique I...

Check the TatML Specification for detailed syntax rules Run validation to catch errors early ...

Basic Pattern Structure pattern "Pattern Name" { thread: size20, white shuttles: 1 ...

What You'll Learn By the end of this tutorial, you'll know how to: Write basic TatML patterns...

Let's start with the simplest possible pattern - a single ring. Step 1: Create the Pattern File ...

Now let's connect our ring to a chain. Step 1: Update the Pattern Modify first_ring.tatml: pat...

Let's create a complete motif with multiple elements. Step 1: Plan the Pattern We'll create: ...

Let's create a two-shuttle pattern for color contrast. Step 1: Two-Shuttle Syntax Create two_sh...

Let's intentionally create errors to see how TatML helps you fix them. Step 1: Create a Pattern ...

Use Descriptive Names // Good - clear purpose center_ring: R(6, p, 6, p, 6, p, 6) petal1: R(4,...

Now that you understand TatML basics, you can: Explore Advanced Features Pattern imports an...

Mock Rings For advanced techniques, use mock rings that don't close: mock1: MR(4, p, 4, p, 4) ...

This package provides syntax highlighting for TatML (Tatting Markup Language) files in Sublime Te...

TatML (Tatting Markup Language) is a domain-specific language for describing tatting lace pattern...

Keywords These are what are called reserved words, which means you can't use these as your varia...

Pattern Structure Pattern := "pattern" String "{" PatternBody "}" PatternBody := Import* Metada...

Element Identification All rings and chains must have unique identifiers within pattern scope ...

Structural Validation All referenced elements must exist All referenced picots must exist on ...

Built-In Functions join(reference) // Basic join to picot join(ref1, ref2) // ...

Simple Pattern Reference import "./motifs/basic_flower.tatml" as flower pattern "Garden" { ...

Import Errors File not found Invalid TatML in imported file Circular import dependencies Pa...

Reusable Motif Definition // File: motifs/flower_center.tatml pattern "Flower Center" { th...

Parser Requirements Module system for import resolution Symbol table with namespace support ...

Primary Goal Create a markup language that solves the precise picot referencing and complex join...

Basic Structural Elements Rings (R) - closed loops of stitches Chains (CH/C) - open sequences...

Precise Element Identification User Story As someone reading or creating tatting patterns using...

Version 0.1.2 (Current) Basic rings, chains, picots, joins Mock rings (MR) - self-closing rin...

Syntax Design Goals Human readable - tatters can read raw TatML Machine parseable - tools can...

Version 0.1.2 Goals (Completed) Can represent a simple ring-and-chain pattern Precise picot r...

Precision over brevity - Clear is better than compact Explicit over implicit - Don't make user...

Overview The TatML project includes a comprehensive Software Bill of Materials (SBOM) in SPDX 2....

TODO from TatML_API_Reference.md

TODO from DOCUMENTATION_CHECKLIST.md