Deploying to gh-pages from @ 4369b632da 🚀

main.css

@@ -0,0 +1,101 @@
+:root {
+  --body-background-color: hsl(0, 0%, 100%);
+  --body-color: hsl(0, 0%, 25%);
+  --table-sticky-background-color: hsl(0, 0%, 92%);
+  --link-color: hsl(210, 90%, 50%);
+  --completion-complete-color: hsl(125, 60%, 35%);
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --body-background-color: hsl(180, 5%, 15%);
+    --body-color: hsl(0, 0%, 80%);
+    --table-sticky-background-color: hsl(180, 5%, 15%);
+    --link-color: hsl(200, 50%, 60%);
+    --completion-complete-color: hsl(125, 50%, 65%);
+  }
+}
+
+body {
+  background-color: var(--body-background-color);
+  color: var(--body-color);
+  /* Use a modern font stack inspired by Bootstrap 4. */
+  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";
+}
+
+h1,
+p {
+  text-align: center;
+}
+
+a {
+  color: var(--link-color);
+  text-decoration: none;
+}
+
+a:hover {
+  text-decoration: underline;
+}
+
+table {
+  border-collapse: collapse;
+  margin: 2rem auto 0 auto;
+}
+
+td {
+  border: 1px solid hsla(0, 0%, 50%, 50%);
+  padding: 0.25rem 0.5rem;
+  /* Prefer horizontal scrolling to wrapping over several lines. */
+  white-space: nowrap;
+}
+
+tr:hover {
+  background-color: hsla(210, 90%, 50%, 12.5%);
+}
+
+tr:nth-child(even) {
+  background-color: hsla(0, 0%, 50%, 10%);
+}
+
+tr:nth-child(even):hover {
+  background-color: hsla(210, 90%, 50%, 15%);
+}
+
+/* Align class names to the right for better readability and highlight them. */
+td:first-child {
+  font-weight: bold;
+  text-align: right;
+}
+
+/* Sticky header for the table. */
+th {
+    background: var(--table-sticky-background-color);
+    box-shadow: 0px 2px 2px 0px rgb(0, 0, 0, 25%);
+    padding: 4px 2px;
+    position: -webkit-sticky;
+    position: sticky;
+    z-index: 1; /* Show on top of table cells. */
+    top: 0; /* Stick to the top of the screen. */
+    cursor: pointer; /* Visually hint that headers can be interacted with. */
+}
+th:first-child {
+  border-left: 1px solid var(--table-sticky-background-color); /* Fixes left border during scroll; must have a valid color, transparent doesn't work. */
+}
+
+.completion-complete {
+  color: var(--completion-complete-color);
+}
+
+/* Dynamic coloring depending on the completion percentage. */
+/* Will be fully red at (roughly) 50% completion, and black/white (depending on the theme) at 99%. */
+.completion-incomplete {
+  font-weight: bold;
+  color: rgb(calc(320 - calc(var(--percentage) * 3.2)), 64, 64);
+}
+
+@media (prefers-color-scheme: dark) {
+  .completion-incomplete {
+    --green-blue: calc(80 + calc(var(--percentage) * 2));
+    color: rgb(255, var(--green-blue), var(--green-blue));
+  }
+}

sorttable.js

@@ -0,0 +1,102 @@
+// Make the class reference table sortable in ascending or descending order
+// when a header is clicked.
+
+
+// Helper function to return the content from the idx-th cell of row tr
+const getCellValue = (tr, idx) => tr.children[idx].textContent;
+
+// Array sorting functions for different columns used by the comparer
+
+// Compares the Desc. and Brief Desc. columns
+// "MISSING" comes first in ascending order
+const descriptionComparer = function(v1, v2) {
+    if(v1 == v2) return 0
+    if(v1 == "OK") return 1
+    return -1
+}
+
+// Compares the Name and Docs URL columns using a basic string sort
+const stringComparer = (new Intl.Collator()).compare
+
+// Compares the Overall column by completion percentage
+const overallComparer = function(v1, v2) {
+    return Number(v1.replace("%", "")) - Number(v2.replace("%", ""))
+}
+
+// Compares the other columns (constructors, methods, members, etc.)
+// by the percentage they're finished.
+// If two have the same percentage, they're compared by denominator size.
+const fractionComparer = (asc) => function(v1, v2) {
+    if(v1 == v2) return 0
+    
+    // Always send 0/0 values to the bottom
+    // The "asc" parameter is needed for that purpose.
+    if(v1 == "0/0") {
+        return asc ? 1 : -1
+    }
+
+    if(v2 == "0/0") {
+        return asc ? -1 : 1
+    }
+
+    var v1fraction = v1.split("/")
+    var v2fraction = v2.split("/")
+
+    var v1decimal = Number(v1fraction[0]) / Number(v1fraction[1])
+    var v2decimal = Number(v2fraction[0]) / Number(v2fraction[1])
+    if(v1decimal == v2decimal) return v1fraction[1] - v2fraction[1]
+
+    return v1decimal - v2decimal
+}
+
+// Returns a function responsible for sorting a specific table column 
+// (column = column object, asc = ascending order?).
+const comparer = function(column, asc) { 
+
+    // This is used by the array.sort() function...
+    return function(a, b) {
+        const colIdx = Array.from(column.parentNode.children).indexOf(column)
+        const colName = column.textContent
+
+        // Select a function based on which column is being called.
+        var columnComparer
+        switch(colName) {
+            case "Brief Desc.":
+            case "Desc.":
+                columnComparer = descriptionComparer
+                break
+            case "Name":
+            case "Docs URL":
+                columnComparer = stringComparer
+                break
+            case "Overall":
+                columnComparer = overallComparer
+                break
+            default:
+                columnComparer = fractionComparer(column.asc)
+                break
+        }
+
+        // Switch the order of the values depending on whether it's an ascending or descending sort.
+        return columnComparer(getCellValue(asc ? a : b, colIdx), getCellValue(asc ? b : a, colIdx));
+    }
+};
+
+const SKIP_END_ROWS = 5 // The number of footer rows generated by doc_status.py
+
+// Set up event listeners that will sort the table when headers are clicked.
+window.onload = function()
+{
+    document.querySelectorAll('th')
+        .forEach(th => 
+            th.addEventListener('click', (() => 
+            {
+                const table = th.closest('table');
+                const tbody = table.querySelector('tbody')
+                const trows = Array.from(tbody.querySelectorAll('tr'))
+                trows.slice(0, -SKIP_END_ROWS)
+                    .sort(comparer(th, th.asc = !th.asc)) // Give each column an individual sort direction
+                    .concat(trows.splice(-SKIP_END_ROWS)) // Don't sort the last rows, as they are not class reference entries.
+                    .forEach(tr => tbody.appendChild(tr) );
+            })));
+}