astro.config.mjs

@@ -25,7 +25,7 @@ export default defineConfig({
   integrations: [
     sitemap(),
     starlight({
-      title: "Alex Lebens Docs",
+      title: "Documentation",
       head: [
         {
           tag: 'script',

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/orcaslicer.mdx

@@ -4,11 +4,21 @@ description: Desktop software to connect to the 3D printer
 hero:
   tagline: Desktop software to connect to the 3D printer
   image:
-    file: https://cdn.shopify.com/s/files/1/0893/0603/8637/files/K1-_02-2.png?v=1762200477
+    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>
 
@@ -16,9 +26,13 @@ import { Steps } from '@astrojs/starlight/components';
 
 <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>
 
@@ -33,9 +47,15 @@ Download them [with this link here](https://github.com/Guilouz/Creality-Helper-S
 <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`
@@ -45,6 +65,8 @@ Download them [with this link here](https://github.com/Guilouz/Creality-Helper-S
     - 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'
@@ -54,6 +76,10 @@ Download them [with this link here](https://github.com/Guilouz/Creality-Helper-S
 ## 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`

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

@@ -9,6 +9,14 @@ hero:
 
 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>
 
@@ -27,13 +35,23 @@ The most common file type to use are STL, but the printer can also use OBJ or 3M
 
 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.
 
-3. This opens a menu to select a file to upload.
+    <Image src={orcaAddModel} alt="OrcaSlicer add model button" width="800" />
 
-4. Once the model is in the 3D view various options are available to arrange or make adjustments to.
+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
+title: Documentation
-description: Guides and reference for my homelab infrastructure.
+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: