feat: minor content update

marcus8448 · marcus8448 · commit fd45bd337666 · 2025-05-04T22:48:42.000-07:00
improvements to phrasing, style
diff --git a/assets/main.css b/assets/main.css
@@ -57,16 +57,12 @@ h6 {
 }
 
 .writing {
-  > h1 {
-    @apply mb-4;
-  }
-
   > h2 {
-    @apply text-3xl mt-4 mb-3;
+    @apply text-3xl mt-6 mb-3;
   }
 
   > h3 {
-    @apply mt-4 -mb-2;
+    @apply mt-5 -mb-2;
   }
 
   > p {
diff --git a/content/projects/_index.md b/content/projects/_index.md
@@ -1,7 +1,6 @@
 ---
 title: "Projects"
 description: Things I've created
-heroType: is-background-light-blue-soft
 ---
 
 # Projects
diff --git a/content/projects/chat.md b/content/projects/chat.md
@@ -1,34 +1,30 @@
 ---
 title: Chat
 subtitle: An encrypted, ephemeral instant messaging app.
-date: 2023-06-12T00:00:00-00:00
+date: 2023-06-12T12:00:00-00:00
 icon: /image/chat.png
-Description: |
+description: |
   An encrypted, ephemeral instant messaging app.
 repository: https://github.com/marcus8448/Chat
-heroType: has-background-light-soft
 languages:
   - java
   - gradle
 ---
 
 ## About
-
-This was a project that I made in approximately 2 weeks to gain more experience using JavaFX.
-This time I avoided FXML and defined the GUI in pure Java.
+This was a project that I made in approximately 2 weeks to gain more experience with networking and JavaFX.
 It uses a multi-project Gradle build to enable code sharing between the client and server applications,
 while keeping them as separate binaries.
 
 I found it interesting to compare the strengths and weaknesses of different cryptographic ciphers for this project.
-Originally, everything was based on RSA keys,
-until I realized the max block size could not support large messages (and thereby moved to use AES session keys).
+RSA keys are used for client/server identities,
+while AES keys are used to encrypt the session after the initial handshake.
 
 ## Features
-
 * Channel support
 * System tray notification support
 * Support for sending both text and images
-* Messages are encrypted over the network (however, they are not end-to-end encrypted)
+* Messages are encrypted over the network (however, they are **not** end-to-end encrypted)
 * The server saves no user information
   * User accounts are based on RSA keys
   * Server just acts as a router
@@ -38,9 +34,7 @@ until I realized the max block size could not support large messages (and thereb
 * User account data stored on the client is encrypted with a password using PBKDF2
 
 ## Security
-
 ### Initial Handshake
-
 Upon connecting to a server, the client and server exchange public RSA keys.
 If the server's RSA key has changed,
 or the client has never connected to the server before,
@@ -50,18 +44,15 @@ The server then sends a session AES key, encrypted with the client's public key.
 This key is used to encrypt all future messages sent between the client and server.
 
 ### Message Signatures
-
 All messages are signed with the sender's RSA private key.
 Keys can be marked as 'trusted' in the client, and given nicknames.
 If a message is signed by a key that is not trusted, the client will display a warning.
 
 ### Client-side Security
-
 The client stores user account data in a file encrypted with a PBKDF2 key derived from the user's password.
 This prevents the user's account data from being used if the file is stolen.
 However, this also means that if the user forgets their password, they will lose all their account data.
 
 ### Disclaimer
-
 While I hope the application is secure, I cannot guarantee the security of messages sent.
 Use at your own risk!
diff --git a/content/projects/galacticraft.md b/content/projects/galacticraft.md
@@ -1,12 +1,10 @@
 ---
-title: "Galacticraft"
+title: Galacticraft
 subtitle: An advanced space mod for Minecraft.
 date: 2019-03-18T11:12:29-07:00
 icon: /image/galacticraft.png
-Description: |
+description: |
   A Minecraft mod centered around space exploration using the [FabricMC](https://fabricmc.net/) modding framework.
-HeroImage: /image/hero/galacticraft.png
-heroType: is-dark
 repository: https://github.com/TeamGalacticraft/Galacticraft
 link: https://galacticraft.net/
 modrinth: galacticraft-legacy
diff --git a/content/projects/gamemodeoverhaul.md b/content/projects/gamemodeoverhaul.md
@@ -3,30 +3,32 @@ title: Gamemode<wbr />Overhaul
 subtitle: Minecraft mod with over 500,000 downloads
 date: 2019-02-16T00:00:00-00:00
 icon: /image/gamemodeoverhaul.png
-Description: |
+description: |
   A mod for Minecraft that restores command options removed in the 1.13 update.
   Also adds some shorthand commands for convenience.
 repository: https://github.com/marcus8448/MinecraftMods
 modrinth: gamemodeoverhaul
 curseforge: gamemodeoverhaul
-heroType: has-background-light-soft
 languages:
   - java
   - gradle
 ---
 
 ## About
 
-This was my first proper Minecraft modification, originally released in February 2019.
-Created in about two weeks, the original goal of this mod was just restore the removed integer `/gamemode` arguments,
-but its scope steadily expanded to other commands and aliases.
+This was my first published Minecraft modification, originally released in February 2019.
+Created in the span of two weeks, the original goal of this mod was to simply restore the integer `/gamemode` arguments
+(which were removed in the 1.13 update), but has since expanded to include other commands and aliases.
 
-Now GamemodeOverhaul is a fully configurable mod
-that supports over eight versions of Minecraft on two different mod loaders (in a shared codebase utilizing java SPI!).
+GamemodeOverhaul supports over eight versions of Minecraft and two different mod loaders.
 Since its initial release, GamemodeOverhaul has seen over 500,000 downloads.
 
 ## Features
 
+* Supports both Fabric and NeoForge
+  * Install to your mod loader of choice!
+* Fully configurable
+  * Enable or disable commands (and aliases) as needed
 * Restores command arguments removed in 1.13
   * `/gamemode 0/1/2/3,s/c/a/sp`
   * `/defaultgamemode 0/1/2/3,s/c/a/sp`
diff --git a/content/projects/machinelib.md b/content/projects/machinelib.md
@@ -3,35 +3,41 @@ title: "Machine<wbr />Lib"
 subtitle: Library mod for Galacticraft
 date: 2022-03-05T09:46:52-08:00
 icon: /image/machinelib.png
-Description: |
+description: |
   A library for Minecraft mods that simplifies the implementation of complex blocks that process resources.
 repository: https://github.com/TeamGalacticraft/MachineLib
-heroType: has-background-light-soft
 languages:
   - java
   - gradle
 ---
 
-This library/mod aims to reduce the amount of boilerplate code required to implement blocks with inventories and menus.
-
 ## About
+MachineLib aims to reduce the amount of boilerplate code required to implement complicated "machine" blocks
+that interact with items, fluids and energy.
 
 Before MachineLib existed, Galacticraft used [UniversalComponents](https://github.com/CottonMC/UniversalComponents)
-to handle inventories, then [LibBlockAttributes](https://github.com/AlexIIL/LibBlockAttributes).
-When we were stuck waiting for these libraries to update,
+to handle inventories, before transitioning to [LibBlockAttributes](https://github.com/AlexIIL/LibBlockAttributes).
 I decided to try and make my own implementation using the newly standardized
-[transfer api](https://github.com/FabricMC/fabric/pull/1553), and created MachineLib.
+[transfer api](https://github.com/FabricMC/fabric/pull/1553),
+and created this project.
+MachineLib is attempts to take a "batteries-included" approach,
+with tight integration between the storage and block implementations with a focus on developer ergonomics.
 
-## Features
 
-* Builder-style resource storage (inventory) creation
-  * Slot resource filtering
-  * Define slot locations in one place
-  * Define acceptable external block interactions and player interactions by setting a slot's type
-* Comes with a base `BlockEntity` implementation
-  * Supports player-configurable resource I/O interactions with adjacent blocks
-  * Minecraft redstone (de)activation
-  * Supports storage of items, fluids and energy
-  * Additional utilities for blocks dealing with Minecraft's recipe system
-* Comes with extensible `GameTest`s
-  * Can automatically verify machine functionality
+## Features
+* Simplified builder-style resource storage (inventory) creation
+  * Define storage formats and limits in one place
+    * DRY - prevents repetition in the `BlockEntity`, `Menu`, and `Screen`
+  * Context-aware slot resource filtering
+    * Easily treat players and automated/external slot changes separately 
+  * Define acceptable external block interactions and player interactions at the slot level
+* Machine blocks have extra features out of the box
+  * Player-configurable resource I/O interactions with adjacent blocks
+    * Dynamic model generation reflects port changes in-world
+    * Comes with a built-in GUI to manage the configuration
+    * Push/pull transfer automatically handed based on selected ports
+  * Automatic (de)activation with Minecraft redstone signals
+  * Extended menu sychronization system
+    * No longer constrained to pure `int` synchronization
+* Comes with an extensible `GameTest` framework 
+  * Allows for full in-world testing of complicated machine setups
diff --git a/content/projects/robotics/v5_cli.md b/content/projects/robotics/v5_cli.md
@@ -1,33 +1,26 @@
 ---
-title: "v5_cli"
+title: v5_cli
 date: 2022-12-12T22:17:00-08:00
 icon: /image/v5_cli.png
-heroType: has-background-light-soft
-Description: A re-implementation of [pros-cli](https://github.com/purduesigbots/pros-cli) in Rust, adding bluetooth upload support.
+description: A re-implementation of [pros-cli](https://github.com/purduesigbots/pros-cli) in Rust, adding bluetooth upload support.
 repository: https://github.com/marcus8448/v5_cli
 languages:
   - rust
 ---
 
-# About
-
+## About
 After getting frustrated with [pros-cli](https://github.com/purduesigbots/pros-cli)
 freezing my terminal (to submit a bug report) every time an error occurred, I decided to create my own implementation.
 I chose to (re)write it in Rust mainly to gain experience with the language,
 but also because I was already familiar with one of its CLI frameworks, [clap](https://clap.rs/).
 
 Once I had made an app with about the same features as the original,
-I left the project alone until I discovered that [direct bluetooth connection](https://gist.github.com/wireboy5/e41444a135d7643c92fc3b83aa69058b)
-to the VEX V5 brain was possible.
+I left the project alone until I discovered that direct bluetooth connection to the VEX V5 brain was possible
+(thanks to this [gist](https://gist.github.com/wireboy5/e41444a135d7643c92fc3b83aa69058b)) 
 This led me to try and enable wireless code upload over bluetooth LE.
-Using bluetooth was more difficult than I originally anticipated as bluetooth APIs tend to be asynchronous
-and bluetooth connections are significantly less reliable than wired ones.
-This required me to rearchitect the project to use asynchronous Rust,
-and account for packet loss and/or corruption in-transit.
-
-
-# Features
+The project had to be re-architectured to have more robust error handling (due to packet loss) and to support multiple backends.
 
+## Features
 * Connect to V5 robot via usb or wirelessly via bluetooth
   * Significantly better throughput compared to VEXnet controller connections. 
 * Upload binaries
@@ -39,4 +32,4 @@ and account for packet loss and/or corruption in-transit.
 * List connected V5 devices
 * Keep robot connection alive with a daemon
   * Automatically reconnects if connection is lost
-  * Allows for interaction with standard i/o and the system i/o simultaneously
+  * Allows for simultaneous interaction with standard i/o and the system i/o
diff --git a/content/projects/robotics/vex-v5.md b/content/projects/robotics/vex-v5.md
@@ -1,31 +1,26 @@
 ---
-title: "VEX V5"
+title: VEX V5
 date: 2021-11-16T18:07:43-07:00
 icon: /image/vex-v5.png
-Description: |
+description: |
   I participated in the [Vex Robotics Competition](https://www.vexrobotics.com/v5/competition/)
   from 2021-2024.
 repository: https://github.com/marcus8448/VexV5
-heroType: has-background-light-soft
 languages:
   - c
   - cplusplus
   - cmake
 ---
 
-# About
-
-In 2021, I started competing in the VEX robotics competition.
-This was my first real application using C++ (ignoring Arduino).
-On the tooling side, I learned about makefiles and managing dependencies in the C/C++ ecosystem.
+## About
+From 2021-2024, I started competed in the VEX robotics competition.
+Being an embedded C/C++ project, I learned lots about cross compilation and build systems.
+On the robotics side, I learned some basic control theory to make the robot run as smooth as possible.
 
 To improve IDE integration and remove platform-specific build code,
-I rewrote the program's makefile as a CMake project in my second year of robotics.
-Compared to Makefiles, I found CMake to be much simpler to use and quickly iterate on.
-It handled cross-compilation surprisingly well and made building with different compilers significantly easier.
-
-# Features
+I translated the program's makefile into a CMake project.
 
+## Features
 * Runtime sensor diagnostic information and debug tools on the screen (LVGL)
   * Runtime PID tuning
   * Real-time graphing of sensor information
diff --git a/content/projects/website.md b/content/projects/website.md
@@ -1,12 +1,11 @@
 ---
-title: "Website"
+title: Website
 date: 2020-05-24T16:25:24-07:00
 icon: https://avatars.githubusercontent.com/u/28928887?v=4
-Description: |
-  My portfolio/website. Built with Hugo and Bulma and hosted on GitHub Pages.
+description: |
+  My website. Built with Hugo, styled with TailwindCSS, and hosted on GitHub Pages.
 repository: https://github.com/marcus8448/marcus8448.github.io
 link: https://marcus8448.github.io/
-heroType: has-background-light-soft
 
 languages:
   - hugo
@@ -15,21 +14,33 @@ languages:
 ---
 
 ## About
+This website is generated using [Hugo] and hosted on GitHub Pages.
+The theme is custom-designed using utility classes from [TailwindCSS].
+The majority of the icons used on the site are from [Simple Icons] and [Font Awesome].
 
-My original website (2020) was generated using a single handwritten template with Jekyll.
-It had a basic navbar and not much else.
-I used Jekyll because it was the native site generator for GitHub pages.
+This iteration of the website replaced Bulma with Tailwind
+to get more fine-grained control over the design of the website.
+Another contributing factor was the excessive size of the Bulma CSS stylesheet.
+The extensive use of CSS variables in Bulma 1.0 caused the minified stylesheet to exceed 100KB in size. 
 
-In 2021, I decided to revamp the website.
-This time I used [Bulma](https://bulma.io/) to style the page,
+## Previous Versions
+### Jekyll (2020-2021)
+This was my original website. It was generated with Jekyll, using a single handwritten template.
+It had a basic navbar and minimal content.
+I used Jekyll out of convenience - it was the native site generator for GitHub pages.
+
+### Jekyll + Bulma (2021-2023)
+In 2021, I decided to revamp the design of the website.
+This time I used [Bulma] to style the page,
 and proper templating to generate the content and layout (e.g., iterating over project pages to generate the index).
 
-In 2023, I replaced Jekyll with [Hugo](https://gohugo.io/) for templating and generation.
+### Hugo + Bulma (2023-2025)
+In 2023, I replaced Jekyll with [Hugo] for templating and generation.
 I decided on Hugo for its strong templating, fast speed, and simple setup.
 This time I tried to focus on making the website responsive, rather than solely desktop-oriented.
 
-The current website (as of 2025) now uses TailwindCSS rather than Bulma.
-Due to the extensive use of CSS variables in Bulma 1.0 (released 2024), the size of the project grew to over 100KB, minimized.
-
-The majority of the icons used on the site are from [Simple Icons](https://simpleicons.org/) 
-and [Font Awesome](https://github.com/FortAwesome/Font-Awesome).
+[Bulma]: https://bulma.io/
+[Font Awesome]: https://github.com/FortAwesome/Font-Awesome
+[Hugo]: https://gohugo.io/
+[Simple Icons]: https://simpleicons.org/
+[TailwindCSS]: https://tailwindcss.com/
diff --git a/layouts/blog/section.html b/layouts/blog/section.html
diff --git a/layouts/partials/hero.html b/layouts/partials/hero.html
diff --git a/layouts/projects/single.html b/layouts/projects/single.html

Original file line number	Diff line number	Diff line change
`@@ -57,16 +57,12 @@ h6 {`
`57`	`57`	`}`
`58`	`58`
`59`	`59`	`.writing {`
`60`		`- > h1 {`
`61`		`- @apply mb-4;`
`62`		`- }`
`63`		`-`
`64`	`60`	`> h2 {`
`65`		`- @apply text-3xl mt-4 mb-3;`
	`61`	`+ @apply text-3xl mt-6 mb-3;`
`66`	`62`	`}`
`67`	`63`
`68`	`64`	`> h3 {`
`69`		`- @apply mt-4 -mb-2;`
	`65`	`+ @apply mt-5 -mb-2;`
`70`	`66`	`}`
`71`	`67`
`72`	`68`	`> p {`