Recent changes to Home

WikiPage Home modified by OmniMark Code

OmniMark Code — Mon, 14 May 2012 15:35:02 -0000

--- v4 
+++ v5 
@@ -3,14 +3,14 @@
 
 Any OmniMark veteran has probably written (or copied) the following OmniMark element rule hundreds of times: 
 
--element #implied
-   output "<%q"
-   repeat over specified attributes as a
-      output " " || key of attribute a || "=%"" || attribute a || "%""
-   again
-   output ">%c"
-
++element #implied
+   output "<%q"
+   repeat over specified attributes as a
+      output " " || key of attribute a || "=%"" || attribute a || "%""
+   again
+   output ">%c</%q>"
+
 
 This simple rule attempts to reproduce the original markup in textual form. That is not exactly what it does,  however. There are several corner cases which would make the output malformed.

WikiPage Home modified by OmniMark Code

OmniMark Code — Fri, 11 May 2012 18:45:06 -0000

--- v3 
+++ v4 
@@ -41,10 +41,10 @@
 
 Even if we take care to always produce well-formed markup and thus make its parsers happy with the result,  humans can find it difficult to read. At this point, however, we're moving from the realm of *serializing* markup  so it can be fed to a parser, to its *pretty printing* for human consumption. The rest of this article will  discuss both tasks, covering XML and SGML in turn. 
 
-[Serializing XML]
-[Serializing SGML]
-[Modularizing]
-[Pretty-printing]
+* [Serializing XML](../Serializing%20XML)
+* [Serializing SGML](../Serializing%20SGML)
+* [Modularizing](../Modularizing)
+* [Pretty-printing](../Pretty-printing)
 
 
 [[project_admins]]

WikiPage Home modified by OmniMark Code

OmniMark Code — Fri, 11 May 2012 18:42:47 -0000

--- v2 
+++ v3 
@@ -43,6 +43,8 @@
 
 [Serializing XML]
 [Serializing SGML]
+[Modularizing]
+[Pretty-printing]
 
 
 [[project_admins]]

WikiPage Home modified by OmniMark Code

OmniMark Code — Fri, 11 May 2012 18:31:37 -0000

--- v1 
+++ v2 
@@ -1,8 +1,49 @@
-Welcome to your wiki!
-
-This is the default page, edit it as you see fit. To add a new page simply reference it within brackets, e.g.: [SamplePage].
-
-The wiki uses [Markdown](/p/pretty-markup/wiki/markdown_syntax/) syntax.
+Printing Markup Prettily
+========================
+
+Any OmniMark veteran has probably written (or copied) the following OmniMark element rule hundreds of times: 
+
++element #implied
+   output "<%q"
+   repeat over specified attributes as a
+      output " " || key of attribute a || "=%"" || attribute a || "%""
+   again
+   output ">%c"
+
+
+This simple rule attempts to reproduce the original markup in textual form. That is not exactly what it does,  however. There are several corner cases which would make the output malformed.
+
+An attribute value that contains quotes, ampersands, or less-than characters would lead to malformed start  tags. For example,
+
+    
+
+
+would become 
+
+    
+
+
+The original element content could contain ampersands or less-than characters which would also lead to malformed  printout:
+
+    3*a<b
+
+
+would be formatted as 
+
+    3*a
+
+There are other things that could go wrong:
+
+* You may want to escape all non-ASCII characters using either numeric character references or named entities. In  fact, tab and newline characters in attributes *must* be escaped, otherwise the XML parser will replace them  by spaces.  
+* If the element was empty, we should output an empty tag. In case of an XML document instance, this is a matter  of aesthetics; but if we're trying to reproduce an SGML document, empty elements are not allowed to have  end-tags.  
+* The original markup may have contained comments, processing instructions, entity references, or marked  sections. They would be lost in the output. 
+
+Even if we take care to always produce well-formed markup and thus make its parsers happy with the result,  humans can find it difficult to read. At this point, however, we're moving from the realm of *serializing* markup  so it can be fed to a parser, to its *pretty printing* for human consumption. The rest of this article will  discuss both tasks, covering XML and SGML in turn. 
+
+[Serializing XML]
+[Serializing SGML]
+
 
 [[project_admins]]
 [[download_button]]

WikiPage Home modified by OmniMark Code

OmniMark Code — Thu, 10 May 2012 16:48:18 -0000

Welcome to your wiki! This is the default page, edit it as you see fit. To add a new page simply reference it within brackets, e.g.: [SamplePage]. The wiki uses [Markdown](/p/pretty-markup/wiki/markdown_syntax/) syntax. [[project_admins]] [[download_button]]