You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/_vnext/articles/WhatIsZptSharp.html
+7-6Lines changed: 7 additions & 6 deletions
Original file line number
Diff line number
Diff line change
@@ -70,17 +70,18 @@
70
70
<h1id="what-is-zptsharp">What is ZptSharp?</h1>
71
71
72
72
<p>ZptSharp is an open source <ahref="Compatibility.html">library for .NET</a> for writing HTML or XML documents based upon page templates.
73
-
It is useable as a library, and packages are available for use:</p>
73
+
It may be used in your own applications as a library.
74
+
Packages are also available to use ZptSharp:</p>
74
75
<ul>
75
-
<li>As an ASP.NET/ASP.NET Core MVC <strong>View Engine</strong></li>
76
+
<li>As a <strong>View Engine</strong> for AS<span>P.N</span>ET MVC5 or AS<span>P.N</span>ET Core MVC</li>
76
77
<li>As a standalone command-line application</li>
77
78
</ul>
78
79
<p>ZptSharp is based upon the <em>Zope Page Templates</em> specification & syntax.
79
80
This has its origins in Python & <ahref="https://zope.org/">the Zope application framework</a>.
80
81
ZptSharp is a pure .NET implementation of just the page templates syntax from Zope.
81
82
<em>It does not depend upon Zope</em> or Python.</p>
82
83
<h2id="what-is-the-syntax">What is the syntax?</h2>
83
-
<p>ZPT is <em>an attribute language</em> designed specifically for use with HTML and/or XML documents. All of the ZPT directives are placed in<strong>attributes</strong>.</p>
84
+
<p>ZPT is <em>an attribute language</em> designed specifically for use with HTML and/or XML documents. All of the ZPT directives are written using<strong>attributes</strong>.</p>
84
85
<p>ZPT syntax:</p>
85
86
<ul>
86
87
<li>Does not interfere with the validity or structure of the underlying HTML/XML document</li>
@@ -92,13 +93,13 @@ <h2 id="what-is-the-syntax">What is the syntax?</h2>
92
93
<h2id="what-are-its-fundamentals">What are its fundamentals?</h2>
93
94
<p>ZPT's syntax is organised into three logical 'modules' of functionality.
94
95
The first of these is an extensible expression syntax for accessing the model, which has the goal of being easy to read & understand without programming knowledge.
95
-
The default syntax looks a lot like a URL path, such as <code>here/Product/Name</code>.
96
+
Most expressions will look a lot like a URL path, such as <code>here/Product/Name</code>.
96
97
This expression syntax is named <strong>TALES</strong>.</p>
97
98
<p>The second is a mechanism (named <strong>METAL</strong>) for reusing markup across document templates and authoring logical parts of a document as separate source files.
98
99
Designers define <em>macros</em> of markup for re-use, which may optionally contain <em>slots</em> (placeholders).
99
100
At the point of macro usage, markup/content may be supplied to fill the available slots.</p>
100
-
<p>The third function of ZPT handles the actual data-binding and manipulation of the document using the model; this a syntax named <strong>TAL</strong>.
101
-
Some aspects of that functionality include (but are not limited to):</p>
101
+
<p>The third function of ZPT handles the actual data-binding and manipulation of the document using the model; this is a syntax named <strong>TAL</strong>.
102
+
Some aspects of that functionality include the following, although this is not a comprehensive list of its capabilities.</p>
102
103
<ul>
103
104
<li>Writing model content to the document</li>
104
105
<li>Conditionally removing parts of the document</li>
<p>Those who are new to ZptSharp are recommended to follow one of four short <strong>quick start</strong> guides. These guides each take the developer through a 'hello world' example, giving them a working sample app using ZptSharp. You may also wish to read <ahref="WhatIsZptSharp.html">a conceptual summary</a> of what ZptSharp is.</p>
73
+
<p>Those who are new to ZptSharp are recommended to follow one of four short <strong>quick start</strong> guides.
74
+
These guides each take the developer through a 'hello world' example, giving them a working sample app using ZptSharp.
75
+
It is also recommended to read <ahref="WhatIsZptSharp.html">the short conceptual summary of ZptSharp</a>, which illustrates its fundamental principles.</p>
74
76
<ul>
75
77
<li><ahref="QuickStart/MvcCore.html">Quick start for ASP.NET Core MVC</a></li>
76
78
<li><ahref="QuickStart/Mvc5.html">Quick start for ASP.NET MVC 5</a></li>
0 commit comments