Initial commit

Contains all the requisite build code and the content used on the demo
wiki.

.github/dependabot.yml

@@ -0,0 +1,8 @@
+version: 2
+
+updates:
+  - package-ecosystem: github-actions
+    directory: "/"
+    schedule:
+      interval: "monthly"
+

.github/workflows/ci.yml

@@ -0,0 +1,56 @@
+---
+on: 
+  push:
+    branches:
+      - main
+  pull_request:
+
+jobs:
+  build_and_publish:
+    name: Build and Publish
+
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Download mdBook
+        run: |
+          set +x
+
+          version="v0.4.40"
+
+          cd /tmp
+          archive="mdbook-v0.4.40-x86_64-unknown-linux-gnu.tar.gz"
+          wget "https://github.com/rust-lang/mdBook/releases/download/v0.4.40/${archive}"
+          tar xzvf "${archive}"
+          sudo mv mdbook /usr/bin
+
+          mdbook --version
+
+      - name: Build
+        run: mdbook build
+
+      - name: Publish to Cloudflare Pages
+        id: publish
+        uses: cloudflare/wrangler-action@v3
+        with:
+          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          accountId: 03654dab23842c712e474f409d58f55c
+          command: pages deploy out --project-name=makerspace-wiki
+
+      - name: Add preview comment to Pull Request
+        if: github.event_name == 'pull_request'
+        uses: actions/github-script@v7
+        with:
+          script: |
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: '✨ you may preview these changes at <${{ steps.publish.outputs.deployment-url }}>'
+            })

.gitignore

@@ -0,0 +1 @@
+out

book.toml

@@ -0,0 +1,17 @@
+[book]
+title = "Maker Space Wiki"
+authors = ["Maker Space Members"]
+
+language = "en"
+multilingual = false
+
+src = "src"
+
+[build]
+build-dir = "out"
+create-missing = false
+
+[output.html]
+git-repository-url = "https://github.com/DanNixon/maker-space-wiki"
+edit-url-template = "https://github.com/DanNixon/maker-space-wiki/edit/main/{path}"
+fold.enable = true

src/SUMMARY.md

@@ -0,0 +1,16 @@
+# Summary
+
+[Introduction](./introduction.md)
+
+- [Equipment](./equipment/README.md)
+    - [Laser Cutter](./equipment/laser_cutter/README.md)
+    - [Bambu Lab P1S](./equipment/bambulab_p1s/README.md)
+        - [User Guide](./equipment/bambulab_p1s/user_guide.md)
+    - [Prusa MK3](./equipment/prusa_mk3/README.md)
+- [Governance](./governance/README.md)
+    - [Induction](./governance/induction/README.md)
+        - [Introduction](./governance/induction/introduction.md)
+        - [Using the space](./governance/induction/using_the_space.md)
+        - [Entrance Lobby](./governance/induction/entrance_lobby.md)
+        - [Main Workshop](./governance/induction/workshop.md)
+        - [Basement](./governance/induction/basement.md)

src/equipment/README.md

@@ -0,0 +1,13 @@
+# Equipment
+
+Here you will find an overview of the equipment available at Maker Space.
+
+This is a list of the significant items, there are a lot of smaller/hand tools that are around.
+
+|Item|Location|Induction Required|
+|--|--|--|
+|[Laser Cutter](./laser_cutter/)|Ground Floor, Coridoor|Yes|
+|[Bambu Lab P1S](./bambulab_p1s/)|Ground Floor, Main Space|No|
+|[Prusa MK3](./prusa_mk3/)|Ground Floor, Main Space|No|
+|Axminster Bandsaw|Basement, Tall Side|Yes|
+|Workbee CNC Router|Basement, Short Side|Yes, no, maybe|

src/equipment/bambulab_p1s/README.md

@@ -0,0 +1,20 @@
+# Bambu Lab P1S
+
+[Bambu Lab P1S](https://bambulab.com/en-gb/p1?product=p1s) with AMS and external spool caddy.
+A very good, quick FDM 3D printer.
+
+## Essential Information
+
+- Location: Ground Floor, Main Space
+- Responsible Person(s): Dan Nixon
+- Induction Required: No
+
+## Usage notes
+
+> **It is not permitted to leave this (or any other) 3D printer running whilst Maker Space is unoccupied!**
+
+While no induction is required, it is very strongly recommended to read the [user guide](./user_guide.md) before using the printer.
+
+## Useful links
+
+- [Bambu Lab wiki](https://wiki.bambulab.com/en/home)

src/equipment/bambulab_p1s/user_guide.md

@@ -0,0 +1,141 @@
+# Bambu Lab P1S user guide
+
+- [Bambu Studio setup](#bambu-studio-setup)
+  - [Install](#install)
+  - [Add printer](#add-printer)
+- [Loading, Unloading and Configuring Filament](#loading-unloading-and-configuring-filament)
+  - [Unloading](#unloading)
+  - [Loading](#loading)
+    - [Bambu Lab filament](#bambu-lab-filament)
+    - [Generic filament on card spools](#generic-filament-on-card-spools)
+    - [Generic filament](#generic-filament)
+- [Printing](#printing)
+  - [Preparing printer](#preparing-printer)
+  - [Preparing and starting job](#preparing-and-starting-job)
+  - [End of job](#end-of-job)
+- [SD card](#sd-card)
+
+## Bambu Studio setup
+
+### Install
+
+1. Install and launch [Bambu Suddio](https://bambulab.com/en/download/studio)
+2. Click "Get Started"  
+   ![Bambu Studio welcome page](./images/bambu_studio_welcome.png)
+3. Select "Europe"  
+   ![Bambu Studio region selection page](./images/bambu_studio_region.png)
+4. Select "Skip"  
+   ![Bambu Studio data hoover page](./images/bambu_studio_data_hoover.png)
+5. Select "Clear All"  
+   ![Bambu Studio printer selection page with default options](./images/bambu_studio_printer_selection_1.png)
+6. Check "Bambu Lab P1S 0.4mm nozzle" and click "Next"  
+   ![Bambu Studio printer selection page with correct printer selected](./images/bambu_studio_printer_selection_2.png)
+7. Customise the filament selection if needed, otherwise just click "Next"  
+   ![Bambu Studio filament selection page](./images/bambu_studio_filament_selection.png)
+8. Ensure "Install Bambu Network plug-in" is checked and click "Finish"  
+   ![Bambu Studio network plugin install page](./images/bambu_studio_network_plugin.png)
+
+### Add printer
+
+1. Switch to the "Devices" tab  
+   ![Bambu Studio devices tab with no printer added](./images/bambu_studio_empty_devices_tab.png)
+2. Click on "No printer" and select "3DP-01P-744" from the list
+3. When prompted enter the code from the printer menu as instructed  
+   ![Bambu Studio printer access code screen](./images/bambu_studio_access_code.png)
+4. The printer status should now be shown in the "Device" tab  
+   ![Bambu Studio devices tab printer added](./images/bambu_studio_devices_tab.png)
+
+If you do not see the printer in the device list then most likely your machine is not properly configured to act as an SSDP client.
+See [Simple Service Discovery Protocol](https://en.wikipedia.org/wiki/Simple_Service_Discovery_Protocol) and [Printer Network Ports](https://wiki.bambulab.com/en/general/printer-network-ports) for more info.
+TL;DR: open UDP port 2021 on your machines firewall and try again.
+
+When getting the access code from the printer do not select the refresh icon next to the code.
+
+## Loading, Unloading and Configuring Filament
+
+### Unloading
+
+1. Ensure the filament you wish to remove from the AMS is not currently loaded into the printer
+2. Pull the filament out of the AMS feeder and lift the spool out
+
+You can tell if a filament is loaded into the printer either by:
+
+- Observing the tube connecting the AMS to the printer, if you cannot see the filament in question inside the tube then it is *probably* unloaded
+- Checking the diagram on the "Device" tab in Bambu Studio, if the line leading from the spool position is thin and grey then the filament is unloaded
+
+### Loading
+
+#### Bambu Lab filament
+
+1. Place the spool in a free AMS slot
+2. Push the filament into the AMS feeder for the corresponding slot
+3. Wait 30 seconds or so for the filament to be identified
+4. Verify that the filament was correctly identified via the "Devices" tab in Bambu Studio
+
+#### Generic filament on card spools
+
+Filament on card spools should NOT be used directly in the AMS, the spool rollers chew up the card spools and make a mess of the AMS.
+
+A [shim](https://www.printables.com/model/251028-cardboard-spool-ring-for-bambu-lab-ams-parametric/) can be printed to protect the edges of the card spool.
+
+![Shims on a cardboard filament spool](./images/cardboard_spool_shims.jpg)
+
+Some cardboard spools, once clad with a printed shim, are too wide for the lid of the AMS to be closed without clamping the spool and preventing it from moving.
+In this case the clips on the AMS lid may be used to prop the lid slightly open as shown below.
+This should only be done when a filament is loaded into the AMS that would otherwise foul the AMS lid, prefer closing the lid when possible to take advantage of the humidity control offered by the AMS.
+
+![AMS propped open](./images/ams_propped_open.jpg)
+
+#### Generic filament
+
+1. Place the spool in a free AMS slot
+2. Push the filament into the AMS feeder for the corresponding slot
+3. In the "Device" tab of Bambu Studio, click the edit icon on the just loaded AMS slot (may show either an "?" or the settings for the last non RFID filament used in that slow)  
+   ![Bambu Studio AMS status showing unknown filament inserted](./images/ams_unknown.png)
+4. Edit the parameters and click "Confirm"  
+   ![Bambu Studio filament settings dialog](./images/ams_filament_settings.png)
+5. The "Devices" tab should now show the filament type you specified  
+   ![Bambu Studio AMS status showing configured filament](./images/ams_filament_configured.png)
+
+## Printing
+
+### Preparing printer
+
+1. Ensure there are no obstacles above or below the bed and that the build plate is correctly seated, located by the white tabs on the rear corners (highlighted in red squares in the photo below)  
+   ![Front of printer prior to a print](./images/printer_front_checks.jpg)
+2. If you need to change filaments in the AMS, do so now
+
+### Preparing and starting job
+
+1. Load designs into the "Prepare" tab of Bambu Studio  
+   ![Bambu Studio prepare tab](./images/print_prepare.png)
+2. Synchronise local filament settings with AMS by clicking the ![Bambu Studio AMS sync button](./images/ams_sync_filament.png) button on the filament settings panel, this will ensure your local filament settings reflect what is currently available on the printer
+3. Set machine, material and slicing settings in the left hand pane (yes the slicing profiles say "X1C", as far as I can tell this is fine)
+4. Click "Slice plate"
+5. You will see a preview in the "Preview" tab  
+   ![Bambu Studio preview tab](./images/print_sliced.png)
+6. If all is well, press "Print plate"
+7. Set options as desired, if you forgot to set the filament for your part you can override this here, disable timelapse if you have no intention of retrieving it, keep bed levelling and AMS enabled  
+   ![Bambu Studio job options](./images/print_options.png)
+8. Click "Send"
+9. Wait for the job to be uploaded  
+   ![Bambu Studio job uploading](./images/print_send.png)
+10. The "Device" page is automatically shown where you can monitor the jobs progress, adjust settings and temperatures if needed and pause or cancel the job
+11. It is worth checking that the purge filament has not ended up on the build plate, this should not happen but it is worth keeping an eye out for
+
+### End of job
+
+1. Remove build plate from printer
+2. Remove part from build plate
+3. Reseat build plate in printer
+4. Clean up any filament the printer has deposited (check the purge chute at the rear of the machine)
+
+## SD card
+
+The micro SD card is used for storing print jobs, timelapse and camera recordings (amongst other things that are of little direct use to humans).
+
+It is not advised to use the SD card as a means of getting print jobs onto the machine.
+
+Removing the SD card is how you would get timelapses and camera recordings off the printer, however if you wish to do this then immediately return the card to the printer as removal of the card renders it inoperative.
+
+Should the card be out of space, it can be safely formatted in the printer using the on screen menu.

src/equipment/laser_cutter/README.md

@@ -0,0 +1,14 @@
+# Laser Cutter
+
+A laser cutter.
+It cuts stuff using a laser.
+
+## Essential Information
+
+- Location: Ground Floor, Corridor
+- Responsible Person(s): Dan Nixon
+- Induction Required: Yes
+
+## Usage notes
+
+> **It is not permitted under any circumstances to leave this machine running unattended!**

src/equipment/prusa_mk3/README.md

@@ -0,0 +1,25 @@
+# Prusa MK3
+
+A sort of OK FDM 3D printer.
+
+## Essential Information
+
+- Location: Ground Floor, Main Space
+- Responsible Person(s): ?
+- Induction Required: No
+
+## Usage notes
+
+> **It is not permitted to leave this (or any other) 3D printer running whilst Maker Space is unoccupied!**
+
+This printer is fitted with a standard 0.4mm nozzle.
+
+Octoprint is installed on a Raspberry Pi, which is capable of controlling and monitoring the printer over the network.
+The IP address to access the Octoprint interface is on a label on the front of the printer.
+
+If you'd rather print from the SD card, you might find it useful to create a folder with your name for your files.
+Please remove any big files once you're done with them to save clogging the card up (same goes for Octoprint).
+
+[PrusaSlicer](https://github.com/prusa3d/PrusaSlicer/releases) is generally the most straightforward way of slicing your files for printing, as it has a pre-made and tuned profile for the MK3.
+
+If you don't know how to use a 3D printer, or if you're unsure of how to use the specific one in the space, please do ask someone before attempting to.

src/governance/README.md

@@ -0,0 +1,3 @@
+# Governance
+
+This section describes how Maker Space operates.

src/governance/induction/README.md

@@ -0,0 +1,9 @@
+# MS4 Induction checklist
+
+This is a checklist of the things that a person who is inducting a new member to Maker Space should cover during their initial induction tour.
+
+- [Introduction](./introduction.md)
+- [Using the space](./using_the_space.md)
+- [Entrance Lobby](./entrance_lobby.md)
+- [Main Workshop](./workshop.md)
+- [Basement](./basement.md)

src/governance/induction/basement.md

@@ -0,0 +1,28 @@
+# Basement
+
+
+## There are PPE boards - please use them.
+- We have provided it, it's your job to use it. It's OK to remind people you see not using it when they should be.
+- Dust masks are available from the "Spare PPE" box.
+- If you know you're going to need specific PPE for a certain task ahead of time (respirator, coveralls), consider bringing it yourself. 
+- Hearing protection - if you are making lots of loud noise make sure you and others near you wear it.
+- If you are making flying objects, ensure people who may be affected know and are offered eye protection.
+
+
+## Clean up after yourself
+- Tools / Bench top / Floor
+
+
+## Tools
+- Sander / Pillar Drill / Lathe / Mill / Band Saw / Workbee CNC
+    - RFID Controlled. Induction Required, ask on the members list or email the maintainer to get inducted.
+- Hand tools generally around the space on boards.
+- Drills, hand power tools, Dremel and bits/collets near the Workbee CNC machine. 
+- Return tools when you have finished with them, definitely before leaving space.
+
+
+## Storage
+- Wood Store - Help yourself - Add more wood/offcuts when finished own projects. Please check for "Do Not Hack" stickers before using.
+- Nuts/Bolts/Screws - please keep tidy - use "M Don't Know" if you can't determine the size. 
+- Metal Store - to be used for projects etc.  Be careful of sharp edges, don't leave any for others.
+- Table legs may not be spare.  Please check before using.

src/governance/induction/entrance_lobby.md

@@ -0,0 +1,14 @@
+# Entrance Lobby
+
+## Hack or Die
+
+- Items on the shelves are for hacking and remaining items are periodically disposed of.
+- Please only add items you realistically think will be used by someone.
+- Please don't bring things in just for Hack or Die.  Do that virtually (by email) instead.
+
+## Laser Cutter
+
+- Induction required - Ask on the members list.
+- Scrap material available for use.
+
+## Toilets