Changes between Version 4 and Version 5 of MarkupBuilder

Timestamp:

Aug 2, 2006, 10:19:42 AM (18 years ago)

Author:

cmlenz

Comment:

Document fragment creation

MarkupBuilder

@@ -1 +1 @@
 = Generating Markup Programmatically =
 
-Markup provides a [wiki:ApiDocs/MarkupBuilder builder] module which lets you generate markup from Python code using a very simple syntax.
+Markup provides a [wiki:ApiDocs/MarkupBuilder builder] module which lets you generate markup from Python code using a very simple syntax. The main entry point to the `builder` module is the `tag` object (which is actually an instance of the `ElementFactory` class). You should rarely (if ever) need to directly import and use any of the other classes in the `markup.builder` module.
 
-The main entry point to the `builder` module is the `tag` object (which is actually an instance of the `ElementFactory` class). Elements can be created through this `tag` object using attribute access, for example:
+== Creating Elements ==
+
+Elements can be created through the `tag` object using attribute access, for example:
 
 {{{
@@ -40 +42 @@
 }}}
 
+== Creating Markup Fragments ==
+
+The `tag` object also allows creating “fragments”, which are basically lists of nodes (elements or text) that don't have a parent element. This can be useful for creating snippets of markup that are attached to a parent element later (for example in a template). Fragments are created by calling the `tag` object:
+
+{{{
+>>> fragment = tag('Hello, ', tag.em('word'), '!')
+>>> fragment
+<Fragment>
+>>> print fragment
+Hello, <em>world</em>!
+}}}
+
 ----
 See also: MarkupGuide, MarkupStream