Skip to content

Commit a0f1512

Browse files
author
AppVeyor (on behalf of Craig Fowler)
committed
Auto-publish docs website [skip ci]
1 parent 2b34139 commit a0f1512

4 files changed

Lines changed: 16 additions & 13 deletions

File tree

docs/_vnext/articles/WhatIsZptSharp.html

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -70,17 +70,18 @@
7070
<h1 id="what-is-zptsharp">What is ZptSharp?</h1>
7171

7272
<p>ZptSharp is an open source <a href="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>
7475
<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>
7677
<li>As a standalone command-line application</li>
7778
</ul>
7879
<p>ZptSharp is based upon the <em>Zope Page Templates</em> specification &amp; syntax.
7980
This has its origins in Python &amp; <a href="https://zope.org/">the Zope application framework</a>.
8081
ZptSharp is a pure .NET implementation of just the page templates syntax from Zope.
8182
<em>It does not depend upon Zope</em> or Python.</p>
8283
<h2 id="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>
8485
<p>ZPT syntax:</p>
8586
<ul>
8687
<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>
9293
<h2 id="what-are-its-fundamentals">What are its fundamentals?</h2>
9394
<p>ZPT's syntax is organised into three logical 'modules' of functionality.
9495
The first of these is an extensible expression syntax for accessing the model, which has the goal of being easy to read &amp; 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>.
9697
This expression syntax is named <strong>TALES</strong>.</p>
9798
<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.
9899
Designers define <em>macros</em> of markup for re-use, which may optionally contain <em>slots</em> (placeholders).
99100
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>
102103
<ul>
103104
<li>Writing model content to the document</li>
104105
<li>Conditionally removing parts of the document</li>

docs/_vnext/articles/index.html

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -70,7 +70,9 @@
7070
<h1 id="zptsharp-documentation">ZptSharp documentation</h1>
7171

7272
<h2 id="get-started">Get started</h2>
73-
<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 <a href="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 <a href="WhatIsZptSharp.html">the short conceptual summary of ZptSharp</a>, which illustrates its fundamental principles.</p>
7476
<ul>
7577
<li><a href="QuickStart/MvcCore.html">Quick start for ASP.NET Core MVC</a></li>
7678
<li><a href="QuickStart/Mvc5.html">Quick start for ASP.NET MVC 5</a></li>

docs/_vnext/index.html

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -63,7 +63,7 @@
6363

6464
<div class="homepage">
6565
<h1 id="intuitive-html--xml-document-templates-for-net">Intuitive HTML &amp; XML document templates for .NET</h1>
66-
<p>ZptSharp is a document template language &amp; renderer for .NET Framework, .NET Core &amp; .NET 5+.
66+
<p>ZptSharp is a document template language &amp; renderer for .NET.
6767
It may be used as a <strong>View Engine</strong> for AS<span>P.N</span>ET MVC5 or AS<span>P.N</span>ET Core MVC.
6868
It also comes with a command-line rendering tool and may be consumed by your own applications as an API.</p>
6969
<section class="sample">
@@ -78,8 +78,8 @@ <h2 id="sample-zpt-markup">Sample ZPT markup</h2>
7878
</section>
7979
<section class="get_started">
8080
<h2 id="get-started">Get started</h2>
81-
<p>Here are some recommended first steps to get learning about ZptSharp and the ZPT syntax.
82-
You may also visit <a href="articles/index.html">the documentation home page</a> for more links &amp; info.</p>
81+
<p>Here are some recommended first steps to learn about ZptSharp and the ZPT syntax.
82+
<a href="articles/index.html">The documentation home page</a> contains more links &amp; reference.</p>
8383
<ul>
8484
<li><a href="articles/WhatIsZptSharp.html">What is ZptSharp?</a></li>
8585
<li>Quick start

docs/_vnext/manifest.json

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4473,7 +4473,7 @@
44734473
"output": {
44744474
".html": {
44754475
"relative_path": "articles/WhatIsZptSharp.html",
4476-
"hash": "Cqn200IEfIHuW/2u4/Xi9A=="
4476+
"hash": "4Bj0Ry68bn2KZImx6x8TNQ=="
44774477
}
44784478
},
44794479
"is_incremental": false,
@@ -4869,7 +4869,7 @@
48694869
"output": {
48704870
".html": {
48714871
"relative_path": "articles/index.html",
4872-
"hash": "ARZM8VFgJuPZTAVSA7INVQ=="
4872+
"hash": "dcRv/hIxaJu8Xs1fhF0eFg=="
48734873
}
48744874
},
48754875
"is_incremental": false,
@@ -4904,7 +4904,7 @@
49044904
"output": {
49054905
".html": {
49064906
"relative_path": "index.html",
4907-
"hash": "nMDCniL0kmAKoLURpe39nA=="
4907+
"hash": "7zrLPH8TP3+s47JkeiBDCw=="
49084908
}
49094909
},
49104910
"is_incremental": false,

0 commit comments

Comments
 (0)