Compare commits

...

12 Commits

Author SHA1 Message Date
semantic-release-bot
365e7f7fdf chore(release): 0.30.0 [skip ci]
# [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](fac3a999d6))
2026-05-12 02:23:54 +00:00
0b041523ae Merge pull request 'main' (#263) from main into release
All checks were successful
release-image / guarddog (push) Successful in 2m14s
release-image / build (push) Successful in 4m5s
release-image / semantic-release (push) Successful in 25s
release-image / release-harbor (push) Successful in 5m37s
release-image / release-gitea (push) Successful in 6m23s
Reviewed-on: #263
2026-05-12 02:19:34 +00:00
0427186766 chore(deps): update typescript-eslint monorepo to v8.59.3
Some checks are pending
renovate/stability-days Updates have not met minimum release age requirement
test-build / build (pull_request) Successful in 1m10s
test-build / build (push) Successful in 1m28s
test-build / guarddog (pull_request) Successful in 2m53s
test-build / guarddog (push) Successful in 2m41s
renovate / renovate (push) Successful in 37s
2026-05-12 02:15:14 +00:00
fac3a999d6 feat: add 3d printer docs
All checks were successful
test-build / build (push) Successful in 1m4s
test-build / guarddog (push) Successful in 3m10s
2026-05-11 21:11:42 -05:00
semantic-release-bot
20b66b8aad chore(release): 0.29.0 [skip ci]
# [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](0b8f720d6a))
* **deps:** update dependency astro to v6.1.10 ([5c36a1f](5c36a1f31d))
* **deps:** update dependency astro to v6.2.2 ([9b57393](9b57393281))

### Features

* allow processing svg ([c7b49df](c7b49df433))
* rebase ([1b34c03](1b34c03861))
* rebase ([a2bae2b](a2bae2bb1b))
2026-05-08 23:28:49 +00:00
1b34c03861 feat: rebase
All checks were successful
test-build / guarddog (push) Successful in 25s
test-build / build (push) Successful in 1m27s
release-image / guarddog (push) Successful in 30s
release-image / build (push) Successful in 47s
release-image / semantic-release (push) Successful in 41s
release-image / release-harbor (push) Successful in 8m41s
release-image / release-gitea (push) Successful in 4m1s
renovate / renovate (push) Successful in 1m20s
2026-05-08 17:51:23 -05:00
a2bae2bb1b feat: rebase 2026-05-08 17:50:58 -05:00
c7b49df433 feat: allow processing svg 2026-05-08 17:50:31 -05:00
0b8f720d6a fix(deps): update dependency @astrojs/starlight to v0.38.5
All checks were successful
renovate/stability-days Updates have met minimum release age requirement
test-build / guarddog (pull_request) Successful in 2m34s
test-build / build (pull_request) Successful in 3m3s
test-build / build (push) Successful in 3m27s
test-build / guarddog (push) Successful in 4m0s
renovate / renovate (push) Successful in 1m29s
2026-05-07 00:02:36 +00:00
9b57393281 fix(deps): update dependency astro to v6.2.2
All checks were successful
renovate/stability-days Updates have met minimum release age requirement
test-build / guarddog (pull_request) Successful in 33s
test-build / guarddog (push) Successful in 36s
test-build / build (push) Successful in 7m8s
test-build / build (pull_request) Successful in 7m28s
renovate / renovate (push) Successful in 2m54s
2026-05-06 00:02:26 +00:00
7cfcba400e chore(deps): update typescript-eslint monorepo to v8.59.2
All checks were successful
renovate/stability-days Updates have met minimum release age requirement
test-build / guarddog (pull_request) Successful in 39s
test-build / build (pull_request) Successful in 1m42s
test-build / guarddog (push) Successful in 1m16s
test-build / build (push) Successful in 1m35s
renovate / renovate (push) Successful in 2m30s
2026-05-05 18:01:53 +00:00
1565dea7bb chore(deps): update deps
All checks were successful
test-build / guarddog (push) Successful in 40s
test-build / build (push) Successful in 1m49s
renovate / renovate (push) Successful in 2m26s
2026-05-01 19:52:53 -05:00
8 changed files with 669 additions and 604 deletions

View File

@@ -1,3 +1,26 @@
# [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) # [0.28.0](http://gitea-http.gitea:3000/alexlebens/site-documentation/compare/0.27.1...0.28.0) (2026-04-27)

View File

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

1036
bun.lock

File diff suppressed because it is too large Load Diff

View File

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

View File

@@ -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)

View File

@@ -0,0 +1,62 @@
---
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://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';
<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.
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.
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.
2. At the left should be a menu for various options, find 'Printer' at the very top
3. Click on the drop-down and select `--Create Printer --`
- 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'
- 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.
- 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.

View File

@@ -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

View File

@@ -0,0 +1,39 @@
---
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';
<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.
3. This opens a menu to select a file to upload.
4. Once the model is in the 3D view various options are available to arrange or make adjustments to.
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.
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.
7. Once ready and the representation in the printer view matches what is desired, click print to begin the process.
</Steps>