Merge pull request #1058 from line-o/doc/tables

Additional layout fixes

Author: duncdrum

src/main/frontend/sass/_doc.scss

@@ -64,31 +64,32 @@ section dl.dl-horizontal {
   color: var(--bs-danger-text-emphasis);
 }
 
+/* content */
+
 .content {
   color: var(--darktext);
 
   section {
     clear: both;
   }
-  table {
-    margin: .5em 1em;
-  }
-  td {
-    padding: 6px 4px;
-  }
   .strong {
     font-weight: bold;
   }
   em {
     font-style: italic;
   }
 
+  /* code listings (syntax highlighted) */
   pre > code {
     background-color: var(--black);
     color: var(--white);
     font-size: .92em;
+    border-radius: .375rem; /* var(--bs-alert-border-radius) */
+    padding: 1rem; /* var(--bs-alert-padding-y) var(--bs-alert-padding-x) */
+    border: thin solid var(--lightgrey);
   }
 
+  /* inline code */
   code {
     background-color: inherit;
     color: inherit;
@@ -180,6 +181,7 @@ section dl.dl-horizontal {
     border: 1px solid var(--grey);
   }
 
+  /* nicer scroll targets */
   a[name] {
     scroll-margin-top: 1rem;
   }

src/main/frontend/sass/_layout.scss

@@ -43,10 +43,11 @@
 
 #poweredby {
   float: right;
-  width: 120px;
-  height: 56px;
+  width: 7.5rem;
+  height: 3.5rem;
   margin-bottom: 1rem;
   background: url(../images/powered-by.svg) no-repeat center;
+  background-size: contain;
 }
 
 
@@ -73,10 +74,6 @@
   }
 }
 
-#copyright {
-  width: 15rem;
-  text-align: right;
-  p {
-    padding: 0;
-  }
+#copyright p {
+  padding: 0;
 }

src/main/xar-resources/data/devguide_indexes/devguide_indexes.xml

@@ -686,13 +686,15 @@
                 <title/>
 
                 <tgroup cols="4">
-                    <tbody>
+                    <thead>
                         <row>
                             <entry> <para>Field name</para> </entry>
                             <entry> <para>Field type</para> </entry>
                             <entry> <para>Description</para> </entry>
                             <entry> <para>Comments</para> </entry>
                         </row>
+                    </thead>
+                    <tbody>
                         <row>
                             <entry> <para>DOCUMENT_URI</para> </entry>
                             <entry> <para>VARCHAR</para> </entry>

src/main/xar-resources/data/exist-building/exist-building.xml

@@ -104,6 +104,12 @@
     <table>
       <title>Useful Maven targets</title>
       <tgroup cols="2">
+        <thead>
+            <row>
+              <entry><para>Command</para></entry>
+              <entry><para>Description</para></entry>
+            </row>
+        </thead>
         <tbody>
           <row>
             <entry>
@@ -159,6 +165,12 @@
     <table>
       <title>Useful Maven properties and arguments</title>
       <tgroup cols="2">
+        <thead>
+            <row>
+              <entry><para>Argument</para></entry>
+              <entry><para>Description</para></entry>
+            </row>
+        </thead>
         <tbody>
           <row>
             <entry>

src/main/xar-resources/data/scheduler/scheduler.xml

@@ -196,13 +196,15 @@
                         <colspec colwidth="25%"/>
                         <colspec colwidth="30%"/>
                         <colspec colwidth="20%"/>
-                        <tbody>
+                        <thead>
                             <row>
                                 <entry> <para>Field Name</para> </entry>
                                 <entry> <para>Mandatory?</para> </entry>
                                 <entry> <para>Allowed Values</para> </entry>
                                 <entry> <para>Allowed Special Characters</para> </entry>
                             </row>
+                        </thead>
+                        <tbody>
                             <row>
                                 <entry> <para>Seconds</para> </entry>
                                 <entry> <para>YES</para> </entry>
@@ -336,11 +338,13 @@
                     <tgroup cols="2">
                         <colspec colwidth="30%"/>
                         <colspec colwidth="70%"/>
-                        <tbody>
+                        <thead>
                             <row>
                                 <entry> <para>Expression</para> </entry>
                                 <entry> <para>Meaning</para> </entry>
                             </row>
+                        </thead>
+                        <tbody>
                             <row>
                                 <entry> <para> <code>0 0 12 * * ? </code> </para> </entry>
                                 <entry> <para> Fire at 12pm (noon) every day </para> </entry>

src/main/xar-resources/modules/xsl/convert-db5.xsl

@@ -132,7 +132,7 @@
 
     <xsl:variable name="spacing" as="xs:string" select="normalize-space((@spacing, 'normal')[1])"/>
     <xsl:call-template name="do-anchor"/>
-    <dl class="row {if ($spacing = 'normal') then 'wide' else ''}">
+    <dl class="{if ($spacing = 'normal') then 'wide' else ''}">
 
       <xsl:for-each select="db5:varlistentry">
         <dt>