Merge pull request #128 from tetrabiodistributed/update-documentation…

…-for-makerfaire

Update documentation for makerfaire

build.sh

@@ -11,6 +11,15 @@ cp -R extras/pdf_shortcodes/static/js/pdf-js static/js/
 if [ ! -r ./node_modules ]; then
     podman run --rm --volume $PWD:/srv -w /srv docker.io/node npm ci
 fi
+
 if [ ! -r ./public ]; then
     podman run --rm --volume $PWD:/src -w /src docker.io/capsulecorplab/hugo-asciidoctor-plantuml:0.76.5-alpine 'hugo --minify -v --destination public'
 fi
+
+if [ ! -r ./content/assets ]; then
+    ln -srv assets content/assets
+fi
+
+if [ ! -r ./public/assets ]; then
+    cp -r assets public/assets
+fi

content/en/_index.adoc

@@ -8,7 +8,7 @@ description: >
 ---
 
 
-== Introduction
+== Introduction to PAPRa
 
 Many people are at risk for exposure to the COVID-19 virus and cannot afford to get infected.  These people can isolate themselves, but often, their professions or requirements for daily life will take them in contact with other people, and they need some form of protection.  Masks definitely help, but can become uncomfortable to wear, especially over long periods of time.  This guide will walk you through creating a Powered Air-Purifying Respirator, which will protect the wearer and those around them from airborne viruses and bacteria, while at the same time providing positive airflow to the wearer's face.  That airflow makes sure that the wearer has a supply of fresh, clean air that has gone through a filtration process, and, in our tests, is the equivalent of wearing an N95 mask.
 
@@ -18,8 +18,8 @@ The core of the idea is fairly simple: put a fan behind a filter in an airtight
 
 A completed build looks like:
 
-[link=https://photos.smugmug.com/Tetra-Testing/2022-Oct-10-Build/i-PMJVQSD/0/d77202a3/X5/_MMR5849-X5.jpg]
-image::https://photos.smugmug.com/Tetra-Testing/2022-Oct-10-Build/i-PMJVQSD/0/d77202a3/L/_MMR5849-L.jpg[]
+[link=https://photos.smugmug.com/Tetra-Testing/Attaching-via-MOLLE/i-ZzrzXwn/0/FZbSCJsZLZZJrsRRWQfdnxxnM59x4b4RC2mB8sPq6/XL/MMR00133-edited-XL.jpg]
+image::https://photos.smugmug.com/Tetra-Testing/Attaching-via-MOLLE/i-ZzrzXwn/0/FZbSCJsZLZZJrsRRWQfdnxxnM59x4b4RC2mB8sPq6/XL/MMR00133-edited-XL.jpg[]
 
 
 We have worn these PAPRas for multiple hours at a time and found them to be quite comfortable.  Please send us any images you have of wearing your Tetra PAPRa that you've built, and if you want, we'll post them on our website!

content/en/v1.0/_index.adoc → content/en/past-builds/jun-2022/_index.adoc

@@ -3,6 +3,7 @@
 title: "PAPRa Build Guide (June 2022 Edition)"
 linkTitle: "PAPRa Build Guide"
 weight: 1
+toc_hide: true
 description: >
   How to build the June 2022 version of the Tetra PAPR.
 aliases:

content/en/v1.0/m12-v1.adoc → content/en/past-builds/jun-2022/m12-v1.adoc

@@ -151,77 +151,77 @@ https://www.thespruce.com/tinning-stranded-electrical-wires-1152893
 
 Video describing the amount of wire to be tinned:
 
-video::https://photos.smugmug.com/photos/i-sTSdVhN/0/1920/i-sTSdVhN-1920.mp4[]
+video::https://photos.smugmug.com/photos/i-sTSdVhN/0/1920/i-sTSdVhN-1920.mp4[width=720]
 
 Photo showing tinning of the wires:
 
-image::https://photos.smugmug.com/photos/i-vGx3mbh/0/X2/i-vGx3mbh-O.jpg[]
+image::https://photos.smugmug.com/photos/i-vGx3mbh/0/X2/i-vGx3mbh-O.jpg[width=420]
 
 #### Crimp a red and black tinned wire each into the spade connectors
 How to crimp:
 
-video::https://photos.smugmug.com/photos/i-QjXdLPr/0/1920/i-QjXdLPr-1920.mp4[]
+video::https://photos.smugmug.com/photos/i-QjXdLPr/0/1920/i-QjXdLPr-1920.mp4[width=720]
 
 Here's a photo for bad crimping:
 
-image::https://photos.smugmug.com/photos/i-4B25qFs/0/X2/i-4B25qFs-X2.jpg[]
+image::https://photos.smugmug.com/photos/i-4B25qFs/0/X2/i-4B25qFs-X2.jpg[width=420]
 
 and the video explanation: 
 
-video::https://photos.smugmug.com/photos/i-2BHSLBL/0/1920/i-2BHSLBL-1920.mp4[]
+video::https://photos.smugmug.com/photos/i-2BHSLBL/0/1920/i-2BHSLBL-1920.mp4[width=720]
 
 #### Attach remaining red and black tinned wires to the power socket
 
 How to build the power socket with tinned wires:
 
-video::https://photos.smugmug.com/photos/i-fDvHdXv/0/1920/i-fDvHdXv-1920.mp4[]
+video::https://photos.smugmug.com/photos/i-fDvHdXv/0/1920/i-fDvHdXv-1920.mp4[width=720]
 
 #### Attach remaining red and black solid wires to the power socket
 
 How to build the power socket for the fan box with solid wires:
 
-video::https://photos.smugmug.com/photos/i-mfGN68v/0/1920/i-mfGN68v-1920.mp4[]
+video::https://photos.smugmug.com/photos/i-mfGN68v/0/1920/i-mfGN68v-1920.mp4[width=720]
 
 Final prepared wiring looks like:
 
-image::https://photos.smugmug.com/photos/i-jmpfcwg/0/X2/i-jmpfcwg-X2.jpg[]
+image::https://photos.smugmug.com/photos/i-jmpfcwg/0/X2/i-jmpfcwg-X2.jpg[width=420]
 
 ### M12 controller circuitry 
 
 #### Snip a portion of the spade connector
 A video describing this step:
 
-video::https://photos.smugmug.com/photos/i-bJ9DFfB/0/1920/i-bJ9DFfB-1920.mp4[]
+video::https://photos.smugmug.com/photos/i-bJ9DFfB/0/1920/i-bJ9DFfB-1920.mp4[width=720]
 
 #### Clean the M12 battery holder spade ports
 On the inside of the printed M12 box, there are two slots where the spade connector should fit in.  These slots may have some extra plastic around them due to print quality issues, so use an x-acto knife to clean those slots:
 
-video::https://photos.smugmug.com/photos/i-V6kxqFR/0/1920/i-V6kxqFR-1920.mp4[]
+video::https://photos.smugmug.com/photos/i-V6kxqFR/0/1920/i-V6kxqFR-1920.mp4[width=720]
 
 #### Insert the spade connectors into the M12 box
 These spade connectors should be inserted with red on the left, black on the right.  The snipped connector should slide in place and prevent the spade connector from coming back out again.
 
-video::https://photos.smugmug.com/photos/i-XgNPVmq/0/1920/i-XgNPVmq-1920.mp4[]
+video::https://photos.smugmug.com/photos/i-XgNPVmq/0/1920/i-XgNPVmq-1920.mp4[width=720]
 
 Tab to hold the spade connector in place:
 
-video::https://photos.smugmug.com/photos/i-gtfQpgx/0/1920/i-gtfQpgx-1920.mp4[]
+video::https://photos.smugmug.com/photos/i-gtfQpgx/0/1920/i-gtfQpgx-1920.mp4[width=720]
 
 Wire orientation: 
 
-video::https://photos.smugmug.com/photos/i-7LFMxCm/0/1920/i-7LFMxCm-1920.mp4[]
+video::https://photos.smugmug.com/photos/i-7LFMxCm/0/1920/i-7LFMxCm-1920.mp4[width=720]
 
 Test the spade connectors are in place:
 
-video::https://photos.smugmug.com/photos/i-dGMrbD7/0/1920/i-dGMrbD7-1920.mp4[]
-video::https://photos.smugmug.com/photos/i-mm5wPfK/0/1920/i-mm5wPfK-1920.mp4[]
+video::https://photos.smugmug.com/photos/i-dGMrbD7/0/1920/i-dGMrbD7-1920.mp4[width=720]
+video::https://photos.smugmug.com/photos/i-mm5wPfK/0/1920/i-mm5wPfK-1920.mp4[width=720]
 
 
 #### Install the board into the M12 box
 
 This video captures the entire process:
 
-video::https://photos.smugmug.com/photos/i-fHTTM3s/0/1920/i-fHTTM3s-1920.mp4[]
+video::https://photos.smugmug.com/photos/i-fHTTM3s/0/1920/i-fHTTM3s-1920.mp4[width=720]
 
 Essentially, these steps are followed:
 
@@ -235,11 +235,11 @@ Essentially, these steps are followed:
 
 You may need to deburr the edges of the hole: 
 
-image::https://photos.smugmug.com/photos/i-KNWz64M/0/X2/i-KNWz64M-O.jpg[]
+image::https://photos.smugmug.com/photos/i-KNWz64M/0/X2/i-KNWz64M-O.jpg[width=420]
 
 The final board:
 
-image::https://photos.smugmug.com/photos/i-kMLkq5k/0/X2/i-kMLkq5k-X2.jpg[]
+image::https://photos.smugmug.com/photos/i-kMLkq5k/0/X2/i-kMLkq5k-X2.jpg[width=420]
 
 Congratulations, you have completed the assembly of the power box for your PAPR!
 

content/en/testing-guide/N100_testing_March_2024.adoc

@@ -0,0 +1,39 @@
+---
+title: "PAPRa N100 Testing Guide (March 2024 Edition)"
+linkTitle: "PAPRa N100 Testing Guide (March 2024 Edition)"
+weight: 1
+description: >
+  How we tested the PAPRa to arrive at claims of N95/N99 levels of protection
+---
+
+:note-caption: :information_source:
+:warning-caption: :warning:
+
+== Quick Synopsis
+
+In April of 2024, we began testing PAPRa units with a Portacount.  This device enables the user to perform a fit test, and the unit designed for April 2024 passes above the 1000 grade needed for N100 (even though the user has a beard).
+
+
+[link=https://photos.smugmug.com/Tetra-Testing/N100-Testing/i-DJsvpT8/0/CnC5R6wTn8M6fnBCnSPQJrRjBTvtN5ffPMxcN3r58/M/PXL_20240311_000223904-X5.jpg]
+image::https://photos.smugmug.com/Tetra-Testing/N100-Testing/i-DJsvpT8/0/CnC5R6wTn8M6fnBCnSPQJrRjBTvtN5ffPMxcN3r58/M/PXL_20240311_000223904-L.jpg[] 
+
+One of the right angle connectors to the mask was replaced with a version with a tap to connect to a hose to sample inside the mask, shown here on the right side of the image.
+
+[link=https://photos.smugmug.com/Tetra-Testing/N100-Testing/i-BjhXKSr/0/C8JwXtJgH6BJMN3qQVCKk2s6SsmRDtXNhxQRdJRRh/X5/PXL_20240311_000228987-X5.jpg]
+image::https://photos.smugmug.com/Tetra-Testing/N100-Testing/i-BjhXKSr/0/CvGV8VfwwPcwW4BGmBSWZqMKCmxWgdVTmgK9nJ7Tj/L/PXL_20240311_000228987-L.jpg[] 
+
+We also tested a partially assembled version of the fan box using Honeywell N100 filters, that also passed as a device, but we did not perform a full fit test.
+
+[link=https://photos.smugmug.com/Tetra-Testing/N100-Testing/i-zt293Rp/0/D9TzgRV7f6LRnwDLdKc7hH7nvtBXRK6JjpZfGKhft/L/PXL_20240311_000538502-X5.jpg]
+image::https://photos.smugmug.com/Tetra-Testing/N100-Testing/i-zt293Rp/0/D9TzgRV7f6LRnwDLdKc7hH7nvtBXRK6JjpZfGKhft/L/PXL_20240311_000538502-L.jpg[] 
+
+Trying to use the same Honeywell box with the larger VOC filters may have cracked the box, and so those filters did not pass:
+
+[link=https://photos.smugmug.com/Tetra-Testing/N100-Testing/i-zt293Rp/0/D9TzgRV7f6LRnwDLdKc7hH7nvtBXRK6JjpZfGKhft/L/PXL_20240311_000538502-X5.jpg]
+image::https://photos.smugmug.com/Tetra-Testing/N100-Testing/i-zt293Rp/0/D9TzgRV7f6LRnwDLdKc7hH7nvtBXRK6JjpZfGKhft/L/PXL_20240311_000538502-L.jpg[] 
+
+We have stopped using pressure and flow tests, but instead simply rely on fit tests at this time.
+
+== WARNING
+
+Before you wear a PAPRa in any kind of potentially hazardous situation, it is critical that you test it to ensure that the unit is performing at an adequate level.  We have personally worn these units for many hours and tested these units to ensure an N99 level of performance, but we cannot guarantee that the units you make will perform at the same levels.  We provide no warranty, implicit or explicit, that any such units will provide protection.  Please make sure to test your units accordingly and to your own level of comfort and in compliance with whatever local regulations require.

content/en/v1.1/_index.adoc

@@ -0,0 +1,37 @@
+
+---
+title: "PAPRa Build Guide (April 2024 Edition)"
+linkTitle: "PAPRa Build Guide"
+weight: 1
+description: >
+  How to build the April 2024 version of the Tetra PAPR.
+aliases:
+  - /v1.1
+  - /1.1
+---
+
+== Quick Synopsis
+
+This guide will walk you through how to build a Powered Air Purifying Respirator, also known as a PAPR.  We assume that you have some knowledge of 3D-printing, and cutting foam with a knife or using a stencil or a cricut, and perhaps some soldering.  In the end, you will have four things: a box with a filter and a fan in it, a second box with batteries and a fan controller, a mask, and straps and hoses to hold it all together. 
+
+Please note that this system will not protect you from anything landing in your eyes.  For that protection, either the mask will need to be modified to be a helmet or you will need a face shield.
+
+*WARNING:* we provide no warranty, implicit or explicit, that this device will work up to an N95 specification, a P100 specification, or any other standard, when built outside of a facility rated to do so.  The only way to truly test one of these devices using something like a https://tsi.com/products/respirator-fit-testers/portacount-respirator-fit-tester-8038/[Portacount] under controlled conditions.
+
+Please refer to the link:testing-guide[Testing] section for the flow and fit testing done to verify PAPR functionality.
+
+== Parts needed
+
+The entire set of parts to build the PAPR is:
+
+
+image::https://photos.smugmug.com/Tetra-Testing/Makerfaire-2024-prep/i-7gHgdbp/0/CnwKx63gh5ph4jtLts36mSZ64z686WqJQXq5X4H4V/X3/DSCF0197-X3.jpg[]
+
+There are three components to build:
+
+1.  link:m12-controller[The M12 Controller]
+2.  link:fan-box[The Fan Box]
+3.  link:mask[The Mask]
+
+And the instructions to build all of these components can be found in the Tetra PAPRA Components section.
+