Advanced Search
Search Results
39 total results found
Tutorial 2: Adding a Chain
Now let's connect our ring to a chain. Step 1: Update the Pattern Modify first_ring.tatml: pattern "Ring and Chain" { thread: size20, white shuttles: 1 ring1: R(6, p, 6, p, 6) chain1: C(8, join(ring1.picot1), 8, p, 8) } Step 2: U...
Tutorial 3: Creating a Simple Motif
Let's create a complete motif with multiple elements. Step 1: Plan the Pattern We'll create: A center ring with 4 picots Four petal rings, each joining to one picot of the center Chains connecting the petals Step 2: Write the Pattern Create simple_m...
Tutorial 4: Using Multi-Shuttle Patterns
Let's create a two-shuttle pattern for color contrast. Step 1: Two-Shuttle Syntax Create two_shuttle.tatml: pattern "Two Color Flower" { thread: size20, blue shuttles: 2 shuttle1 { // Blue thread - center and structure ...
Tutorial 5: Error Handling and Debugging
Let's intentionally create errors to see how TatML helps you fix them. Step 1: Create a Pattern with Errors Create buggy_pattern.tatml: pattern "Buggy Pattern" { ring1: R(5, p, 5) chain1: C(6, join(ring1.picot3), 6) // Error: ring1 only has 1 pic...
Tutorial 6: Best Practices
Use Descriptive Names // Good - clear purpose center_ring: R(6, p, 6, p, 6, p, 6) petal1: R(4, p, 4, join(center_ring.picot1), 4, p, 4) // Less clear ring1: R(6, p, 6, p, 6, p, 6) ring2: R(4, p, 4, join(ring1.picot1), 4, p, 4) Name Important Picots /...
What's Next?
Now that you understand TatML basics, you can: Explore Advanced Features Pattern imports and reusable motifs Repeat blocks for symmetric patterns Complex multi-shuttle coordination Use TatML Tools Generate different instruction formats Create ...
Advanced Features
Mock Rings For advanced techniques, use mock rings that don't close: mock1: MR(4, p, 4, p, 4) chain1: C(6, join(mock1.picot1), 6) Picot Variations Specify different picot types and sizes: ring1: R(4, p, 4, sp, 4, lp, 4, jp, 4) ring2: R(5, p("5mm"), 5, s...
Project Scope
Primary Goal Create a markup language that solves the precise picot referencing and complex join notation problems identified in existing tatting notation systems. Target Users Pattern Designers - Need precise, unambiguous notation for complex patterns A...
Core Elements (Must Support)
Basic Structural Elements Rings (R) - closed loops of stitches Chains (CH/C) - open sequences of stitches Split Rings (SR) - rings made with two threads Mock Rings (SCMR) - self-closing mock rings Stitch Types Double Stitches (ds) - basic tatting s...
Critical Requirements
Precise Element Identification User Story As someone reading or creating tatting patterns using TatML, I want every ring and chain to have a unique identifier so that complex patterns don't fall victim to the ambiguity introduced by a volume of multiple ring...
Version Roadmap
Version 0.1.2 (Current) Basic rings, chains, picots, joins Mock rings (MR) - self-closing rings that don't actually close Picot variations - small (sp), large (lp), joining (jp) picots Picot length specifications - p("5mm"), sp("1/4\"") Element ID syste...
Technical Requirements
Syntax Design Goals Human readable - tatters can read raw TatML Machine parseable - tools can validate and process Extensible - new elements can be added Compact - not overly verbose for simple patterns Intuitive numbering - 1-based indexing throughout ...
Success Criteria
Version 0.1.2 Goals (Completed) Can represent a simple ring-and-chain pattern Precise picot referencing works correctly Mock rings supported for advanced techniques Picot variations (small, large, joining) supported Picot length specifications work corr...
Design Principles
Precision over brevity - Clear is better than compact Explicit over implicit - Don't make users guess Validation-friendly - Structure enables error checking Backwards compatible - Can convert existing patterns Tool-agnostic - Works with any implementatio...
TatML Syntax Highlighting for Sublime Text
This package provides syntax highlighting for TatML (Tatting Markup Language) files in Sublime Text. Installation Manual Installation Open Sublime Text Go to Preferences → Browse Packages... Create a new folder called TatML Copy these files into the Ta...
TatML Software Bill of Materials (SBOM)
Overview The TatML project includes a comprehensive Software Bill of Materials (SBOM) in SPDX 2.3 format (SBOM.spdx) that documents all components, dependencies, and licensing information for supply chain security and compliance. Package Information TatML v...
Welcome to The Wiki
Welcome to the TatML (Tatting Markup Language) documentation wiki. Getting Started Tutorial - Step-by-step introduction to TatML Quick Reference - Syntax cheat sheet User Guide - Complete documentation Language Reference Language Specification - Fo...
API Reference
TODO from TatML_API_Reference.md
Documentation Checklist
TODO from DOCUMENTATION_CHECKLIST.md