Various minor updates

.github/workflows/ci.yml

@@ -21,7 +21,7 @@ jobs:
             conda: docs/examples/environment.yaml
             prop: tests & examples
           - runs-on: macos-latest
-            config: -DBUILD_TESTS=1 -DBUILD_EXAMPLES=0
+            config: -DBUILD_TESTS=1 -DBUILD_EXAMPLES=0 -DBUILD_DOCS=1
             conda: environment.yaml
             prop: tests
           - runs-on: windows-latest
@@ -91,6 +91,11 @@ jobs:
         python version.py
         python MeshQuad4.py
 
+    - name: Build doxygen-docs (error on warning)
+      if: runner.os == 'macOS'
+      working-directory: build
+      run: make docs
+
   py:
 
     strategy:

docs/doxystyle/doxygen-awesome.css

@@ -25,7 +25,7 @@ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
- */
+*/
 
 :root {
     /* primary theme color. This will affect the entire websites color scheme: links, arrows, labels, ... */
@@ -134,13 +134,14 @@ SOFTWARE.
     --fragment-foreground: #fff;
     --fragment-keyword: #cc99cd;
     --fragment-keywordtype: #ab99cd;
+    --fragment-keywordflow: #e08000;
     --fragment-token: #7ec699;
     --fragment-comment: #999;
     --fragment-link: #98c0e3;
     --fragment-preprocessor: #65cabe;
     --fragment-linenumber-color: #ccc;
     --fragment-linenumber-background: #35393c;
-    --fragment-whitespace: nowrap;
+    --fragment-lineheight: 20px;
 
     /* sidebar navigation (treeview) colors */
     --side-nav-background: var(--page-background-color);
@@ -149,7 +150,6 @@ SOFTWARE.
 
     /* height of an item in any tree / collapsable table */
     --tree-item-height: 30px;
-
 }
 
 @media screen and (max-width: 767px) {
@@ -228,8 +228,9 @@ a, a.el:visited, a.el:hover, a.el:focus, a.el:active {
 }
 
 /*
- Title & top navigation
+ Title and top navigation
  */
+
 #top {
     background: var(--header-background);
     border-bottom: 1px solid var(--separator-color);
@@ -261,7 +262,6 @@ a, a.el:visited, a.el:hover, a.el:focus, a.el:active {
     #titlearea {
         padding-bottom: var(--spacing-small);
     }
-
 }
 
 #titlearea table tbody tr {
@@ -308,7 +308,6 @@ a, a.el:visited, a.el:hover, a.el:focus, a.el:active {
     }
 }
 
-
 @media screen and (min-width: 768px) {
     .sm-dox li, .tablist li {
         display: var(--menu-display);
@@ -329,8 +328,6 @@ a, a.el:visited, a.el:hover, a.el:focus, a.el:active {
     .sm-dox ul a:hover span.sub-arrow {
         border-color: transparent transparent transparent var(--menu-focus-foreground);
     }
-
-
 }
 
 .sm-dox ul {
@@ -451,8 +448,6 @@ a, a.el:visited, a.el:hover, a.el:focus, a.el:active {
     }
 }
 
-
-
 #MSearchSelectWindow, #MSearchResultsWindow {
     z-index: 9999;
 }
@@ -495,7 +490,6 @@ a, a.el:visited, a.el:hover, a.el:focus, a.el:active {
     background: none;
 }
 
-
 #MSearchBox span.right {
     padding-top: calc(calc(var(--searchbar-height) / 2) - 12px);
 }
@@ -552,8 +546,6 @@ iframe#MSearchResults {
     color: var(--menu-focus-foreground);
 }
 
-
-
 @media screen and (max-width: 767px) {
     #MSearchBox {
         margin-top: var(--spacing-medium);
@@ -588,8 +580,6 @@ iframe#MSearchResults {
         transform: translate(0, 20px);
         animation: ease-out 280ms slideInSearchResultsMobile;
     }
-
-
 }
 
 /*
@@ -671,8 +661,8 @@ iframe#MSearchResults {
     width: 1px;
 }
 
-/**
- content
+/*
+ Contents
  */
 
 div.header {
@@ -783,11 +773,9 @@ blockquote p {
 }
 
 /*
-toc
+ Table of Contents
  */
 
-
-
 div.toc {
     background-color: var(--side-nav-background);
     border: 1px solid var(--separator-color);
@@ -836,7 +824,7 @@ div.toc ul li.level2, div.toc ul li.level3 {
 }
 
 /*
-code & fragment
+ Code & Fragments
  */
 
 code, div.fragment, pre.fragment {
@@ -886,18 +874,23 @@ div.fragment, pre.fragment {
     }
 }
 
-code, code a, pre.fragment, div.fragment, div.fragment .line, div.fragment span {
+code, code a, pre.fragment, div.fragment, div.fragment .line, div.fragment span, div.fragment .line a, div.fragment .line span {
     font-family: var(--font-family-monospace);
-    font-size: var(--code-font-size);
-    line-height: inherit;
+    font-size: var(--code-font-size) !important;
 }
 
-div.fragment, div.fragment .line, div.fragment span {
-    white-space: var(--fragment-whitespace);
+div.fragment {
+    line-height: 0;
 }
 
 div.line:after {
-    content: '';
+    margin-right: var(--spacing-medium);
+}
+
+div.fragment .line, pre.fragment {
+    white-space: pre;
+    word-wrap: initial;
+    line-height: var(--fragment-lineheight);
 }
 
 div.fragment span.keyword {
@@ -908,6 +901,10 @@ div.fragment span.keywordtype {
     color: var(--fragment-keywordtype);
 }
 
+div.fragment span.keywordflow {
+    color: var(--fragment-keywordflow);
+}
+
 div.fragment span.stringliteral {
     color: var(--fragment-token)
 }
@@ -942,7 +939,7 @@ div.fragment .line:first-child .lineno {
 }
 
 /*
-dl warning, attention, note, deprecated, bug, ...
+ dl warning, attention, note, deprecated, bug, ...
  */
 
 dl.warning, dl.attention, dl.note, dl.deprecated, dl.bug, dl.invariant, dl.pre {
@@ -1009,7 +1006,7 @@ dl.invariant, dl.pre {
 }
 
 /*
-memitem
+ memitem
  */
 
 div.memdoc, div.memproto, h2.memtitle {
@@ -1100,8 +1097,9 @@ table.mlabels > tbody > tr:first-child {
 .memname, .memitem span.mlabels {
     margin: 0
 }
+
 /*
-reflist
+ reflist
  */
 
 dl.reflist {
@@ -1134,7 +1132,7 @@ dl.reflist dd {
 }
 
 /*
-table
+ Table
  */
 
 table.markdownTable, table.fieldtable {
@@ -1190,7 +1188,7 @@ table.memberdecls {
 
 
 /*
-hr
+ Horizontal Rule
  */
 
 hr {
@@ -1201,15 +1199,14 @@ hr {
 
 .contents hr {
     box-shadow: var(--content-maxwidth) 0 0 0 var(--separator-color), calc(0px - var(--content-maxwidth)) 0 0 0 var(--separator-color);
-
 }
 
 .contents img {
     max-width: 100%;
 }
 
 /*
- directories
+ Directories
  */
 div.directory {
     border-top: 1px solid var(--separator-color);
@@ -1269,7 +1266,7 @@ table.directory {
 }
 
 /*
-class list
+ Class list
  */
 
 .classindex dl.odd {
@@ -1283,9 +1280,8 @@ class list
     }
 }
 
-
 /*
-  footer / nav-path
+  Footer and nav-path
  */
 
 #nav-path {
@@ -1368,4 +1364,4 @@ li.navelem:first-child:before {
 
 .navpath li.navelem a:hover {
     color: var(--primary-color);
-}
+}