{{{ knitml }}}

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

wiki:knitml [2009/03/25 17:59]
fiddlinfool
wiki:knitml [2009/03/25 20:32] (current)
fiddlinfool made it clearer that the scope of KnitML was never to include structure-based knitting procedures
Line 10: Line 10:
   * Render a pattern in any language, using conventions familiar to that language and dialect   * Render a pattern in any language, using conventions familiar to that language and dialect
   * Automatically convert English measurements to metric   * Automatically convert English measurements to metric
-  * Size a pattern up or down to any size, not just the sizes that come with the pattern 
   * Recalculate a pattern for your gauge rather than the one that came with the pattern   * Recalculate a pattern for your gauge rather than the one that came with the pattern
   * Explicitly write out highly annoying directions (e.g., "increase 34 stitches evenly over 171 stiches")   * Explicitly write out highly annoying directions (e.g., "increase 34 stitches evenly over 171 stiches")
Line 25: Line 24:
 This package contains: This package contains:
  
-  * KnitML parsers (for both XML and the Knitting Expression Language format)+  * KnitML parsers (for both XML and the Knitting Expression Language)
   * a validation engine to ensure that the pattern provided is knittable   * a validation engine to ensure that the pattern provided is knittable
   * A renderer than can produce human language knitting instructions (currently in English and Spanish)   * A renderer than can produce human language knitting instructions (currently in English and Spanish)
Line 45: Line 44:
 ==== KnitML Specification ==== ==== KnitML Specification ====
  
-The KnitML specification provides a standardized format to write hand knitting instructions in a computer-readable way. It is firmly rooted in the western tradition of process-based crafting notation.+The KnitML specification provides a format to write hand knitting instructions in a way that computers can also understand. It focuses on expressing the process of creating a knitted object from the viewpoint of the pattern designer. This makes it easy to translate certain hand knitting instructions directly to KnitML
  
-This makes it easy to translate certain hand knitting instructions directly to KnitML.  +It was not intended to express the structure of the object produced. It is therefore unlikely to be directly applicable to structure-based crafting notations, like those used in industrial knitting standards ([[JIS L 0201-1995]]).
- +
-Unfortunately this does not provide for the universality inherent in structure based crafting notations, like those used in industrial knitting standards ([[JIS L 0201-1995]]).+
  
 ==== Knitting Expression Language ==== ==== Knitting Expression Language ====
  
-While early KnitML was XML-only, The Knitting Expression Language (KEL) has been added to allow for more compact wiki-style notation of knitting patterns+While early KnitML was only XML basedthe Knitting Expression Language (KEL) has been added to allow for more direct expression. 
-The syntax of KEL (formerly known as groovyKnit) was heavily inspired by [[wp>Groovy]], a Java scripting language.+ 
 +The syntax of KEL (formerly known as GroovyKnit) was heavily inspired by [[wp>Groovy]], a Java scripting language.
  
 Here is a code snippet for a simple test swatch: Here is a code snippet for a simple test swatch:
Line 93: Line 91:
 \\ \\
  
-==== KnitML transformation ====+==== KnitML pattern transformation ====
  
-KnitML transformation is a three-step process:+To produce a readable pattern in a human language involves a three-step process:
  
   * convert (KEL to KnitML)   * convert (KEL to KnitML)
   * validate (the KnitML)   * validate (the KnitML)
   * render (to knitting instructions, in plaintext or HTML)   * render (to knitting instructions, in plaintext or HTML)
 +
 +In KnitML Core Tools 0.5.0 and later, rendering always includes validation, so a separate 'validate' step is no longer needed.
  
 ==== Standardization by Implementation ==== ==== Standardization by Implementation ====
wiki/knitml.1238003961.txt.gz · Last modified: 2009/03/25 17:59 by fiddlinfool
Creative Commons License Knitting Knerds Geek Girls Stitching Bitches Purling Pimps Driven by DokuWiki