chore(release): 0.31.0 [skip ci]

# [0.31.0](http://gitea-http.gitea:3000/alexlebens/site-documentation/compare/0.30.0...0.31.0) (2026-05-13)

### Features

* add images ([55fc528](55fc528c22))
* arrange reference ([e23f5bf](e23f5bfc51))
* fix imports and images ([23c02c5](23c02c531b))
* refresh index page ([3b65649](3b656496e9))

CHANGELOG.md

@@ -1,3 +1,36 @@
+# [0.31.0](http://gitea-http.gitea:3000/alexlebens/site-documentation/compare/0.30.0...0.31.0) (2026-05-13)
+
+
+### Features
+
+* add images ([55fc528](http://gitea-http.gitea:3000/alexlebens/site-documentation/commit/55fc528c2288c47e2d592ea339b134b10f315735))
+* arrange reference ([e23f5bf](http://gitea-http.gitea:3000/alexlebens/site-documentation/commit/e23f5bfc51ad1c91ba62496ee353575eabff3627))
+* fix imports and images ([23c02c5](http://gitea-http.gitea:3000/alexlebens/site-documentation/commit/23c02c531b445d623c4e2506a3d0efdc93e5922f))
+* refresh index page ([3b65649](http://gitea-http.gitea:3000/alexlebens/site-documentation/commit/3b656496e97e57fa372d767895fa4077c9a0c836))
+
+# [0.30.0](http://gitea-http.gitea:3000/alexlebens/site-documentation/compare/0.29.0...0.30.0) (2026-05-12)
+
+
+### Features
+
+* add 3d printer docs ([fac3a99](http://gitea-http.gitea:3000/alexlebens/site-documentation/commit/fac3a999d64e499e92b0123f2a9b03074f4d4008))
+
+# [0.29.0](http://gitea-http.gitea:3000/alexlebens/site-documentation/compare/0.28.0...0.29.0) (2026-05-08)
+
+
+### Bug Fixes
+
+* **deps:** update dependency @astrojs/starlight to v0.38.5 ([0b8f720](http://gitea-http.gitea:3000/alexlebens/site-documentation/commit/0b8f720d6afc765759a3f5bfef1ec1a575247e4f))
+* **deps:** update dependency astro to v6.1.10 ([5c36a1f](http://gitea-http.gitea:3000/alexlebens/site-documentation/commit/5c36a1f31d8098828fe790dcb307ef6f391a53a0))
+* **deps:** update dependency astro to v6.2.2 ([9b57393](http://gitea-http.gitea:3000/alexlebens/site-documentation/commit/9b57393281b55441ef6786ed597519e0f6280e93))
+
+
+### Features
+
+* allow processing svg ([c7b49df](http://gitea-http.gitea:3000/alexlebens/site-documentation/commit/c7b49df433d25f343e336fdf5f972f479a2cd07e))
+* rebase ([1b34c03](http://gitea-http.gitea:3000/alexlebens/site-documentation/commit/1b34c03861824b350d144d7dabbe1d10111b86e1))
+* rebase ([a2bae2b](http://gitea-http.gitea:3000/alexlebens/site-documentation/commit/a2bae2bb1b2cb39005ded7c24a15705c0aea6695))
+
 # [0.28.0](http://gitea-http.gitea:3000/alexlebens/site-documentation/compare/0.27.1...0.28.0) (2026-04-27)
 
 

astro.config.mjs

@@ -16,12 +16,16 @@ const getSiteURL = () => {
 export default defineConfig({
   site: getSiteURL(),
 
+  image: {
+    dangerouslyProcessSVG: true
+  },
+
   prefetch: true,
 
   integrations: [
     sitemap(),
     starlight({
-      title: "Alex Lebens Docs",
+      title: "Documentation",
       head: [
         {
           tag: 'script',
@@ -37,7 +41,7 @@ export default defineConfig({
       ],
       expressiveCode: {
         themes: ['vitesse-light', 'vitesse-dark'],
-      },      
+      },
       social: [
         {
           icon: "external",
@@ -50,20 +54,20 @@ export default defineConfig({
       ],
       sidebar: [
         {
-          label: "Reference",
-          autogenerate: { directory: "reference" },
+          label: 'Reference',
+          items: [{ autogenerate: { "directory": "reference" } }]
         },
         {
-          label: "Guides",
-          autogenerate: { directory: "guides" },
+          label: 'Guides',
+          items: [{ autogenerate: { "directory": "guides" } }]
         },
         {
-          label: "Applications",
+          label: 'Applications',
           collapsed: true,
-          autogenerate: { directory: "applications" },
-        },
+          items: [{ autogenerate: { "directory": "applications" } }]
+        },                
       ],
-    })  
+    })
   ],
 
   output: 'static',

package.json

@@ -1,7 +1,7 @@
 {
   "name": "site-documentation",
   "type": "module",
-  "version": "0.28.0",
+  "version": "0.31.0",
   "scripts": {
     "dev": "astro dev",
     "build": "astro build",
@@ -13,16 +13,16 @@
   },
   "dependencies": {
     "@astrojs/mdx": "5.0.4",
-    "@astrojs/node": "10.0.6",
+    "@astrojs/node": "10.1.0",
     "@astrojs/sitemap": "3.7.2",
-    "@astrojs/starlight": "0.38.4",
-    "@tailwindcss/postcss": "4.2.4",
-    "@tailwindcss/vite": "4.2.4",
-    "astro": "6.1.10",
+    "@astrojs/starlight": "0.39.2",
+    "@tailwindcss/postcss": "4.3.0",
+    "@tailwindcss/vite": "4.3.0",
+    "astro": "6.3.1",
     "sanitize-html": "2.17.3",
     "sharp": "0.34.5",
     "starlight-theme-rapide": "0.5.2",
-    "tailwindcss": "4.2.4"
+    "tailwindcss": "4.3.0"
   },
   "devDependencies": {
     "@saithodev/semantic-release-gitea": "2.1.0",
@@ -30,11 +30,11 @@
     "@semantic-release/commit-analyzer": "13.0.1",
     "@semantic-release/git": "10.0.1",
     "@semantic-release/npm": "13.1.5",
-    "@semantic-release/release-notes-generator": "14.1.0",
+    "@semantic-release/release-notes-generator": "14.1.1",
     "@tailwindcss/forms": "0.5.11",
     "@tailwindcss/typography": "0.5.19",
-    "@typescript-eslint/parser": "8.59.1",
-    "eslint": "10.2.1",
+    "@typescript-eslint/parser": "8.59.3",
+    "eslint": "10.3.0",
     "eslint-config-prettier": "10.1.8",
     "eslint-plugin-astro": "1.7.0",
     "prettier": "3.8.3",
@@ -43,6 +43,6 @@
     "semantic-release": "25.0.3",
     "semantic-release-export-data": "1.2.0",
     "typescript": "6.0.3",
-    "typescript-eslint": "8.59.1"
+    "typescript-eslint": "8.59.3"
   }
 }

src/assets/documentation.svg

@@ -0,0 +1,2 @@
+<?xml version='1.0' encoding='utf-8'?>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128.07 128.07"> <g transform="translate(-619.25 -107.78)"> <path transform="matrix(1.4138 0 0 1.4138 -272.18 -544.05)" d="m721.12 506.35c0 25.014-20.278 45.293-45.293 45.293s-45.293-20.278-45.293-45.293 20.278-45.293 45.293-45.293 45.293 20.278 45.293 45.293z" fill="#00a9eb" fill-rule="evenodd"/> <path d="m634.2 202.31v-54.545l47.534-6.2481 50.647 6.2481v54.545l-40.786-5.4545c-0.12263 3.0124-3.7857 5.4545-8.3043 5.4545s-8.1817-2.442-8.1817-5.4545c-13.071 1.7709-27.398 3.6584-40.909 5.4545" fill="none" stroke="#fff" stroke-linecap="round" stroke-linejoin="round" stroke-width="2.7272"/> <g fill="#00a9eb" stroke="#fff" stroke-linecap="round" stroke-linejoin="round" stroke-width="2.5"> <g transform="matrix(1.2097 0 0 1.0892 7.9737 22.346)"> <path d="m558.25 109.14s-3.0418-3.2531-7.0588-2.521c-4.0116 0.73113-11.421 3.8517-15.382 4.822-4.1537 1.0176-13.158 1.4144-13.158 1.4144l0.40093 47.094s9.0506-0.65837 13.204-1.676c3.9606-0.97028 11.37-4.0908 15.382-4.822 4.0171-0.73211 6.9696 2.7393 6.9696 2.7393z"/> <path d="m558.25 109.14s3.0418-3.2531 7.0588-2.521c4.0116 0.73113 11.421 3.8517 15.382 4.822 4.1537 1.0176 13.158 1.4144 13.158 1.4144l-0.40093 47.094s-9.0506-0.65837-13.204-1.676c-3.9606-0.97028-11.37-4.0908-15.382-4.822-4.0171-0.73211-6.2542 2.7393-6.2542 2.7393z"/> </g> <g transform="matrix(1.078 0 0 1.078 20.346 -219.36)"> <path d="m615 331.84s-3.0418-3.2531-7.0588-2.521c-4.0116 0.73113-11.421 3.8517-15.382 4.822-4.1537 1.0176-13.158 1.4144-13.158 1.4144l0.40093 47.094s9.0506-0.65837 13.204-1.676c3.9606-0.97028 11.37-4.0908 15.382-4.822 4.0171-0.73211 6.9696 2.7393 6.9696 2.7393z"/> <path d="m615 331.84s3.0418-3.2531 7.0588-2.521c4.0116 0.73113 11.421 3.8517 15.382 4.822 4.1537 1.0176 13.158 1.4144 13.158 1.4144l-0.40093 47.094s-9.0506-0.65837-13.204-1.676c-3.9606-0.97028-11.37-4.0908-15.382-4.822-4.0171-0.73211-6.2542 2.7393-6.2542 2.7393z"/> </g> </g> <path d="m700.84 143.67c-2.6596 1.9895-1.6698 4.1865-0.0468 6.5739 0.65358 1.1396 0.69335 2.3824 0.77867 3.0591-0.13829 1.7516-0.8444 9.1181-0.89615 20.533-4e-3 0.68587 0.14646 2.5672-0.46053 3.0055-2.5451 1.8381-2.5 3.2512-1.9733 4.5155 0.0603 0.1468 1.2872 3.3561 3.5734 3.7902 0.49242 0.0936-0.77826-3.2492-0.6852-3.7708 0.28125-1.5763 4.0814-1.4458 4.4527-0.68662 0.41465 0.84653 1.0171 3.8604 1.2121 3.62 0.71906-0.88383 1.9656-4.8157 0.26993-6.0306-2.3917-1.7133-2.24-3.5187-2.2392-3.6732 0.0275-5.0256 0.39083-15.911 0.57885-20.883 0.0449-1.1889 0.41761-1.8486 0.75637-2.6228 0.43468-0.99366 2.1954-1.3002 2.4991-2.5112 0.4992-1.9903-2.3377-4.8089-3.2468-5.1396-0.4704-0.17116 0.96583 3.5773 0.61554 3.9791-0.62854 0.72035-3.2089 0.72167-3.9357 0.21033-1.003-0.70539-0.35936-3.7274-1.2521-3.9692z" fill="#fff" fill-rule="evenodd"/> </g> </svg>

src/content/docs/guides/3D Printer/mainsail.mdx

@@ -0,0 +1,18 @@
+---
+title: Mainsail
+description: Web interface for the 3D Printer
+hero:
+  tagline: Web interface for the 3D Printer
+  image:
+    file: https://raw.githubusercontent.com/mainsail-crew/mainsail/6130a0aa1776a138feaab691b9e4b1334b676b79/public/img/logo.svg
+---
+
+import { Aside } from '@astrojs/starlight/components';
+
+<Aside type="tip">Quickly connect to its web page [here](http://printer.lebens-home.net/).</Aside>
+
+# Overview
+
+[Mainsail](https://docs.mainsail.xyz/) is the popular web interface for managing and controlling 3D printers with [Klipper](https://www.klipper3d.org/).
+
+[Source](https://github.com/mainsail-crew/mainsail)

src/content/docs/guides/3D Printer/orcaslicer.mdx

@@ -0,0 +1,88 @@
+---
+title: Setting up Orcaslicer
+description: Desktop software to connect to the 3D printer
+hero:
+  tagline: Desktop software to connect to the 3D printer
+  image:
+    file: https://raw.githubusercontent.com/OrcaSlicer/OrcaSlicer/a167702038496b97e8495cc79f0c62660063ac87/resources/images/studio_logo.svg
+---
+
+import { Aside } from '@astrojs/starlight/components';
+import { Steps } from '@astrojs/starlight/components';
+import { Image } from 'astro:assets';
+
+import orcaRelease from '@/assets/images/guides/orcaslicer/release.png';
+import orcaAssets from '@/assets/images/guides/orcaslicer/assets.png';
+import orcaPrepare from '@/assets/images/guides/orcaslicer/prepare-tab.png';
+import orcaDropdown from '@/assets/images/guides/orcaslicer/dropdown.png';
+import orcaCreatePrinter from '@/assets/images/guides/orcaslicer/create-printer.png';
+import orcaPreset from '@/assets/images/guides/orcaslicer/preset.png';
+import orcaConnection from '@/assets/images/guides/orcaslicer/connection.png';
+import orcaConnectionSettings from '@/assets/images/guides/orcaslicer/connection-settings.png';
+
+<Aside type="tip">Quickly connect to its web page [here](http://printer.lebens-home.net).</Aside>
+
+# Download and Install OrcaSlicer
+
+<Steps>
+1. Go to the [Releases](https://github.com/OrcaSlicer/OrcaSlicer/releases) and find the 'Latest' Official Release. Some are tagged as 'Pre-release' such as nightlys or release candidates, ignore those.
+
+    <Image src={orcaRelease} alt="OrcaSlicer release page" width="800" />
+
+2. At the bottom of a Release is the Assets section. Download the package for your OS such as the exe for Windows or the dmg for Mac.
+
+    <Image src={orcaAssets} alt="OrcaSlicer release page, assets section" width="800" />
+
+4. Install the package.
+</Steps>
+
+## Build Plates
+
+These will give you a model of the build plates the 3D printer will print upon for accurate sizing and representation.
+
+Download them [with this link here](https://github.com/Guilouz/Creality-Helper-Script-Wiki/raw/main/downloads/OrcaSlicer/Creality_K1.zip) then extract the zip.
+
+## Create Printer
+
+<Steps>
+1. Go to the 'Prepare' tab on the navigation menu.
+
+    <Image src={orcaPrepare} alt="OrcaSlicer prepare tab" width="800" />
+
+2. At the left should be a menu for various options, find 'Printer' at the very top
+
+    <Image src={orcaDropdown} alt="OrcaSlicer printer options" width="800" />
+
+3. Click on the drop-down and select `--Create Printer --`
+
+    <Image src={orcaCreatePrinter} alt="OrcaSlicer printer preset" width="800" />
+    - Printer Vendor is `Creality`
+    - Printer model is `Creality K1C`, this may be near the bottom of the list
+    - Nozzle diameter is `0.4 mm`
+    - Printable Space is `X 200 mm` and `Y 220 mm`
+    - Hot Bed STL should upload the build plate .stl file
+    - Hot Bed SVG should upload the build plate .png file
+    - Max Print Height is `200mm`
+
+4. Click OK and will go to 'Import Preset'
+
+    <Image src={orcaPreset} alt="OrcaSlicer import preset" width="800" />
+    - For 'Printer Preset' select `Creality` and `Creality K1C @ 0.4 Nozzle`
+    - For 'Preset' click `Create Based on Current Printer`
+    - Under the 'Filament Preset Template' section check boxes for filaments types being used, likely just 'PLA'
+    - Under the 'Process Preset Template' section check `0.20mm Standard @Creality K1C`
+</Steps>
+
+## Connect to Printer
+
+Once the Printer has been created slightly above and to the right should be an icon that looks like a wifi icon, click this.
+<Image src={orcaConnection} alt="OrcaSlicer connection location" width="800" />
+
+Enter settings to connect to the 3D printer. Check to see if the 3D printer is on.
+<Image src={orcaConnectionSettings} alt="OrcaSlicer connection settings" width="800" />
+
+- Host Type is `Octo/Klipper`
+- Printer Agent is `OrcaSlicer`
+- Hostname is `http://printer.lebens-home.net`
+
+To confirm the connection go to the 'Device' tab at the top navigation menu.

src/content/docs/guides/3D Printer/overview.mdx

@@ -0,0 +1,51 @@
+---
+title: 3D Printer Overview
+description: Specifications and basic information about the 3D printer
+hero:
+  tagline: Specifications and basic information about the 3D printer
+  image:
+    file: https://cdn.shopify.com/s/files/1/0893/0603/8637/files/K1-_02-2.png?v=1762200477
+---
+
+import { Aside } from '@astrojs/starlight/components';
+
+<Aside type="tip">Quickly connect to its web page [here](http://printer.lebens-home.net/).</Aside>
+
+# Overview
+
+The 3D printer is a [Creality K1C](https://www.creality.com/products/k1c-carbon-3d-printer) which has several features that make it somewhat more user-friendly, such as auto leveling. Notably this model does not include automatic multi filament switching that newer versions have. It does use open source software and [Mainsail](https://docs.mainsail.xyz/) is installed as its web interface.
+
+In order to print objects you first need a model, usually a stl file, then the model needs to be 'sliced' into instructions for the printer, then print. These guides document the process for this 3D printer.
+
+## Specifications
+
+| Atttribute| Size|
+|---|----|
+|  Filament Diameter |  1.75mm |
+|  Nozzle Diameter |  0.4mm |
+|  Layer Height |  0.1-0.35mm |
+|  Printing Accuracy |  100±0.1mm |
+|  Build Volume |  220\*220\*250mm |
+
+## Supported filament types
+
+ - ABS
+ - PLA
+ - PLA-CF
+ - PETG
+ - PET
+ - PET-CF
+ - TPU
+ - PA
+ - ASA
+ - PC
+
+## Slicing file formats
+
+- STL
+- OBJ
+- 3MF
+
+## Printable file formats
+
+- G-Code

src/content/docs/guides/3D Printer/print-model.mdx

@@ -0,0 +1,57 @@
+---
+title: Upload Model
+description: Load model into OrcaSlicer
+hero:
+  tagline: Load model into OrcaSlicer
+  image:
+    file: https://cdn.shopify.com/s/files/1/0893/0603/8637/files/K1-_02-2.png?v=1762200477
+---
+
+import { Aside } from '@astrojs/starlight/components';
+import { Steps } from '@astrojs/starlight/components';
+import { Image } from 'astro:assets';
+
+import orcaAddModel from '@/assets/images/guides/print-model/add-model.png';
+import orcaOptions from '@/assets/images/guides/print-model/options.png';
+import orcaSlice from '@/assets/images/guides/print-model/slice-button.png';
+import orcaSupport from '@/assets/images/guides/print-model/support-settings.png';
+import orcaInfill from '@/assets/images/guides/print-model/infill-settings.png';
+import orcaPrint from '@/assets/images/guides/print-model/print-button.png';
+
+<Aside type="tip">Quickly connect to its web page [here](http://printer.lebens-home.net).</Aside>
+
+# Download a Model
+
+There are various places to download models to print, such as [Thingverse](https://www.thingiverse.com/), [Printables](https://www.printables.com/), or [Makerworld](https://makerworld.com/en).
+
+A default test model is [Benchy](https://www.thingiverse.com/thing:763622).
+
+The most common file type to use are STL, but the printer can also use OBJ or 3MF
+
+# Load and Print Model
+
+<Steps>
+1. In OrcaSlicer go to the 'Prepare' tab on the navigation menu. The sidebar isn't needed at this point, you may collapse it with a button at its top right, or by pressing `Shift-Tab`
+
+2. The printer view should now fill the screen. At the top, below the navigation menu is a tool menu. The farthest left icon is a cube, click this to add a model.
+
+    <Image src={orcaAddModel} alt="OrcaSlicer add model button" width="800" />
+
+3. This opens a menu to select a file to upload. Select the file you have downloaded and want to print.
+
+4. Once the model is in the 3D view various options are available to arrange or make adjustments.
+
+    <Image src={orcaOptions} alt="OrcaSlicer options bar" width="800" />
+
+5. Next is to convert this 3D representation into instructions for the printer, this process is called slicing. At the top right are two buttons, click 'Slice plate'. Depending on the complexity this may take time.
+
+    <Image src={orcaSlice} alt="OrcaSlicer slice button" width="800" />
+
+6. Also depending on the complexity you may need to add support or change the infill. These are options in the sidebar. After any adjustments made the model should be sliced again.
+
+    <Image src={orcaSupport} alt="OrcaSlicer support settings" width="800" /><Image src={orcaInfill} alt="OrcaSlicer infill settings" width="800" />
+
+7. Once ready and the representation in the printer view matches what is desired, click print to begin the process.
+
+    <Image src={orcaPrint} alt="OrcaSlicer print button" width="800" />
+</Steps>

src/content/docs/index.mdx

@@ -1,10 +1,10 @@
 ---
-title: Documentation for my Homelab
-description: Guides and reference for my homelab infrastructure.
+title: Documentation
+description: Guides and reference
 hero:
-  tagline: Guides and reference for my homelab infrastructure.
+  tagline: Guides and reference
   image:
-    file: ../../assets/autumn_mountain.png
+    file: ../../assets/documentation.svg
   actions:
     - text: Introduction
       link: /reference/introduction/
@@ -26,4 +26,9 @@ import { Card, CardGrid, LinkCard } from '@astrojs/starlight/components';
     description="This site is built with Starlight, the Astro documentation theme. Check out the docs to learn more."
     href="https://starlight.astro.build/"
   ></LinkCard>
+  <LinkCard
+    title="Get started with the 3D Printer"
+    description="Guide for setting up OrcaSlicer"
+    href="https://docs.alexlebens.dev/guides/3d-printer/orcaslicer/"
+  ></LinkCard>  
 </CardGrid>

src/content/docs/reference/3d-printer.mdx

@@ -0,0 +1,51 @@
+---
+title: 3D Printer
+description: Specifications and basic information about the 3D printer
+hero:
+  tagline: Specifications and basic information about the 3D printer
+  image:
+    file: https://cdn.shopify.com/s/files/1/0893/0603/8637/files/K1-_02-2.png?v=1762200477
+---
+
+import { Aside } from '@astrojs/starlight/components';
+
+<Aside type="tip">Quickly connect to its web page [here](http://printer.lebens-home.net/).</Aside>
+
+# Overview
+
+The 3D printer is a [Creality K1C](https://www.creality.com/products/k1c-carbon-3d-printer) which has several features that make it somewhat more user-friendly, such as auto leveling. Notably this model does not include automatic multi filament switching that newer versions have. It does use open source software and [Mainsail](https://docs.mainsail.xyz/) is installed as its web interface.
+
+In order to print objects you first need a model, usually a stl file, then the model needs to be 'sliced' into instructions for the printer, then print. These guides document the process for this 3D printer.
+
+## Specifications
+
+| Atttribute| Size|
+|---|----|
+|  Filament Diameter |  1.75mm |
+|  Nozzle Diameter |  0.4mm |
+|  Layer Height |  0.1-0.35mm |
+|  Printing Accuracy |  100±0.1mm |
+|  Build Volume |  220\*220\*250mm |
+
+## Supported filament types
+
+ - ABS
+ - PLA
+ - PLA-CF
+ - PETG
+ - PET
+ - PET-CF
+ - TPU
+ - PA
+ - ASA
+ - PC
+
+## Slicing file formats
+
+- STL
+- OBJ
+- 3MF
+
+## Printable file formats
+
+- G-Code

src/content/docs/reference/homelab.mdx

@@ -1,8 +1,8 @@
 ---
-title: Introduction
+title: Homelab
 description: Overiew of the homelab
 hero:
-  tagline: Steps followed for the v1.12.0 upgrade process
+  tagline: Overiew of the homelab
   image:
     file: https://cdn.jsdelivr.net/gh/selfhst/icons@main/webp/docs-collaboration.webp
 sidebar: