Various updates

Author: simshadows

src/components/layout-helpers/BaseFooter.astro

@@ -1,18 +1,21 @@
 ---
 import {
     AUTHOR,
-    COPYRIGHT_YEAR,
     SOURCE_CODE_URL,
 } from "@root/constants";
 
+import {TimezonelessDate} from "@helpers/timezoneless-date";
+
 import ccImg from "./_BaseFooter_images/cc.svg";
 import byImg from "./_BaseFooter_images/by.svg";
 import saImg from "./_BaseFooter_images/sa.svg";
+
+const copyright_year = TimezonelessDate.nowUTC().getYear();
 ---
 
 <footer id="footer" class="content-column">
     <p id="footer-text">
-        &copy; {COPYRIGHT_YEAR} {AUTHOR}. All content on this site is licensed under <a href="http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1" target="_blank" rel="license noopener noreferrer" style="display:inline-block;">Creative Commons Attribution-ShareAlike 4.0 International</a>.
+        &copy; {copyright_year} {AUTHOR}. All content on this site is licensed under <a href="http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1" target="_blank" rel="license noopener noreferrer" style="display:inline-block;">Creative Commons Attribution-ShareAlike 4.0 International</a>.
         <br />
         This site's source code is available on <a href={SOURCE_CODE_URL}>GitHub</a>.
         <br />

src/constants.ts

@@ -3,7 +3,6 @@ export const SHIKI_THEME = "monokai";
 export const SITE = "https://www.simshadows.com/";
 export const SITE_TITLE = "simshadows";
 export const AUTHOR = "simshadows";
-export const COPYRIGHT_YEAR = 2025;
 export const GLOBAL_KEYWORDS = ["simshadows"];
 export const SOURCE_CODE_URL = "https://github.com/simshadows/simshadows.github.io";
 

src/helpers/timezoneless-date.ts

@@ -5,6 +5,10 @@
  *
  * A wrapper class to enforce the use of a pre-existing date implementation
  * as a simple timezoneless calendar date.
+ *
+ * There are a lot of weird stuff going on in this class, mostly because it's just
+ * easy to understand and verify. I should work on understanding exactly what's going
+ * on with them and cleaning up any weirdness.
  */
 
 import dayjs from "dayjs";
@@ -47,6 +51,10 @@ export class TimezonelessDate {
         return this.__d.toISOString();
     }
 
+    getYear(): Number {
+        return this.__d.year();
+    }
+
     toDate(): Date {
         return this.__d.toDate();
     }
@@ -55,8 +63,7 @@ export class TimezonelessDate {
      * Returns a number that guarantees that later dates have larger numbers
      * than earlier dates, and same dates return the same number.
      *
-     * (In practice, this is a Unix timestamp, but toOrderedNumber() doesn't
-     * promise any particular timezone.)
+     * (In practice, this is a Unix timestamp. Don't rely on what the number means.)
      */
     toOrderedNumber(): number {
         return this.__d.unix();
@@ -82,5 +89,17 @@ export class TimezonelessDate {
         }
         return new TimezonelessDate(Number(y), Number(m) - 1, Number(d));
     }
+
+    /*
+     * Get the current UTC date as a TimezonelessDate.
+     */
+    static nowUTC(): TimezonelessDate {
+        const now = new Date();
+        return new TimezonelessDate(
+            now.getUTCFullYear(),
+            now.getUTCMonth(),
+            now.getUTCDate(),
+        );
+    }
 }
 

src/pages/_index-links.astro

@@ -109,6 +109,11 @@ const {
 <h4>Computer/Tech Enthusiast Stuff</h4>
 
 <ul>
+    <li><b>Audio</b>
+        <ul>
+            <li><a href="/tech/audio/impressions/"><b>My Impressions on Headphones</b></a></li>
+        </ul>
+    </li>
     <li><b>Cheatsheets and Checklists</b>
         <ul>
             {showWIP && <li><a href="/tech/cheatsheets/computer-maintenance-checklists/"><b>Computer Maintenance Checklists</b></a> <Wip /></li>}
@@ -120,10 +125,14 @@ const {
     </li>
     {showWIP && <li><a href="/tech/hardware-troubleshooting/"><b>Computer Hardware Troubleshooting</b></a> <Wip /></li>}
     {showWIP && <li><a href="/tech/homelab/"><b>Homelab</b></a> <Wip /></li>}
-    <li><a href="/tech/mechanical-keyboard-switch-collection/"><b>Mechanical Keyboard Switch Collection</b></a>
-        {showWIP && <ul>
-            <li>There's also this <a href="/mechanical-keyboard-switch-collection-legacy/index.html"><b>old version of the page</b></a>. I'm still migrating data from it.</li>
-        </ul>}
+    <li><b>Mechanical Keyboards</b>
+        <ul>
+            <li><a href="/tech/mechanical-keyboard-switch-collection/"><b>Mechanical Keyboard Switch Collection</b></a>
+                {showWIP && <ul>
+                    <li>There's also this <a href="/mechanical-keyboard-switch-collection-legacy/index.html"><b>old version of the page</b></a>. I'm still migrating data from it.</li>
+                </ul>}
+            </li>
+        </ul>
     </li>
     <li><a href="/tech/semiprivate/"><b>Semi-Private Content</b></a></li>
 </ul>

src/pages/c/cheatsheets/javascript-typescript.mdx

@@ -202,6 +202,27 @@ import foobar from "mymodule";
 ```
 
 
+## Web APIs
+
+### Document Object Model (DOM)
+
+```ts
+// Return the first match (falsy if no match)
+match = document.querySelector("#logo");
+// Return all matches (empty if no match)
+matches = document.querySelectorAll("div.foobar");
+
+// Creating an element
+e = document.createElement("div");
+e.classlist.add("my-awesome-class");
+e.textContent = "my awesome text";
+
+// Adding an element to the page
+match.prepend(e);
+match.append(e);
+```
+
+
 ## Basic Recipes (JS Only)
 
 ### Max Heap

src/pages/c/cheatsheets/powershell.mdx

@@ -8,4 +8,10 @@ indexTitle: PowerShell
 wip: true
 ---
 
-TODO
+```powershell
+# Print cyan-coloured text
+Write-Host "foobar" -ForegroundColor Cyan
+
+# Run another Powershell script
+& $PSScriptRoot\relative\path\to\other\script.ps1
+```

src/pages/c/cheatsheets/python/index.mdx

@@ -26,13 +26,30 @@ References:
     - [**`math`**](https://docs.python.org/3/library/math.html), [**`datetime`**](https://docs.python.org/3/library/datetime.html)
     - [**`bisect`**](https://docs.python.org/3/library/bisect.html), [**`heapq`**](https://docs.python.org/3/library/heapq.html)
     - [**`logging`**](https://docs.python.org/3/library/logging.html), [**`sqlite3`**](https://docs.python.org/3/library/sqlite3.html)
+    - [**`venv`**](https://docs.python.org/3/library/venv.html)
 - [**Learn X in Y minutes - Python**](https://learnxinyminutes.com/docs/python/) `(learnxinyminutes.com)`
 
 Common third-party library references:
 
 - [**`pandas`**](https://pandas.pydata.org/docs/reference/index.html)
 
 
+## Shell Commands
+
+```sh
+# Set up venv
+python -m venv ./_venv
+source ./_venv/bin/activate
+python -m pip install -r ./requirements.txt
+
+# Create requirements.txt
+python -m pip freeze > ./requirements.txt
+
+# Exit venv
+deactivate
+```
+
+
 ## Misc.
 
 Python Documentation - [**Built-In Functions**](https://docs.python.org/3/library/functions.html), [**Built-In Exceptions**](https://docs.python.org/3/library/exceptions.html#concrete-exceptions), [**Data Model**](https://docs.python.org/3/reference/datamodel.html)<br />
@@ -206,12 +223,34 @@ x = p[0] # same as p.x
 ```
 
 
+## Classes
+
+Python Documentation - [**Data Model - Special method names**](https://docs.python.org/3/reference/datamodel.html)
+
+```py
+class MyClass:
+    __slots__ = ("__foobar")
+
+    def __init__(self, n):
+        self.__foobar = n
+```
+
+
+## Functions
+
+TODO show how args and kwargs work
+
+
 ## System API
 
 Python Documentation - [**`os`**](https://docs.python.org/3/library/os.html), [**`sys`**](https://docs.python.org/3/library/sys.html)
 
+### File IO
+
 ```py
-# TODO: examples?
+with open("foobar.txt", "r") as f:
+    content = f.read()
+    print(content)
 ```
 
 
@@ -293,10 +332,6 @@ words = [s.strip() for s in stdin.readline().strip().split()]
 nums2 = [[int(x) for x in s.strip().split()] for s in stdin.readlines()]
 ```
 
-### Leetcode
-
-Python lacks sorted associative containers like C++'s `std::set` and `std::map`. As a workaround, Leetcode supplies the [`sortedcontainers`](https://grantjenks.com/docs/sortedcontainers/) library to use on the platform (as mentioned [here](https://support.leetcode.com/hc/en-us/articles/360011833974-What-are-the-environments-for-the-programming-languages-)).
-
 ### Trie
 
 ```py
@@ -329,6 +364,10 @@ class Trie:
         return True
 ```
 
+### Leetcode
+
+Python lacks sorted associative containers like C++'s `std::set` and `std::map`. As a workaround, Leetcode supplies the [`sortedcontainers`](https://grantjenks.com/docs/sortedcontainers/) library to use on the platform (as mentioned [here](https://support.leetcode.com/hc/en-us/articles/360011833974-What-are-the-environments-for-the-programming-languages-)).
+
 
 ## TODO