Merge remote-tracking branch 'origin/main' into ODATA-1626

.github/workflows/nodejs.yml

@@ -8,7 +8,7 @@ jobs:
 
     strategy:
       matrix:
-        node-version: [20.x]
+        node-version: [22.x]
 
     steps:
       - uses: actions/checkout@v4

README.md

@@ -28,18 +28,7 @@ Documents are generated from Markdown sources using Node.js modules described [h
 3. Download and install [git](https://git-scm.com/), verify via `git -v`
 4. Optionally download and install [GitHub Desktop](https://desktop.github.com/)
 5. Clone this repository
-6. In the local repository folder run `npm install`, verify via `npm test`  
-   Repeat this step if the test fails with an error message like the following after upgrading to a new Chrome version:
-   ```
-     1 failing
-   
-     1) OASIS doc build
-          Puppeteer:
-        Error: Could not find Chrome (ver. 116.0.5845.96). This can occur if either
-    1. you did not perform an installation before running the script (e.g. `npm install`) or
-    2. your cache path is incorrectly configured (which is: C:\Users\D024504\.cache\puppeteer).
-   For (2), check out our guide on configuring puppeteer at https://pptr.dev/guides/configuration.
-   ```
+6. In the local repository folder run `npm install`, verify via `npm test`
 
 ### Document preparation
 

docs/odata-csdl-json/styles/odata.css

@@ -1,14 +1,23 @@
-a:target {
+:root {
+  --indent: 40px;
+}
+
+a:target,
+span:target {
   background-color: yellow;
 }
 
+h6 span[id],
+a[href^="https://docs.oasis-open.org"][href*="#"],
 a[href^="#_"],
 a[href^="#OData"]:not(a[href^="#OData4"]),
 a[href^="#rfc"],
 a[href^="#XML-"] {
   font-weight: bold;
 }
 
+h6 span[id]::before,
+a[href^="https://docs.oasis-open.org"][href*="#"]::before,
 a[href^="#_"]::before,
 a[href^="#OData"]:not(a[href^="#OData4"])::before,
 a[href^="#rfc"]::before,
@@ -17,6 +26,8 @@ a[href^="#XML-"]::before {
   font-weight: bold;
 }
 
+h6 span[id]::after,
+a[href^="https://docs.oasis-open.org"][href*="#"]::after,
 a[href^="#_"]::after,
 a[href^="#OData"]:not(a[href^="#OData4"])::after,
 a[href^="#rfc"]::after,
@@ -149,16 +160,9 @@ table {
 
 p code,
 li code,
-h1 code,
-h2 code,
-h3 code,
-h4 code,
-h5 code,
-h6 code,
 td > code {
-  font-family: MJXZERO, MJXTEX-T;
   font-size: 1em;
-  line-height: 0;
+  font-weight: bold;
 }
 
 .example p code,
@@ -168,11 +172,31 @@ td > code {
 
 .example pre,
 .rep {
-  margin-left: 40px;
+  margin-left: var(--indent);
+}
+
+.caption p {
+  margin-left: var(--indent);
+  margin-bottom: -1em;
+}
+
+.side-by-side {
+  margin: -1em 0;
+}
+
+.side-by-side:after {
+  content: "";
+  display: block;
+  clear: both;
+}
+
+.side-by-side > div {
+  width: 50%;
+  float: left;
 }
 
 .indent {
-  margin-left: 40px;
+  margin-left: var(--indent);
 }
 
 td pre {
@@ -195,14 +219,7 @@ mjx-container {
 
 mjx-container[display="true"] {
   text-align: left !important;
-  margin-left: 40px !important;
-}
-
-/* The following rule enables typewriter single quotes in maths, like $\hbox{\tt{'$Q$'}}$ */
-mjx-c.mjx-c2019::before {
-  content: "\27" !important;
-  padding-right: 0.525em !important;
-  font-family: MJXZERO, MJXTEX-T;
+  margin-left: var(--indent) !important;
 }
 
 code .er {
@@ -215,6 +232,17 @@ hr:first-of-type {
 }
 
 @media screen {
+  #darkmode {
+    position: fixed;
+    top: 0;
+    right: 0;
+  }
+
+  html.darkmode {
+    background-color: #f2eee8;
+    filter: invert(100%);
+  }
+
   details:not([open]) > summary {
     list-style: disclosure-closed;
   }
@@ -225,6 +253,10 @@ hr:first-of-type {
 }
 
 @media print {
+  #darkmode {
+    display: none;
+  }
+
   details > summary {
     list-style: none;
   }
@@ -239,6 +271,7 @@ h6 {
   page-break-after: avoid;
 }
 
+.side-by-side,
 td {
   page-break-inside: avoid;
 }