Adding new resource: XProc from Above

Author: wendellpiez

docs/fm6-22/index.html

@@ -160,51 +160,84 @@ <h1>The XProc Zone</h1>
             <p>Welcome to the XProc Zone.</p>
             <ul>
                <li>If you are new to XProc, learn by scanning a page of <a class="internal"
-                     href="xproc-pages.html">XProc links</a>, maintained on this site by hand</li>
+                     href="xproc-pages.html">XProc links</a>, maintained on this site by
+                        hand</li>
                <li>
-                  <a href="https://github.com/wendellpiez/xproc-zone">Browse the code repository</a> holding the code and data</li>
+                  <a href="https://github.com/wendellpiez/xproc-zone">Browse the code
+                            repository</a> holding the code and data</li>
                <li>A <a class="internal"
-                     href="style-guide.html">Style Guide</a> for this site shows its page styling and layout for authors</li>
+                     href="style-guide.html">Style Guide</a> for this site shows its page
+                        styling and layout for authors</li>
                <li>Projects using XProc are listed below</li>
             </ul>
          </div>
          <div class="panel">
-            <h2>US Army Field Manual <span class="nowrap">(FM 6-22), <em>Developing Leaders</em> 2022</span>
+            <h2>US Army Field Manual <span class="nowrap">(FM 6-22), <em>Developing Leaders</em>
+                        2022</span>
             </h2>
-            <h3 class="subtitle">An XProc case study: a chapter from a public document converted into formats for reuse and accessibility</h3>
+            <h3 class="subtitle">An XProc case study: a chapter from a public document converted
+                    into formats for reuse and accessibility</h3>
             <p>See an <a class="internal"
-                  href="fm6-22/index.html">electronic version of the army field manual on Developing Leaders</a>, converted from an HTML export from PDF, using XProc and XSLT. The results are in XML formats valid to standard, non-proprietary data models and usable within their respective application stacks.</p>
-            <p>This project was ported and adapted from an <a href="https://github.com/usnistgov/oscal-xproc3">earlier effort</a> at NIST, the National Institute for Standards and Technology. The Zone adds only the <a class="clean"
-                  href="fm6-22/FM_6-22-draw_one.html">Draw one</a> feature with some improved styling.</p>
+                  href="fm6-22/index.html">electronic version of the army field manual
+                        on Developing Leaders</a>, converted from an HTML export from PDF, using
+                    XProc and XSLT. The results are in XML formats valid to standard,
+                    non-proprietary data models and usable within their respective application
+                    stacks.</p>
+            <p>This project was ported and adapted from an <a href="https://github.com/usnistgov/oscal-xproc3">earlier effort</a> at NIST,
+                    the National Institute for Standards and Technology. The Zone adds only the <a class="clean"
+                  href="fm6-22/FM_6-22-draw_one.html">Draw one</a> feature with
+                    some improved styling.</p>
          </div>
          <div class="panel">
             <h2>XProc Laboratory</h2>
             <p>XProc being XML, it is well suited for processing in XProc. <a class="internal"
-                  href="xproc-lab/index.html">Here</a> XProc is used to make useful things for XProc.</p>
+                  href="xproc-lab/index.html">Here</a> XProc is used to make useful things for
+                    XProc.</p>
             <p>An <a href="xproc-lab/xproc-step-list.html"
-                  class="clean">XProc Step List</a> offers syntax snippets and links to help ease your way on your XProc journey.</p>
+                  class="clean">XProc Step List</a> offers syntax snippets
+                    and links to help ease your way on your XProc journey.</p>
             <p>An experimental <a class="clean"
-                  href="xproc-lab/zone-xproc-index.html">Index to XProc in the Zone</a> provides quick links for help analyzing and assessing the code base, or learning XProc.</p>
+                  href="xproc-lab/zone-xproc-index.html">Index to
+                        XProc in the Zone</a> provides quick links for help analyzing and assessing
+                    the code base, or learning XProc.</p>
          </div>
          <div class="block">
             <h2>For developers</h2>
-            <p>Software developers working with the XML/XDM stack may find the Zone interesting as a testbed. The Zone seeks to foreground realistic and meaningful examples demonstrating the power of the two driving design features of this technology, in combination:</p>
+            <p>Software developers working with the XML/XDM stack may find the Zone interesting
+                    as a testbed. The Zone seeks to foreground realistic and meaningful examples
+                    demonstrating the power of the two driving design features of this technology,
+                    in combination:</p>
             <ul>
-               <li>The <em>transparency</em> and <em>intelligibility</em> of declarative encoding bound to both generalized and local (peculiar) semantics, as exemplified in XML, XProc and kindred technologies (XSLT, XPath, RNG and others)</li>
-               <li>The <em>determinism</em> of the pipelined, template-based processing model, with its implied <em>demonstrability</em> and <em>repeatability</em>, making it testable, validable and (at least potentially) <em>trustworthy</em>
+               <li>The <em>transparency</em> and <em>intelligibility</em> of declarative
+                        encoding bound to both generalized and local (peculiar) semantics, as
+                        exemplified in XML, XProc and kindred technologies (XSLT, XPath, RNG and
+                        others)</li>
+               <li>The <em>determinism</em> of the pipelined, template-based processing model,
+                        with its implied <em>demonstrability</em> and <em>repeatability</em>, making
+                        it testable, validable and (at least potentially) <em>trustworthy</em>
                </li>
             </ul>
-            <p>The Zone is also more than a platform for demonstrations. Not everything in the repository is equally well documented, or finds its way onto the portal. Deep in the Zone you might find easter eggs or other small treasures.</p>
-            <p>Any developers who wish to engage, or anyone who wishes to help sustain and promote XProc Zone, are invited to contact the proprietor or reach out through Github channels.</p>
+            <p>The Zone is also more than a platform for demonstrations. Not everything in the
+                    repository is equally well documented, or finds its way onto the portal. Deep in
+                    the Zone you might find easter eggs or other small treasures.</p>
+            <p>Any developers who wish to engage, or anyone who wishes to help sustain and
+                    promote XProc Zone, are invited to contact the proprietor or reach out through
+                    Github channels.</p>
             <p>If you wish only to study, borrow and learn: the Zone is for you too.</p>
          </div>
          <div class="block">
             <h2>For learners and educators</h2>
-            <p>In the Zone you will find nothing as organized as a <em>curriculum</em> (Lat: <q>little run</q>, <em>viz</em>
-               <a href="https://en.wiktionary.org/wiki/cursus">cursus</a>), but instead a space or area, clean or cluttered as you come upon it.</p>
-            <p>Like a museum with long galleries and back stairs, the Zone is designed for you to explore for yourself. One hallway leads to another, where may be found more and different curiosities and items of interest, general and particular.</p>
+            <p>In the Zone you will find nothing as organized as a <em>curriculum</em> (Lat:
+                        <q>little run</q>, <em>viz</em>
+               <a href="https://en.wiktionary.org/wiki/cursus">cursus</a>), but instead a space
+                    or area, clean or cluttered as you come upon it.</p>
+            <p>Like a museum with long galleries and back stairs, the Zone is designed for you
+                    to explore for yourself. One hallway leads to another, where may be found more
+                    and different curiosities and items of interest, general and particular.</p>
             <p>Add them to your tour. Study them or come back to them later.</p>
-            <p>Disciplines of interest include Media, Rhetoric, Informatics, Metrology, data science, data and information security, cybernetics (Operations Research), formal languages and data modeling.</p>
+            <p>Disciplines of interest include Media, Rhetoric, Informatics, Metrology, data
+                    science, data and information security, cybernetics (Operations Research),
+                    formal languages and data modeling.</p>
          </div>
       </main>
       <hr class="hr">

docs/index.html

@@ -166,7 +166,7 @@ footer { font-size: smaller }
 .in-a-row > *:last-child { text-align: right; /* Align text to the right */ }
 
 summary { font-style: italic }
-details { padding: 0.4em }
+/* details { padding: 0.4em }  */
 
 main div, main details { max-width: 60em }
 

docs/site/zone-main.css

@@ -161,15 +161,17 @@ <h1>Style Guide</h1>
                <p>Details, details</p>
                <ul>
                   <li>More details</li>
-                  <li>With details, including some <em>emphasized</em> and <strong>strengthened</strong> and <i>italic</i> and <b>bold</b>. And <b class="hi">highlighted bold</b>.</li>
+                  <li>With details, including some <em>emphasized</em> and <strong>strengthened</strong>
+                        and <i>italic</i> and <b>bold</b>. And <b class="hi">highlighted bold</b>.</li>
                </ul>
             </details>
          </div>
          <div class="panel">
             <h2>Panel One</h2>
             <p>Panel one goes here, <a class="internal"
                   href="index.html">Linking</a> and with <em>emphasis</em> as well.</p>
-            <p>The styling supports two main kinds of div displays in addition to the default plus whatever you might add. A <q>panel</q> is what you see here. An example of a <q>block</q> is the <code>details</code> (expanding box) above, or the section entitled <a class="internal"
+            <p>The styling supports two main kinds of div displays in addition to the default plus whatever you might add. A 
+                   <q>panel</q> is what you see here. An example of a <q>block</q> is the <code>details</code> (expanding box) above, or the section entitled <a class="internal"
                   href="#block">Block</a> below. Any HTML element can be a panel or a block, marked as such using its <code>class</code> attribute in the normal way.</p>
          </div>
          <div class="panel">

docs/style-guide.html

@@ -146,6 +146,10 @@ <h1>XProc Laboratory</h1>
                <a class="internal"
                   href="../xproc-pages.html">Links</a>
             </li>
+            <li>
+               <a class="internal"
+                  href="xproc-from-above.html">XProc From Above</a>
+            </li>
             <li>
                <a class="clean"
                   href="xproc-step-list.html">Step List</a>
@@ -174,6 +178,14 @@ <h2>XProc Zone XProc Element Index</h2>
                   href="zone-xproc-index.html">Look up XProc elements of interest</a> and link from their listings into the code base.</p>
             <p>Generated with the help of XProc, an index to XProc shows XProc element usage in XProc pipelines throughout this repository. The polling is dynamic and can be executed at any time, including under continuous deployment and integration (CI/CD).</p>
          </div>
+         <div class="panel">
+            <h2>
+               <a class="internal"
+                  href="xproc-from-above.html">XProc From Above</a>
+            </h2>
+            <p>Short introductory tutorials examining XProc code, from a high level.</p>
+            <p>The examples offered are included in the publication dynamically (using XProc) from <a href="https://github.com/wendellpiez/xproc-zone/tree/main/projects/PlanetXProc/src">the repository</a>.</p>
+         </div>
          <div class="panel">
             <h2>Worksheets</h2>
             <p>